Axis2实践

Axis2是一个开源的、基于Java的Web服务框架，用于构建和发布Web服务。它是Apache软件基金会的一个顶级项目，并提供了丰富的功能和灵活性。

Axis2以轻量级和易于使用为设计目标，并提供了以下主要特性：

1. 支持多种协议：Axis2支持多种常见的Web服务协议，如SOAP、HTTP、REST等。可以根据需要选择合适的协议来传输和交换数据。

2. 高度可扩展：Axis2使用模块化的体系结构，允许用户根据自己的需求添加或移除特定功能的模块。这使得框架非常灵活，并能够适应各种不同的应用场景。

3. 兼容性：Axis2遵循Web服务相关的标准和规范，如WSDL、SOAP、XML等。它与其他Web服务平台和工具具有良好的互操作性，可以与各种客户端和服务端进行集成。

4. 强大的消息处理：Axis2提供了丰富的消息处理功能，包括消息传输、消息路由、消息转换等。它支持多种消息格式，如XML、JSON等，以及多种消息编码方式，如SOAP 1.1、SOAP 1.2等。

5. 易于部署和管理：Axis2提供了一个简单易用的部署和管理工具，使得开发人员可以轻松地部署和管理Web服务。它还提供了一套完整的监控和管理API，方便进行性能调优和故障排除。

使用Axis2，您可以快速构建和发布高性能、可扩展的Web服务。它提供了丰富的功能和工具，使得开发和管理Web服务变得更加简单和高效。通过使用Axis2，您可以实现跨平台、跨语言的Web服务集成，并实现与其他系统的无缝交互。

