新增功能：在启动参数中不再需要配置java参数-xbootclasspath

[xwshiustc]

根据本人使用经验

• 配置-xbootclasspath在各个容器中需要配置额外的参数，调研起来会很麻烦
• 在JBoss 6.2以上版本中，如果使用了-xbootclasspath，需要配置额外的启动参数java -Dxxxxx=xxxxxxxx参数等等才可以真正起作用，每种容器的实现都不一样相当棘手，甚至JBoss6.2和其以下的其他版本参数也不同，

未来我将努力贡献一部分代码争取不再配置需要配置-xbootclasspath。

[oldratlee]

@xwshiustc 能否说明一下： JBoss设置-xbootclasspath 且生效，需要的哪些具体操作 及相关的资料？

原因：

• 其它同学可以按你的步骤 解决 当下的问题，省去你已经做的调研的时间。
• 即使 这个功能（无需设置-xbootclasspath）实现后，设置-xbootclasspath也是一条路子，可以根据实际的场景需求来选用。

[xwshiustc]

目前我只有用过JBoss 6和tomcat 6

JBoss

在JBoss 6.x的大部分版本中 配置方式为：

-javaagent:/opt/xxxxxx/transmittable-thread-local-2.x.x.jar
-Djboss.modules.system.pkgs=org.jboss.byteman,org.jboss.logmanager,com.alibaba.ttl,
-Djava.util.logging.manager=org.jboss.logmanager.LogManager
-Xbootclasspath/p:/opt/xxxxxx/transmittable-thread-local-2.x.x.jar

• -Djboss.modules.system.pkgs 是所有的加入 xbootclasspath下面的类的包名都需要配置。 jboss自带的两个包也需要配置, 但是如果不引入任何第三方的jar进入jboss xbootclasspath，则都不需要配置
• 第二行，在引入第三方jar加入xbootclasspath以后也需要配置，否则会报LogManager ClassNotFound

tomcat

tomcat 6开发环境中使用很简单，不需要配置任何其他参数。

只要 -javaagent:/opt/xxxxxx/transmittable-thread-local-2.x.x.jar 即可

其他容器未知

[oldratlee]

Some related reources

• Apache Tomcat - Class Loader HOW-TO
  • https://tomcat.apache.org/tomcat-8.0-doc/class-loader-howto.html
  • https://tomcat.apache.org/tomcat-7.0-doc/class-loader-howto.html
  • https://tomcat.apache.org/tomcat-6.0-doc/class-loader-howto.html

[baifan]

建议不要使用MANIFEST.MF中的Boot-Class-Path代替-Xbootclasspath/a，否则修改了ttl的jar包名称，仍然需要指定参数-Xbootclasspath/a。

附上Boot-Class-Path的说明：

A list of paths to be searched by the bootstrap class loader. Paths represent directories or libraries (commonly referred to as JAR or zip libraries on many platforms). These paths are searched by the bootstrap class loader after the platform specific mechanisms of locating a class have failed. Paths are searched in the order listed. Paths in the list are separated by one or more spaces. A path takes the syntax of the path component of a hierarchical URI. The path is absolute if it begins with a slash character ('/'), otherwise it is relative. A relative path is resolved against the absolute path of the agent JAR file. Malformed and non-existent paths are ignored. When an agent is started sometime after the VM has started then paths that do not represent a JAR file are ignored. This attribute is optional.

[oldratlee]

@baifan

1. 通过Boot-Class-Path 简化 -Xbootclasspath的配置是Agent的最佳实践。
2. 多数情况下，大家是不会修改下载的Jar文件名。
3. 如果真修改了文件名，仍然可以用-Xbootclasspath的配置，就像之前的版本一样。

---

另外，你提的注意点在文档中已经加上明确说明了 ❤️ 👍

关于boot class path设置 - README：