Skip to content

Commit ecf23ff

Browse files
committed
Remove outdated IDE, JIRA and Tomcat references
Issue: SPR-7521 (cherry picked from commit f1f1c4c)
1 parent 4129f00 commit ecf23ff

File tree

1 file changed

+2
-63
lines changed

1 file changed

+2
-63
lines changed

src/asciidoc/index.adoc

Lines changed: 2 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -815,11 +815,6 @@ Spring remains compatible with older versions of Java and the JDK: concretely, J
815815
and above are still fully supported. However, for newly started development projects
816816
based on Spring 4, we recommend the use of Java 7 or 8.
817817

818-
Note that the Java 8 bytecode level (`-target 1.8`, as required by `-source 1.8`) is only
819-
fully supported as of Spring Framework 4.0. In particular, Spring 3.2 based applications
820-
need to be compiled with a maximum of Java 7 as the target, even if they happen to be
821-
deployed onto a Java 8 runtime. Please upgrade to Spring 4 for Java 8 based applications.
822-
823818

824819

825820

@@ -15678,7 +15673,7 @@ above and can be registered individually for __each__ web application as follows
1567815673
</Context>
1567915674
----
1568015675

15681-
Apache Tomcat 6.0.x (similar to 5.0.x/5.5.x) series supports several context locations:
15676+
Apache Tomcat (6.0+) supports several context locations:
1568215677

1568315678
* server configuration file - __$CATALINA_HOME/conf/server.xml__
1568415679
* default context configuration - __$CATALINA_HOME/conf/context.xml__ - that affects all
@@ -15693,64 +15688,14 @@ changes to the server configuration. See the Tomcat 6.0.x
1569315688
http://tomcat.apache.org/tomcat-6.0-doc/config/context.html[documentation] for more
1569415689
details about available context locations.
1569515690

15696-
* Tomcat 5.0.x/5.5.x
15697-
* Copy `org.springframework.instrument.tomcat.jar` into __$CATALINA_HOME__/server/lib,
15698-
where __$CATALINA_HOME__ represents the root of the Tomcat installation.
15699-
* Instruct Tomcat to use the custom class loader instead of the default one by editing
15700-
the web application context file:
15701-
15702-
[source,xml,indent=0]
15703-
[subs="verbatim,quotes"]
15704-
----
15705-
<Context path="/myWebApp" docBase="/my/webApp/location">
15706-
<Loader
15707-
loaderClass="org.springframework.instrument.classloading.tomcat.TomcatInstrumentableClassLoader"/>
15708-
</Context>
15709-
----
15710-
15711-
Tomcat 5.0.x and 5.5.x series supports several context locations:
15712-
15713-
* server configuration file - __$CATALINA_HOME/conf/server.xml__
15714-
* default context configuration - __$CATALINA_HOME/conf/context.xml__ - that affects all
15715-
deployed web applications
15716-
* per-web application configuration which can be deployed either on the server-side at
15717-
__$CATALINA_HOME/conf/[enginename]/[hostname]/[webapp]-context.xml__ or embedded
15718-
inside the web-app archive at __META-INF/context.xml__
15719-
15720-
For efficiency, the embedded web-app configuration style is recommended recommended
15721-
because it will impact only applications that use the class loader. See the Tomcat 5.x
15722-
http://tomcat.apache.org/tomcat-5.5-doc/config/context.html[documentation] for more
15723-
details about available context locations.
15724-
15725-
Tomcat versions prior to 5.5.20 contained a bug in the XML configuration parsing that
15726-
prevented usage of the `Loader` tag inside __server.xml__ configuration, regardless of
15727-
whether a class loader is specified or whether it is the official or a custom one. See
15728-
Tomcat's bugzilla for http://issues.apache.org/bugzilla/show_bug.cgi?id=39704[more
15729-
details].
15730-
15731-
In Tomcat 5.5.x, versions 5.5.20 or later, you should set
15732-
__useSystemClassLoaderAsParent__ to `false` to fix this problem:
15733-
15734-
[source,xml,indent=0]
15735-
[subs="verbatim,quotes"]
15736-
----
15737-
<Context path="/myWebApp" docBase="/my/webApp/location">
15738-
<Loader
15739-
loaderClass="org.springframework.instrument.classloading.tomcat.TomcatInstrumentableClassLoader"
15740-
**useSystemClassLoaderAsParent="false"**/>
15741-
</Context>
15742-
----
15743-
15744-
This setting is not needed on Tomcat 6 or higher.
15745-
1574615691
Alternatively, consider the use of the Spring-provided generic VM agent, to be specified
1574715692
in Tomcat's launch script (see above). This will make instrumentation available to all
1574815693
deployed web applications, no matter what ClassLoader they happen to run on.
1574915694

1575015695
[[aop-aj-ltw-environments-weblogic-oc4j-resin-glassfish-jboss]]
1575115696
====== WebLogic, WebSphere, Resin, GlassFish, JBoss
1575215697
Recent versions of WebLogic Server (version 10 and above), IBM WebSphere Application
15753-
Server (version 7 and above), Resin (3.1 and above) and JBoss (5.x or above) provide a
15698+
Server (version 7 and above), Resin (3.1 and above) and JBoss (6.x or above) provide a
1575415699
ClassLoader that is capable of local instrumentation. Spring's native LTW leverages such
1575515700
ClassLoaders to enable AspectJ weaving. You can enable LTW by simply activating
1575615701
load-time weaving as described earlier. Specifically, you do __not__ need to modify the
@@ -45130,12 +45075,6 @@ The supported languages were chosen because __a)__ the languages have a lot of t
4513045075
the Java enterprise community, __b)__ no requests were made for other languages at the time
4513145076
that this support was added, and __c)__ the Spring developers were most familiar with
4513245077
them.
45133-
45134-
There is nothing stopping the inclusion of further languages though. If you want to see
45135-
support for <__insert your favorite dynamic language here__>, you can always raise an
45136-
issue on Spring's
45137-
http://opensource.atlassian.com/projects/spring/secure/Dashboard.jspa[JIRA] page (or
45138-
implement such support yourself).
4513945078
****
4514045079

4514145080
Fully working examples of where this dynamic language support can be immediately useful

0 commit comments

Comments
 (0)