我最近在尝试在 Weblogic 9.2 上部署 JAX-WS Web 服务客户端时遇到了很多问题。事实证明,没有关于如何实现这一点的简单指南,所以我决定整理这个简短的 wiki 条目,希望它可能对其他人有用。
首先,Weblogic 9.2 通常不支持使用 JAX-WS 的 Web 服务。它带有与最新 JAX-WS 不兼容的 XML 相关 Java 库的旧版本(Axis2 也会出现类似问题,只有 Axis1 似乎与 Weblogic 9.x 完美配合,但这是一个非常古老且不受支持的库)。
因此,为了使其正常工作,需要进行一些黑客攻击。我就是这样做的(请注意,我们在遗留企业项目中使用 ant,您可能应该使用 maven,它应该消除以下 50% 的步骤):
1.从https://jax-ws.dev.java.net/下载最新的JAX-WS发行版(我得到的确切版本是JAXWS2.2-20091203.zip)
2.将具有依赖项的 JAX-WS jar 放在单独的文件夹中,例如lib/webservices。
3.在ant中创建一个模式集来引用这些jar:
<?xml version="1.0"?>
<patternset id="jaxws.classpath">
<include name="webservices/jsr173_api.jar" />
<include name="webservices/jsr181-api.jar" />
<include name="webservices/jaxb-api.jar" />
<include name="webservices/jaxb-impl.jar" />
<include name="webservices/jaxb-xjc.jar" />
<include name="webservices/jaxws-tools.jar" />
<include name="webservices/jaxws-rt.jar" />
<include name="webservices/jaxws-api.jar" />
<include name="webservices/policy.jar" />
<include name="webservices/woodstox.jar" />
<include name="webservices/streambuffer.jar" />
<include name="webservices/stax-ex.jar" />
<include name="webservices/saaj-api.jar" />
<include name="webservices/saaj-impl.jar" />
<include name="webservices/gmbal-api-only.jar" />
</patternset>
4.将模式集包含在您的 WAR 相关目标中。这可能看起来像:
<?xml version="1.0"?>
<copy todir="${wardir.lib}" includeEmptyDirs="false" flatten="true">
<fileset dir="${libs}">
<!--lots of libs here, related to your project -->
<patternset refid="jaxws.classpath"/>
</fileset>
</copy>
(不是flatten="true"参数 - 这很重要,因为默认情况下 Weblogic 9.x 不够聪明,无法访问位于 WAR 文件中的 WEB-INF/lib 不同的 lcoation 中的 jars)
5.万一发生冲突,Weblogic默认使用自己的jar。我们希望它使用我们应用程序中的 JAX-WS jar。这是通过准备weblogic-application.xml文件并将其放置在已部署的 EAR 文件的 META-INF 文件夹中来实现的。它应该如下所示:
<?xml version="1.0"?>
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/90" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<prefer-application-packages>
<package-name>javax.jws.*</package-name>
<package-name>javax.xml.bind.*</package-name>
<package-name>javax.xml.crypto.*</package-name>
<package-name>javax.xml.registry.*</package-name>
<package-name>javax.xml.rpc.*</package-name>
<package-name>javax.xml.soap.*</package-name>
<package-name>javax.xml.stream.*</package-name>
<package-name>javax.xml.ws.*</package-name>
<package-name>com.sun.xml.api.streaming.*</package-name>
</prefer-application-packages>
</weblogic-application>
6.记得将weblogic-application.xml文件放在你的 EAR 中!蚂蚁的目标可能类似于:
<?xml version="1.0"?>
<target name="build-ear" depends="war, manifest">
<delete dir="${dist}"/>
<mkdir dir="${dist}"/>
<jar destfile="${warfile}" basedir="${wardir}"/>
<ear destfile="${earfile}" appxml="resources/${app.name}/application.xml">
<fileset dir="${dist}" includes="${app.name}.war"/>
<metainf dir="resources/META-INF"/>
</ear>
</target>
7.此外,您还需要告诉 weblogic 更喜欢您的 WEB-INF 类而不是分发中的那些。为此,您可以在WEB-INF/weblogic.xml文件中添加以下行:
<?xml version="1.0"?>
<container-descriptor>
<prefer-web-inf-classes>true</prefer-web-inf-classes>
</container-descriptor>
8.weblogic相关配置就是这样。现在只设置您的 JAX-WS 目标。下面将根据本地部署的 WSDL 文件简单地生成 Web 服务存根和类,并将它们放在应用程序的文件夹中:
<?xml version="1.0"?>
<target name="generate-jaxws-client">
<taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">
<classpath path="classpath.main"/>
</taskdef>
<wsimport
destdir="${src}"
package="acme.somewhere.in.your.package.tree.webservices."
keep="true"
wsdl="http://localhost:8088/mockWebService?WSDL">
</wsimport>
</target>
记住 keep="true" 参数。没有它,wsimport 会生成类并...删除它们,信不信由你!
对于模拟 Web 服务,我建议使用开源项目 SOAPUI。非常易于部署,对于 Web 服务集成测试至关重要。
9.我们快到了。最后一件事是编写一个用于测试 Web 服务的 Java 类,首先尝试将其作为独立应用程序运行(或作为单元测试的一部分)
10.然后尝试从withing Weblogic 运行相同的代码。它应该工作。它对我有用。经过3天的挫折。是的,我知道我应该将 9 和 10 放在一个项目符号下,但是标题“使用 ant 在 Web 逻辑 9.2 下部署 JAX-WS Web 服务的 10 个步骤”听起来要好得多。
如果您发现缺少某些内容,请编辑这篇文章并改进它!