WildFly中EJB与Web服务集成：部署故障排查与WSDL访问指南

理解EJB与Web服务集成的部署挑战

在jakarta ee（或旧称java ee）环境中，将企业级javabeans（ejb）与web服务（jax-ws）集成是常见的应用架构模式。然而，在wildfly等应用服务器上部署此类复合应用时，开发者常会遇到类加载（noclassdeffounderror或classnotfoundexception）相关的部署失败。这通常发生在web服务模块尝试引用ejb接口时。

NoClassDefFoundError分析：类加载与依赖管理

当Web服务（WAR）模块尝试调用EJB模块中的接口时，如果出现类似java.lang.NoClassDefFoundError: Lorg/myapp/MyAppStatelessLocal;的错误，表明Web服务的类加载器无法找到EJB接口的定义。这背后涉及Maven的依赖管理和Jakarta EE的EAR（Enterprise Archive）打包机制。

1. Maven scope provided的正确使用： 在多模块Maven项目中，如果一个WAR模块（例如myapp-ws）需要使用同一个EAR中EJB模块（例如myapp-ejb）提供的接口，通常会将EJB模块作为依赖添加到WAR模块中，并设置scope为provided。provided范围表示该依赖在编译和测试时可用，但在运行时将由应用服务器提供，因此不会被打包进WAR文件本身。对于EJB接口而言，这是正确的做法，因为EJB JAR会作为EAR的一个模块部署，其类将在EAR的共享类加载器中可用。

   <!-- myapp-ws/pom.xml 示例 -->
   <project>
       <!-- ... -->
       <dependencies>
           <!-- ... 其他依赖 -->
           <dependency>
               <groupId>${project.groupId}</groupId>
               <artifactId>myapp-ejb</artifactId>
               <type>ejb</type>
               <scope>provided</scope> <!-- EJB接口由EAR提供 -->
           </dependency>
       </dependencies>
   </project>

   登录后复制

2. EAR打包机制与类加载隔离： EAR文件是Jakarta EE应用的标准打包格式，它可以包含多个Web模块（WAR）、EJB模块（JAR）和客户端模块。WildFly等服务器会为EAR创建一个顶层类加载器，并为EAR中的每个WAR和EJB模块创建独立的子类加载器。默认情况下，EAR的类加载器会优先加载其lib目录下的JAR包，并使其对所有模块可见。同时，模块之间的类加载遵循特定的委托规则。当WAR模块的pom.xml中EJB依赖设置为provided时，它期望EJB接口在EAR的共享类路径中能够被找到。

   部署失败的NoClassDefFoundError通常意味着：

   • EJB模块（myapp-ejb.jar）没有被正确地包含在EAR中。
   • EAR的application.xml（通常由maven-ear-plugin自动生成）没有正确列出EJB模块。
   • 虽然EJB模块存在于EAR中，但由于某些特定的类加载器配置或版本冲突，导致WAR的类加载器无法有效委托或访问到EJB接口。

解决方案：确保EAR的正确构建与模块可见性

解决此类部署问题的关键在于确保EAR的Maven配置能够正确地将所有子模块打包，并使其在运行时相互可见。

1. 检查EAR的pom.xml： 确保EAR项目（例如myapp-ear）的pom.xml明确声明了所有需要包含的EJB和WAR模块作为其依赖。maven-ear-plugin会根据这些依赖自动生成application.xml并打包相应的模块。

   <!-- myapp-ear/pom.xml 示例 -->
   <project>
       <!-- ... -->
       <packaging>ear</packaging>
       <dependencies>
           <dependency>
               <groupId>${project.groupId}</groupId>
               <artifactId>myapp-ejb</artifactId>
               <type>ejb</type>
               <version>${project.version}</version>
           </dependency>
           <dependency>
               <groupId>${project.groupId}</groupId>
               <artifactId>myapp-ws</artifactId>
               <type>war</type>
               <version>${project.version}</version>
           </dependency>
           <!-- ... 其他模块 -->
       </dependencies>
       <build>
           <plugins>
               <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-ear-plugin</artifactId>
                   <version>3.2.0</version> <!-- 使用最新版本 -->
                   <configuration>
                       <!-- 可选：配置模块的上下文根等 -->
                       <modules>
                           <webModule>
                               <groupId>${project.groupId}</groupId>
                               <artifactId>myapp-ws</artifactId>
                               <contextRoot>/myapp-ws</contextRoot>
                           </webModule>
                           <ejbModule>
                               <groupId>${project.groupId}</groupId>
                               <artifactId>myapp-ejb</artifactId>
                           </ejbModule>
                       </modules>
                   </configuration>
               </plugin>
           </plugins>
       </build>
   </project>

   登录后复制

   通过这种方式，maven-ear-plugin会将myapp-ejb.jar和myapp-ws.war正确地打包到EAR中，并配置EAR的application.xml，使得myapp-ws.war能够通过EAR的类加载器访问到myapp-ejb.jar中的接口。

