[置顶] 利用CXF发布webService的小demo

时间：2023-03-08 17:12:32

其实webService的发布不仅仅只有xfire，今天，给大家介绍一下用CXF发布一个webService的小demo，CXF也是我做webService用的第一个框架。。。
先将相关的jar引进来，在pom文件中添加
<dependency>
      <groupId>org.apache.cxf</groupId>
      <artifactId>cxf-rt-transports-http</artifactId>
      <version>2.7.3</version>
  </dependency>
  
  <dependency>
   <groupId>org.apache.cxf</groupId>
   <artifactId>cxf-rt-frontend-jaxws</artifactId>
   <version>2.7.3</version>
  </dependency>
即可引入相关的
第一步，不废话，还是写一个简单的接口与实现类，代码如下
public interface SayCXFService {
public  String sayHello(String name);
}
public class SayCXFServiceImpl implements SayCXFService{
@Override
public String sayHello(String name) {
  return name +" hello,this is my first CXF webService!";
}
}
接下来就是重点了，配置文件了，配置文件如下。相应的解释也有
<?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:jaxws="http://cxf.apache.org/jaxws"
xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
                        http://cxf.apache.org/jaxwshttp://cxf.apache.org/schemas/jaxws.xsd"
default-lazy-init="true"
>
  <!-- cxf 相关配置，这个照搬就行了，cxf框架里面自带的配置 -->
<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />

<!-- service定义 -->
<bean id="sayCXFbean"
  class="com.mip.biz.webservice.cxf.server.service.impl.SayCXFServiceImpl"
  scope="singleton"
/>
<!--
serviceClass 表示你要对外开发的接口，address表示的地址，本质就是一个servletName，可以随便命名
   -->
<jaxws:server id="webService" serviceClass="com.mip.biz.webservice.cxf.server.service.SayCXFService" address="/server">
     <!-- 表示你的接口实现类的bean -->
  <jaxws:serviceBean>
   <ref bean="sayCXFbean"/>
  </jaxws:serviceBean>
</jaxws:server>
</beans>

然后是web.xml文件添加如下内容
<servlet>
  <description>apache cxf 配置 webservice 服务</description>
  <servlet-name>CXFService</servlet-name>
  <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>CXFService</servlet-name>
  <url-pattern>/CXFService/*</url-pattern>
</servlet-mapping>
除了测试类，似乎和前段时间的xfire没啥区别，试一下启动tomcat，会发现抱NullPointerException吧[置顶] 利用CXF发布webService的小demo
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'webService': Invocation of init method failed; nested exception is java.lang.NullPointerException
别急，你只需要在接口上稍微改动一下即可

//注解的方式，将接口注入，targetNamespace中的内容其实就是将包名写反就行了。。这也是我们平时包名的命名规则类似。com开头，然后模块名称..有么像www.ho123.com?
@WebService(targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/")
public interface SayCXFService {
public  String sayHello(String name);
}
//实现类
@WebService(endpointInterface="com.mip.biz.webservice.cxf.server.service.SayCXFService",
  targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/")
public class SayCXFServiceImpl implements SayCXFService{
@Override
public String sayHello(String name) {
  return name +" hello,this is my first CXF webService!";
}
}
好了重启不会报错了
然后在浏览器中输入http://localhost:8080/mip/CXFService/server?wsdl出现祖国*一片红的景象就ok了
- <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://service.server.cxf.webservice.biz.mip.com/" elementFormDefault="unqualified" targetNamespace="http://service.server.cxf.webservice.biz.mip.com/" version="1.0">
<xs:element name="sayHello" type="tns:sayHello" />

<xs:element name="sayHelloResponse" type="tns:sayHelloResponse" />

- <xs:complexType name="sayHello">
+ <xs:sequence>
<xs:element minOccurs="0" name="arg0" type="xs:string" />

</xs:sequence>

</xs:complexType>

- 。。。。。。
注意到上面的红色标记部分没，其实我们可以将参数的名字显示出来，改下接口
@WebService(targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/")
public interface SayCXFService {
@WebMethod
@WebResult
//下面的name="wsdl中暴露出来的接口参数名称"
public  String sayHello(@WebParam(name="name",targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/") String name);
}
重新看下wsdl文件：

- <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://service.server.cxf.webservice.biz.mip.com/" elementFormDefault="unqualified" targetNamespace="http://service.server.cxf.webservice.biz.mip.com/" version="1.0">
<xs:element name="sayHello" type="tns:sayHello" />

<xs:element name="sayHelloResponse" type="tns:sayHelloResponse" />

- <xs:complexType name="sayHello">
- <xs:sequence>
<xs:element form="qualified" minOccurs="0" name="name" type="xs:string" />

</xs:sequence>

</xs:complexType>

-

以上是用java开发的服务端，下一章我们接着写客户端与测试类
@WebService(targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/")
public interface SayCXFClient {
public  String sayHello(String name); }
客户端其实直接将服务端拷贝过来就可以了。。。。当然这是在java开发的服务端基础上你才可以做，假如你的webservice服务端是其他语言开发的，，，那么可以用其他方法生成客户端咯，主要依据的是wsdl文件。。这个我在下一篇博客给大家介绍。。。请期待
最后在写个测试类
public class Test {
public static void main(String[] args) {
  JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
  factory.setServiceClass(SayCXFClient.class);
  factory.setAddress("http://localhost:8080/mip/CXFService/server");
  SayCXFClient service = (SayCXFClient) factory.create();
       System.out.println(service.sayHello("zhouxy"));
}
}
运行输出
Exception in thread "main" javax.xml.ws.soap.SOAPFaultException: Unmarshalling Error: unexpected element (uri:"", local:"arg0"). Expected elements are <{http://service.server.cxf.webservice.biz.mip.com/}name>
这个是由于我们在服务端明确指出了参数名name照成的，别担心，改下就行了
@WebService(
targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/")
public interface SayCXFClient {
@WebMethod
@WebResult
//下面的name="wsdl中暴露出来的接口参数名称"
public  String sayHello(@WebParam(name="name",targetNamespace = "http://service.server.cxf.webservice.biz.mip.com/") String name);
}
继续运行输出：
zhouxy hello,this is my first CXF webService!
ok，demo结束，更详细的理论知识自己查资料去吧