blob: d302d09afb9e25aae3bc90234b1ee82b3aa2a37f [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<meta name="Date-Revision-yyyymmdd" content="20140918"/>
<meta http-equiv="Content-Language" content="en"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>WebLogic 6.1</title>
<link href="//fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,400italic,600italic,700italic" rel="stylesheet" type="text/css">
<link href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css" rel="stylesheet">
<link href="/css/main.css" rel="stylesheet">
<link href="/css/custom.css" rel="stylesheet">
<link href="/highlighter/github-theme.css" rel="stylesheet">
<script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="/bootstrap/js/bootstrap.js"></script>
<script type="text/javascript" src="/js/community.js"></script>
</head>
<body>
<a href="http://github.com/apache/struts" class="github-ribbon">
<img style="position: absolute; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png" alt="Fork me on GitHub">
</a>
<header>
<nav>
<div role="navigation" class="navbar navbar-default navbar-fixed-top">
<div class="container">
<div class="navbar-header">
<button type="button" data-toggle="collapse" data-target="#struts-menu" class="navbar-toggle">
Menu
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a href="/index.html" class="navbar-brand logo"><img src="/img/struts-logo.svg"></a>
</div>
<div id="struts-menu" class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="dropdown">
<a data-toggle="dropdown" href="#" class="dropdown-toggle">
Home<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<li><a href="/index.html">Welcome</a></li>
<li><a href="/download.cgi">Download</a></li>
<li><a href="/releases.html">Releases</a></li>
<li><a href="/announce-2021.html">Announcements</a></li>
<li><a href="http://www.apache.org/licenses/">License</a></li>
<li><a href="https://www.apache.org/foundation/thanks.html">Thanks!</a></li>
<li><a href="https://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
</ul>
</li>
<li class="dropdown">
<a data-toggle="dropdown" href="#" class="dropdown-toggle">
Support<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<li><a href="/mail.html">User Mailing List</a></li>
<li><a href="https://issues.apache.org/jira/browse/WW">Issue Tracker</a></li>
<li><a href="/security.html">Reporting Security Issues</a></li>
<li class="divider"></li>
<li><a href="https://cwiki.apache.org/confluence/display/WW/Migration+Guide">Version Notes</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/WW/Security+Bulletins">Security Bulletins</a></li>
<li class="divider"></li>
<li><a href="/maven/project-info.html">Maven Project Info</a></li>
<li><a href="/maven/struts2-core/dependencies.html">Struts Core Dependencies</a></li>
<li><a href="/maven/struts2-plugins/modules.html">Plugin Dependencies</a></li>
</ul>
</li>
<li class="dropdown">
<a data-toggle="dropdown" href="#" class="dropdown-toggle">
Documentation<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<li><a href="/birdseye.html">Birds Eye</a></li>
<li><a href="/primer.html">Key Technologies</a></li>
<li><a href="/kickstart.html">Kickstart FAQ</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/WW/Home">Wiki</a></li>
<li class="divider"></li>
<li><a href="/getting-started/">Getting Started</a></li>
<li><a href="/security/">Security Guide</a></li>
<li><a href="/core-developers/">Core Developers Guide</a></li>
<li><a href="/tag-developers/">Tag Developers Guide</a></li>
<li><a href="/maven-archetypes/">Maven Archetypes</a></li>
<li><a href="/plugins/">Plugins</a></li>
<li><a href="/maven/struts2-core/apidocs/index.html">Struts Core API</a></li>
<li><a href="/tag-developers/tag-reference.html">Tag reference</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/WW/FAQs">FAQs</a></li>
<li><a href="http://cwiki.apache.org/S2PLUGINS/home.html">Plugin registry</a></li>
</ul>
</li>
<li class="dropdown">
<a data-toggle="dropdown" href="#" class="dropdown-toggle">
Contributing<b class="caret"></b>
</a>
<ul class="dropdown-menu">
<li><a href="/youatstruts.html">You at Struts</a></li>
<li><a href="/helping.html">How to Help FAQ</a></li>
<li><a href="/dev-mail.html">Development Lists</a></li>
<li><a href="/contributors/">Contributors Guide</a></li>
<li class="divider"></li>
<li><a href="/submitting-patches.html">Submitting patches</a></li>
<li><a href="/builds.html">Source Code and Builds</a></li>
<li><a href="/coding-standards.html">Coding standards</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/WW/Contributors+Guide">Contributors Guide</a></li>
<li class="divider"></li>
<li><a href="/release-guidelines.html">Release Guidelines</a></li>
<li><a href="/bylaws.html">PMC Charter</a></li>
<li><a href="/volunteers.html">Volunteers</a></li>
<li><a href="https://gitbox.apache.org/repos/asf?p=struts.git">Source Repository</a></li>
<li><a href="/updating-website.html">Updating the website</a></li>
</ul>
</li>
<li class="apache"><a href="http://www.apache.org/"><img src="/img/apache.png"></a></li>
</ul>
</div>
</div>
</div>
</nav>
</header>
<article class="container">
<section class="col-md-12">
<a href="index.html" title="back to Core Developers Guide"><< back to Core Developers Guide</a>
<a class="edit-on-gh" href="https://github.com/apache/struts-site/edit/master/source/core-developers/weblogic-6-1.md" title="Edit this page on GitHub">Edit on GitHub</a>
<h1 id="weblogic-61">WebLogic 6.1</h1>
<h2 id="running-on-weblogic-server-61">Running on Weblogic Server 6.1</h2>
<p>This document describes why the framework doesn’t work “as-is” on Weblogic Server 6.1 and shows how to build an additional JAR that will fix the problems.</p>
<p>(information) The service pack SP4 of Weblogic Server 6.1 was used to test these notes.</p>
<p>The first part of this document describes the technical problems and the theoretical solution.</p>
<h3 id="why-it-doesnt-just-work">Why It Doesn’t Just Work</h3>
<p>Weblogic 6.1 was published just prior to the finalization of the Servlet 2.3 specification. The incompatibility is that servlet filters and listeners in Weblogic 6.1 do not work with the 2.3 spec primarily because the servlet context is not retrieved in the same way. This causes virtually all filter initialization operations to fail with an AbstractMethodError exception.</p>
<h3 id="how-the-framework-is-modified">How the Framework is Modified</h3>
<p>In Servlet 2.3, the servlet context is available from the session object; this is not true for Weblogic Server 6.1. Hence, filters and listeners must be modified to retrieve the servlet context from a different source; this is accomplished by retrieving the servlet context from the FilterConfig passed to the servlet filters during initialzation.</p>
<p>However, the framework code cannot be modifed to do this, because this will break the Servlet 2.3 specification. The goal is to leave the “original” framework unmodified so that it is still Servlet 2.3 compatible, and then to add an additional JAR that “breaks” the frame to work on Weblogic Server 6.1.</p>
<p>The framework has already been modified slightly to make the above effort possible:</p>
<ol>
<li>
<p><strong>RequestLifecycleFilter</strong> is modified to retrieve its servlet context from the method <code class="highlighter-rouge">getServletContext</code>. This method, <code class="highlighter-rouge">getServletContext</code>, is then implemented to return the servlet context from where it is available in Servlet 2.3: the session object. The logical operation is unchanged, but now subclasses can override <code class="highlighter-rouge">getServletContext</code> to retrieve the servlet context from a different location as we’ll see below.</p>
</li>
<li>
<p><strong>SessionLifecycleListener</strong> is modified in the same way as RequestLifecycleFilter. The method, <code class="highlighter-rouge">getServletContext</code>, is implemented to return the servlet context, in this case also from the session object. Again, subclasses can override the <code class="highlighter-rouge">getServletContext</code> method to restore the servlet context from a different source. Again, this class’s functionality is unchanged.</p>
</li>
</ol>
<p>Now, in a separate project, the following classes are added and compiled into a separate JAR:</p>
<p><strong>RequestLifecycleFilterCompatWeblogic61</strong></p>
<p>This subclass of RequestLifecycleFilter simply overrides getServletContext() to retrieve the servlet context from the filter config, creates a singleton class, SessionContextSingleton, and assigns the servlet context to the singleton so that the listeners will have the ability to retrieve it.</p>
<p><strong>SessionLifecycleListenerCompatWeblogic61</strong></p>
<p>This subclass of SessionLifecycleListener simply overrides getServletContext() to retrieve the servlet context from the singleton created above.</p>
<p><strong>FilterDispatcherCompatWeblogic61</strong></p>
<p>Although the superclass of this class, FilterDispatcher, is commented out, this subclass retrieves the servlet context in the same way as RequestLifecycleFilterCompatWeblogic61 in case it is ever resurrected. At this time, this class is unnecessary.</p>
<p><strong>ServletContextSingleton</strong></p>
<p>A singleton class whose sole purpose is to hold the servlet context so that listener classes have access to it.</p>
<h3 id="setting-up-to-run-on-weblogic-61">Setting Up to Run on Weblogic 6.1</h3>
<p><strong>Building your own project</strong></p>
<p>In the {{web.xml} file, make the following class name substitutions:</p>
<table>
<thead>
<tr>
<th>Old Class Name</th>
<th>New Class Name</th>
</tr>
</thead>
<tbody>
<tr>
<td>RequestLifecycleFilter</td>
<td>RequestLifecycleFilterCompatWeblogic61</td>
</tr>
<tr>
<td>SessionLifecycleListener</td>
<td>SessionLifecycleListenerCompatWeblogic61</td>
</tr>
<tr>
<td>FilterDispatcher</td>
<td>FilterDispatcherCompatWeblogic61</td>
</tr>
</tbody>
</table>
<h3 id="faq">FAQ</h3>
<p><strong>I still get the AbstractMethodError Exception when Weblogic Server starts up. What am I doing wrong?</strong></p>
<ol>
<li>
<p>Check to see if a <code class="highlighter-rouge">action2-example.war</code> is still lingering in your <code class="highlighter-rouge">mydomain/applications</code> folder and delete it if it is there.</p>
</li>
<li>
<p>See next FAQ question.</p>
</li>
</ol>
<p><strong>The server behavior seems like it is from a previous source code base; I can’t debug it. What’s the clue?</strong></p>
<p>Sometimes BEA Weblogic Server doesn’t “rebuild” its temporary files. Do the following to force the temporary files to rebuild:</p>
<ol>
<li>
<p>Stop the server.</p>
</li>
<li>
<p>Delete the .wlnotdelete folder in <code class="highlighter-rouge">mydomain/applications</code>.</p>
</li>
<li>
<p>Restart the server.</p>
</li>
</ol>
</section>
</article>
<footer class="container">
<div class="col-md-12">
Copyright &copy; 2000-2018 <a href="http://www.apache.org/">The Apache Software Foundation </a>.
All Rights Reserved.
</div>
<div class="col-md-12">
Apache Struts, Struts, Apache, the Apache feather logo, and the Apache Struts project logos are
trademarks of The Apache Software Foundation.
</div>
<div class="col-md-12">Logo and website design donated by <a href="https://softwaremill.com/">SoftwareMill</a>.</div>
</footer>
<script>!function (d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (!d.getElementById(id)) {
js = d.createElement(s);
js.id = id;
js.src = "//platform.twitter.com/widgets.js";
fjs.parentNode.insertBefore(js, fjs);
}
}(document, "script", "twitter-wjs");</script>
<script src="https://apis.google.com/js/platform.js" async="async" defer="defer"></script>
<div id="fb-root"></div>
<script>(function (d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) return;
js = d.createElement(s);
js.id = id;
js.src = "//connect.facebook.net/en_GB/all.js#xfbml=1";
fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>
</body>
</html>