CXF+Spring搭建webservice服务

    Apache CXF 是一个开源的 Services 框架，CXF 帮助您利用 Frontend 编程 API 来构建和开发 Services ，像 JAX-WS 。这些 Services 可以支持多种协议，比如：SOAP、XML/HTTP、RESTful HTTP 或者 CORBA ，并且可以在多种传输协议上运行，比如：HTTP、JMS 或者 JBI，CXF 大大简化了 Services 的创建，同时它继承了 XFire 传统，一样可以天然地和 Spring 进行无缝集成。

　　先贴出maven项目的pom.xml，这里使用了spring，而且有坑，spring的版本选用太新会启动不了服务器，后改为3.X版本才好。

　　

 1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 2     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 3     <modelVersion>4.0.0</modelVersion>
 4     <groupId>com.bigbang</groupId>
 5     <artifactId>cxf</artifactId>
 6     <packaging>war</packaging>
 7     <version>0.0.1-SNAPSHOT</version>
 8     <name>cxf Maven Webapp</name>
 9     <url>http://maven.apache.org</url>
10     <properties>
11         <cxf.version>3.1.11</cxf.version>
12         <spring.version>3.1.0.RELEASE</spring.version>
13     </properties>
14     <dependencies>
15         <dependency>
16             <groupId>junit</groupId>
17             <artifactId>junit</artifactId>
18             <version>3.8.1</version>
19             <scope>test</scope>
20         </dependency>
21         <dependency>
22             <groupId>org.apache.cxf</groupId>
23             <artifactId>cxf-rt-frontend-jaxws</artifactId>
24             <version>${cxf.version}</version>
25         </dependency>
26         <dependency>
27             <groupId>org.apache.cxf</groupId>
28             <artifactId>cxf-rt-transports-http</artifactId>
29             <version>${cxf.version}</version>
30         </dependency>
31         <!-- Jetty is needed if you're are not using the CXFServlet -->
32         <dependency>
33             <groupId>org.apache.cxf</groupId>
34             <artifactId>cxf-rt-transports-http-jetty</artifactId>
35             <version>${cxf.version}</version>
36         </dependency>
37         <dependency>
38             <groupId>org.springframework</groupId>
39             <artifactId>spring-context</artifactId>
40             <version>${spring.version}</version>
41         </dependency>
42         <dependency>
43             <groupId>org.springframework</groupId>
44             <artifactId>spring-web</artifactId>
45             <version>${spring.version}</version>
46         </dependency>
47         <dependency>
48             <groupId>org.springframework</groupId>
49             <artifactId>spring-beans</artifactId>
50             <version>${spring.version}</version>
51         </dependency>
52     </dependencies>
53     <build>
54         <plugins>
55             <plugin>
56                 <groupId>org.mortbay.jetty</groupId>
57                 <artifactId>maven-jetty-plugin</artifactId>
58                 <version>6.1.26</version>
59                 <configuration>
60                     <webAppConfig>
61                         <contextPath>/</contextPath>
62                     </webAppConfig>
63                 </configuration>
64             </plugin>
65 
66             <plugin>
67                 <groupId>org.apache.maven.plugins</groupId>
68                 <artifactId>maven-compiler-plugin</artifactId>
69                 <configuration>
70                     <source>1.8</source>
71                     <target>1.8</target>
72                 </configuration>
73             </plugin>
74         </plugins>
75         <finalName>cxf</finalName>
76     </build>
77     
78 </project>
View Code

 　　项目web.xml文件的配置如下：

　　

 1  <context-param>
 2     <param-name>contextConfigLocation</param-name>
 3     <param-value>classpath*:/application*.xml</param-value>
 4   </context-param>
 5   <servlet>
 6     <servlet-name>CXFServlet</servlet-name>
 7     <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
 8     <load-on-startup>1</load-on-startup>
 9   </servlet>
10   <servlet-mapping>
11     <servlet-name>CXFServlet</servlet-name>
12     <url-pattern>/service/*</url-pattern>
13   </servlet-mapping>
14   <listener>
15     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
16   </listener>

　　其中CXFServlet是要访问的webservice入口配置。

　　Spring文件的相关配置如下：

　　

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jaxws="http://cxf.apache.org/jaxws"
 4     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 5         http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
 6 
 7     <import resource="classpath:META-INF/cxf/cxf.xml" />
 8     <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
 9     
10     <bean id="loginService"  class="com.bigbang.cxf.service.LoginServiceImpl"/>
11     <jaxws:endpoint implementor="#loginService" address="/login"/>
12 </beans>

　　需要引入jax-ws的命名空间。并且引入两个xml配置文件，这两个文件在cxf的包里面，可以不用关心。 此处配置了一个bean，该bean是实现webservice服务的实现类。里面是具体的业务逻辑。

　　jaxws：endpoint是配置webservice端地址的，implementor指向一个实现类，address是webservice的访问地址。结合web.xml里面的cxfServlet配置，访问webservice的地址应该为：http://IP：端口/项目名/service/login?wsdl

　　webservice的接口和实现类如下：

　　接口类：

　　

 1 package com.bigbang.cxf.service;
 2 
 3 import javax.jws.WebParam;
 4 import javax.jws.WebService;
 5 
 6 /**
 7  * @author pzj
 8  *
 9  */