1. 构建server项目

 1.1 添加依赖

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <axis2.version>1.7.9</axis2.version>
  </properties>

  <dependencies>
    <!--axis2 begin-->
    <dependency>
      <groupId>org.apache.axis2</groupId>
      <artifactId>axis2</artifactId>
      <version>${axis2.version}</version>
      <type>pom</type>
    </dependency>

    <dependency>
      <groupId>org.apache.axis2</groupId>
      <artifactId>axis2-spring</artifactId>
      <version>${axis2.version}</version>
      <exclusions>
        <exclusion>
          <groupId>org.springframework</groupId>
          <artifactId>spring-beans</artifactId>
        </exclusion>
        <exclusion>
          <groupId>org.springframework</groupId>
          <artifactId>spring-core</artifactId>
        </exclusion>
        <exclusion>
          <groupId>org.springframework</groupId>
          <artifactId>spring-web</artifactId>
        </exclusion>
        <exclusion>
          <groupId>org.springframework</groupId>
          <artifactId>spring-context</artifactId>
        </exclusion>
      </exclusions>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.3.18.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.apache.axis2</groupId>
      <artifactId>axis2-transport-http</artifactId>
      <version>${axis2.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.axis2</groupId>
      <artifactId>axis2-transport-local</artifactId>
      <version>${axis2.version}</version>
    </dependency>

    <dependency>
      <groupId>org.apache.axis2</groupId>
      <artifactId>axis2-xmlbeans</artifactId>
      <version>${axis2.version}</version>
    </dependency>

    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
        <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
        <plugin>
          <artifactId>maven-site-plugin</artifactId>
          <version>3.7.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-project-info-reports-plugin</artifactId>
          <version>3.0.0</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>

1.2创建实体类

public class User {
    public int getUserId() {
        return userId;
    }

    public void setUserId(int userId) {
        this.userId = userId;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    private int userId;
    private String userName;
}

1.3 创建发布的接口以及其实现类

public interface UserService {
    User addUser(User user);
    User get(int userId);
}

import com.mike.xfire.domain.User;
import org.springframework.stereotype.Service;

/*
  Author:Mike
  创建时间：2019/11/4
  描述：
*/
@Service("userService")
public class UserServerImpl implements UserService {
    public User addUser(User user) {
        user.setUserName("新增->" + user.getUserName());
        return user;
    }

    public User get(int userId) {
        User user = new User();
        user.setUserId(userId);
        user.setUserName("如约而至");
        return user;
    }
}

1.3 添加配置

（1）创建资源文件spring-axis2.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    <context:component-scan base-package="com.mike.xfire.server" />
    <bean id="application" class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />
</beans>

base-package="com.mike.xfire.server"为接口所在的包路径。

（2） 创建WEB-INF/web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
          http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         version="2.5">
    <!--配置请求处理的servlet-->
    <servlet>
        <servlet-name>AxisServlet</servlet-name>
        <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
    </servlet>

    <servlet-mapping>
        <servlet-name>AxisServlet</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>


    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring-axis2.xml</param-value>
    </context-param>
</web-app>

(3) 创建WEB-INF/services/webserver/META-INF/services.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- 通过ServiceObjectSupplier参数指定SpringServletContextObjectSupplier类来获得Spring的ApplicationContext对象 -->
<service name="ServiceServer">
    <description>axis2</description>
    <!-- 通过ServiceObjectSupplier参数指定SpringServletContextObjectSupplier类来获得Spring的ApplicationContext对象 -->
    <parameter name="ServiceObjectSupplier" locked="false">
        org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier
    </parameter>
    <!--
    SpringBeanName固定的不能改
    userServiceImpl是spring中注册的实现类得id,@Component注解
    -->
    <parameter name="SpringBeanName">userService</parameter>
    <!--

    <messageReceivers>元素，该元素用于设置处理WebService方法的处理器。
    例如，hello方法有一个返回值，因此，需要使用可处理输入输出的RPCMessageReceiver类，
    而update方法没有返回值，因此，需要使用只能处理输入的RPCInOnlyMessageReceiver类。
    -->
    <messageReceivers>
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
                         class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
                         class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
    </messageReceivers>
</service>

至此，server已经构建完成。

1.4 在浏览器上输入http://localhost:8080/axis2/services/ServiceServer?wsdl访问，http://localhost:8080/axis2为Tomcat部署的地址。

 2. 构建客户端

2.1 使用axis2第三方工具生成调用类

在axis2官网（https://axis.apache.org/axis2/java/core/）下载合适的版本，在bin目录cmd输入command

wsdl2java -o D:\workspace\study\webserver\axis2\wsdl -uri http://localhost:8080/axis2/services/ServiceServer?wsdl -s -p com.mike.study.axis2.client

-url参数指定了wsdl文件的路径，可以是本地路径，也可以是网络路径。

-p参数指定了生成的Java类的包名，

-o参数指定了生成的一系列文件保存的根目录。

-s 同步模式代码

-a 异步模式代码

2.2 构建maven项目，添加依赖和server端一样。

2.4 将axis2生成的Java类，放置项目中

 2.5 客户端调用ServiceServerStub，实现远程调用

import com.mike.study.axis2.client.ServiceServerStub;
import org.apache.axis2.AxisFault;

import java.rmi.RemoteException;

/**
 * @Classname Axis2ClientApplication
 * @Created by Michael
 * @Date 2023/7/31
 * @Description TODO
 */
public class Axis2ClientApplication {
  public static void main(String[] args) {
    try {
      ServiceServerStub serverStub = new ServiceServerStub();
      ServiceServerStub.User user = new ServiceServerStub.User();
      user.setUserId(10001);
      user.setUserName("axis2");

      ServiceServerStub.AddUser addUser = new ServiceServerStub.AddUser();
      addUser.setUser(user);
      ServiceServerStub.AddUserResponse addUserResponse = serverStub.addUser(addUser);
      System.out.println(addUserResponse.get_return().getUserName());
    } catch (AxisFault axisFault) {
      axisFault.printStackTrace();
    } catch (RemoteException e) {
      e.printStackTrace();
    }

  }
}

2.5 测试结果