Skip to content

Commit 7a1c4d2

Browse files
author
Costin Leau
committed
SPR-6469
+ renamed spring-agent.jar to org.springframework.instrument.jar through-out the documentation.
1 parent b7e37dd commit 7a1c4d2

File tree

1 file changed

+14
-9
lines changed
  • spring-framework-reference/src

1 file changed

+14
-9
lines changed

spring-framework-reference/src/aop.xml

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3114,8 +3114,9 @@ public class Account {
31143114
environments</link>, this support enables load-time weaving
31153115
<emphasis>without making any modifications to the application server's
31163116
launch script</emphasis> that will be needed to add
3117-
-javaagent:path/to/aspectjweaver.jar or (as we describe later in this
3118-
section) -javaagent:path/to/spring-agent.jar. Developers simply modify
3117+
<literal>-javaagent:path/to/aspectjweaver.jar</literal> or (as we describe later in this
3118+
section) <literal>-javaagent:path/to/org.springframework.instrument.jar</literal> (previously named
3119+
<literal>spring-agent.jar</literal>). Developers simply modify
31193120
one or more files that form the application context to enable load-time
31203121
weaving instead of relying on administrators who typically are in charge
31213122
of the deployment configuration such as the launch script.</para>
@@ -3257,15 +3258,16 @@ public final class Main {
32573258
(supplied with Spring) to switch on the LTW. This is the command line
32583259
we will use to run the above <classname>Main</classname> class:</para>
32593260

3260-
<programlisting>java -javaagent:C:/projects/foo/lib/global/spring-agent.jar foo.Main</programlisting>
3261+
<programlisting>java -javaagent:C:/projects/foo/lib/global/org.springframework.instrument.jar foo.Main</programlisting>
32613262

32623263
<para>The '<literal>-javaagent</literal>' is a Java 5+ flag for
32633264
specifying and enabling <ulink
32643265
url="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/instrument/package-summary.html">agents
32653266
to instrument programs running on the JVM</ulink>. The Spring
32663267
Framework ships with such an agent, the
32673268
<classname>InstrumentationSavingAgent</classname>, which is packaged
3268-
in the <filename class="libraryfile">spring-agent.jar</filename> that
3269+
in the <filename class="libraryfile">org.springframework.instrument.jar</filename> (previously
3270+
named <filename class="libraryfile">spring-agent.jar</filename>) that
32693271
was supplied as the value of the <literal>-javaagent</literal>
32703272
argument in the above example.</para>
32713273

@@ -3388,7 +3390,8 @@ public final class Main {
33883390
<orderedlist>
33893391
<listitem>
33903392
<para><filename
3391-
class="libraryfile">spring-agent.jar</filename></para>
3393+
class="libraryfile">org.springframework.instrument.jar</filename> (previously named
3394+
<filename class="libraryfile">spring-agent.jar</filename>)</para>
33923395
</listitem>
33933396
</orderedlist>
33943397
</section>
@@ -3506,7 +3509,7 @@ http://www.springframework.org/schema/context
35063509
<entry><para>JVM started with Spring
35073510
<classname>InstrumentationSavingAgent</classname></para>
35083511
<para><emphasis><literal>(java
3509-
-javaagent:path/to/spring-agent.jar)</literal></emphasis></para></entry>
3512+
-javaagent:path/to/org.springframework.instrument.jar)</literal></emphasis></para></entry>
35103513
<entry><para><classname>InstrumentationLoadTimeWeaver</classname></para></entry>
35113514
</row>
35123515

@@ -3620,7 +3623,8 @@ http://www.springframework.org/schema/context
36203623
(standalone as well as application server based) through the use of
36213624
the Spring-provided instrumentation agent. To do so, start
36223625
the VM by by specifying the
3623-
<literal>-javaagent:path/to/spring-agent.jar</literal> option.
3626+
<literal>-javaagent:path/to/org.springframework.instrument.jar</literal> option
3627+
(the jar was previously named <literal>spring-agent.jar</literal>).
36243628
Note that this requires modification of the VM launch script
36253629
which may prevent you from using this in application server
36263630
environments (depending on your operation policies).</para>
@@ -3635,7 +3639,8 @@ http://www.springframework.org/schema/context
36353639
looks as follows, to be included either in Tomcat's central
36363640
<literal>server.xml</literal> file or in an application-specific
36373641
<literal>META-INF/context.xml</literal> file within the WAR root.
3638-
Spring's <literal>spring-tomcat-weaver.jar</literal> needs to be
3642+
Spring's <literal>org.springframework.instrument.tomcat.jar</literal>
3643+
(previously named <literal>spring-tomcat-weaver.jar</literal>) needs to be
36393644
included in Tomcat's common lib directory in order to make this
36403645
setup work.</para>
36413646

@@ -3672,7 +3677,7 @@ http://www.springframework.org/schema/context
36723677
You can enable LTW by simply activating <literal>context:load-time-weaver</literal>
36733678
as described earlier. Specifically, you do <emphasis>not</emphasis>
36743679
need to modify the launch script to add
3675-
<literal>-javaagent:path/to/spring-agent.jar</literal>.</para>
3680+
<literal>-javaagent:path/to/org.springframework.instrument.jar</literal>.</para>
36763681

36773682
<para>GlassFish provides an instrumentation-capable ClassLoader as well,
36783683
but only in its EAR environment. For GlassFish web applications,

0 commit comments

Comments
 (0)