10 @WebService
11 public interface LoginService {
12     
13     String login(@WebParam(name="name")String name,@WebParam(name="password")String password);
14 }

　　@webservice注解说明这是一个webservice类，@WebParam是指明webservice接口方法的参数名称。类似于springmvc的@requestParam注解。此处如果不指明参数名称，webservice的wsdl文件里将使用arg0,arg1...代替，在写客户端代码请求webservice的时候，将引起困扰，不易编写代码。　　

　　实现类为：

　　

 1 package com.bigbang.cxf.service;
 2 
 3 import javax.jws.WebService;
 4 
 5 /**
 6  * @author pzj 2017年5月16日 下午4:58:43
 7  *
 8  */
 9 @WebService(endpointInterface="com.bigbang.cxf.service.LoginService")
10 public class LoginServiceImpl implements LoginService {
11 
12     /* (non-Javadoc)
13      * @see com.bigbang.cxf.LoginService#login(java.lang.String, java.lang.String)
14      */
15     @Override
16     public String login(String name, String password) {
17         return name+"登录成功！密码是："+password;
18     }
19 
20 }

　　和上面接口不同的是，此处需要指明终端接口类的地址（包名+类名）。

　　全部准备好之后，使用jetty启动，会显示如下启动信息：

　　

五月 18, 2017 9:58:05 上午 org.apache.cxf.wsdl.service.factory.ReflectionServiceFactoryBean buildServiceFromClass
信息: Creating Service {http://service.cxf.bigbang.com/}LoginServiceImplService from class com.bigbang.cxf.service.LoginService
五月 18, 2017 9:58:06 上午 org.apache.cxf.endpoint.ServerImpl initDestination
信息: Setting the server's publish address to be /login
2017-05-18 09:58:06.173:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080

　　说明webservice发布成功了，访问http://localhost:8080/service/login?wsdl，会生成xml页面：

　　

 1 This XML file does not appear to have any style information associated with it. The document tree is shown below.
 2 <wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://service.cxf.bigbang.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" name="LoginServiceImplService" targetNamespace="http://service.cxf.bigbang.com/">
 3 <wsdl:types>
 4 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://service.cxf.bigbang.com/" elementFormDefault="unqualified" targetNamespace="http://service.cxf.bigbang.com/" version="1.0">
 5 <xs:element name="login" type="tns:login"/>
 6 <xs:element name="loginResponse" type="tns:loginResponse"/>
 7 <xs:complexType name="login">
 8 <xs:sequence>
 9 <xs:element minOccurs="0" name="name" type="xs:string"/>
10 <xs:element minOccurs="0" name="password" type="xs:string"/>
11 </xs:sequence>
12 </xs:complexType>
13 <xs:complexType name="loginResponse">
14 <xs:sequence>
15 <xs:element minOccurs="0" name="return" type="xs:string"/>
16 </xs:sequence>
17 </xs:complexType>
18 </xs:schema>
19 </wsdl:types>
20 <wsdl:message name="login">
21 <wsdl:part element="tns:login" name="parameters"></wsdl:part>
22 </wsdl:message>
23 <wsdl:message name="loginResponse">
24 <wsdl:part element="tns:loginResponse" name="parameters"></wsdl:part>
25 </wsdl:message>
26 <wsdl:portType name="LoginService">
27 <wsdl:operation name="login">
28 <wsdl:input message="tns:login" name="login"></wsdl:input>
29 <wsdl:output message="tns:loginResponse" name="loginResponse"></wsdl:output>
30 </wsdl:operation>
31 </wsdl:portType>
32 <wsdl:binding name="LoginServiceImplServiceSoapBinding" type="tns:LoginService">
33 <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
34 <wsdl:operation name="login">
35 <soap:operation soapAction="" style="document"/>
36 <wsdl:input name="login">
37 <soap:body use="literal"/>
38 </wsdl:input>
39 <wsdl:output name="loginResponse">
40 <soap:body use="literal"/>
41 </wsdl:output>
42 </wsdl:operation>
43 </wsdl:binding>
44 <wsdl:service name="LoginServiceImplService">
45 <wsdl:port binding="tns:LoginServiceImplServiceSoapBinding" name="LoginServiceImplPort">
46 <soap:address location="http://localhost:8080/service/login"/>
47 </wsdl:port>
48 </wsdl:service>
49 </wsdl:definitions>
View Code

　　

　　

转载于:https://www.cnblogs.com/bigbang92/p/webservice_cxf_spring.html

【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/twodog/p/12140529.html