2. EJB接口与实现的分离（可选但推荐）： 对于大型项目，有时会将EJB接口定义在一个独立的JAR模块中，而EJB实现则在另一个JAR模块中。在这种情况下，Web服务模块应依赖EJB接口模块，同样设置为provided。这种做法有助于进一步解耦。

Web服务WSDL的正确访问

一旦Web服务成功部署，下一步是访问其WSDL（Web Services Description Language）文件以生成客户端代码或进行测试。常见的错误是使用错误的URL模式。

WSDL URL结构解析

在Jakarta EE中，JAX-WS Web服务的WSDL URL通常遵循以下模式： http://<host>:<port>/<context-root>/<servlet-mapping-url>?wsdl

• <host>:<port>: 应用服务器的地址和端口，例如localhost:8080。
• <context-root>: Web服务WAR模块在EAR中的上下文根。如果未显式配置，通常是WAR文件的名称（不含.war后缀），例如myapp-ws。
• <servlet-mapping-url>: 在web.xml中为Web服务实现类配置的<servlet-mapping>的<url-pattern>值。
• ?wsdl: WSDL查询参数，指示服务器返回服务的WSDL定义。

web.xml中的Servlet配置与URL映射

Web服务实现类（例如myapp.ws.MyAppWSImpl）通常通过@WebService注解自动暴露。但在某些情况下，或者为了更精细的控制，可以在web.xml中显式配置一个Servlet来暴露JAX-WS端点。

集简云

软件集成平台，快速建立企业自动化与智能化

22

查看详情

<!-- myapp-ws/web.xml 示例 -->
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
  <display-name>myapp-ws</display-name>

  <servlet>
    <servlet-name>myappws</servlet-name> <!-- Servlet的逻辑名称 -->
    <servlet-class>myapp.ws.MyAppWSImpl</servlet-class> <!-- Web服务实现类 -->
  </servlet>
  <servlet-mapping>
    <servlet-name>myappws</servlet-name>
    <url-pattern>/myappws</url-pattern> <!-- 重要的URL映射模式 -->
  </servlet-mapping>

</web-app>

根据上述web.xml配置，Web服务实现类myapp.ws.MyAppWSImpl被映射到了/myappws这个URL模式。

正确与错误的WSDL URL示例

• 错误示例： http://localhost:8080/myapp-ws/MyAppWSImpl?wsdl 这个URL错误地将Web服务实现类的名称（MyAppWSImpl）作为了URL路径的一部分。服务器不会识别这种模式。

• 正确示例： http://localhost:8080/myapp-ws/myappws?wsdl 这个URL遵循了正确的结构：

  • localhost:8080：服务器地址和端口。
  • myapp-ws：WAR模块的上下文根。
  • myappws：web.xml中定义的<url-pattern>。
  • ?wsdl：WSDL查询参数。

使用正确的URL模式是成功访问Web服务WSDL的关键。

最佳实践与总结

为了在WildFly上顺利集成EJB和Web服务，请遵循以下最佳实践：

1. Maven多模块结构： 采用清晰的Maven多模块项目结构，将EJB、Web服务、EAR等功能模块分离，有助于管理依赖和构建过程。
2. EAR打包： 始终使用EAR来打包相互依赖的EJB和Web服务模块。EAR的类加载器机制能够确保模块间的类可见性。
3. maven-ear-plugin配置： 仔细配置maven-ear-plugin，确保所有模块都正确包含在EAR中，并且上下文根等属性设置正确。
4. scope provided： 对于WAR模块中引用的EJB接口依赖，务必使用scope provided，避免将EJB接口重复打包到WAR中，这可能导致类加载冲突。
5. web.xml与WSDL URL： 明确Web服务在web.xml中的Servlet映射，并根据context-root和url-pattern构造正确的WSDL访问URL。
6. 错误日志分析： 当遇到部署失败时，仔细分析WildFly的服务器日志。NoClassDefFoundError和ClassNotFoundException通常会提供详细的类名和加载器信息，这是排查问题的关键线索。

通过理解Jakarta EE的部署机制、Maven的依赖管理以及WildFly的类加载行为，开发者可以有效避免和解决EJB与Web服务集成中的常见问题，确保应用程序的顺利部署和稳定运行。

以上就是WildFly中EJB与Web服务集成：部署故障排查与WSDL访问指南的详细内容，更多请关注php中文网其它相关文章！