java开发webservice的几种方式

来源:互联网 发布:iphone手机数据恢复 编辑:程序博客网 时间:2024/04/29 11:24

汇总,四种方式:ax2,CXF,jdk自带,xfire


webservice的应用已经越来越广泛了,下面介绍几种在Java体系中开发webservice的方式,相当于做个记录。

1.Axis2

Axis是apache下一个开源的webservice开发组件,出现的算是比较早了,也比较成熟。这里主要介绍Axis+eclipse开发webservice,当然不用eclipse也可以开发和发布webservice,只是用eclipse会比较方便。

 

(1)下载eclipse的Java EE版本

http://www.eclipse.org/downloads/

 

(2)下载axis2

http://axis.apache.org/axis2/java/core/download.cgi

 

(3)下载eclipse的axis2插件

Axis2_Codegen_Wizard

Axis2_Service_Archiver

http://axis.apache.org/axis2/java/core/tools/index.html

推荐使用1.3的版本

 

(4)eclipse安装axis2插件

1)在任意目录下新建一个Axis2文件夹,在该文件夹下新建eclipse目录,在eclipse目录中新建plugins目录和features目录,例如:D:\programSoftware\eclipse-SVN\Axis2\eclipse;

2)把下载的axis2插件解压,并把解压的文件放到新建的eclipse的plugins目录下;

3)在%eclipse_home%的目录下新建links目录,并在links目录下新建axis2.link文件,内容为:path=D:\programSoftware\eclipse-SVN\Axis2;

4)重启eclipse,点击·file-new-other,如果看到Axis2 Wizards,则表明插件安装成功。

 

(5)安装axis2

下载Axis2的WAR Distribution并解压,把axis2.war包放置到%TOMCAT_HOME%/webapps下,启动tomcat,访问http://localhost:port/axis2,Axis2安装成功。

 

(6)使用eclipse新建web工程,创建一个普通java类,至少包含一个方法。

 

(7)发布webservice

1)点击eclipse的File-New-other,打开Axis2 Wizards,选择Axis2 Service Archiver,然后Next;

2)选择Class File Location,也就是类文件存放路径,注意:只选到classes目录,不要包括包文件夹,然后Next;

3)选择Skip WSDL,然后Next

4)一路Next到Select the Service XML file to be included in the Service archive,勾选Generate theservice xml automatically;

5)Service Name-填写你的service名称,Class Name-填写类名称,要包括包名,然后点击load,然后点击Finish,这时webservice就发布成功了;

6)然后到%TOMCAT_HOME%/webapps/axis2/WEB-INF/services 看看是否多了一个.aar的文件;

7)访问http://localhost:8085/axis2/services/类名?wsdl 就可看到生成的wsdl文件了。

注意:以上的方式是发布到axis2.war包中,你也可以把生成.aar文件copy到你的实际应用中,同时,你也可以使用eclipse的create webservice功能发布你的webservice,选择axis2生成你的webservice,这样webservice就会部署到你的应用中了。

 

2.Apche CXF

CXF开发webservice也是比较方便和简单的,它和spring的集成可以说是非常地好。举一个CXF开发webservice的例子吧。

1)在eclipse中新建一个web工程,导入依赖包,如图:

 

2)编写一个接口,如:

public String test(@WebParam(name="value", targetNamespace = "http://service.cxf.zcl.com/", mode = WebParam.Mode.IN)String value);

注意:CXF开发的webservice,接口中的方法的参数一定要以这种方式,否则客户端调用的时候CXF服务端会接收不到参数的值,name:参数名称,可不写(建议写上),targetNamespace:命名空间,一定要填写上,默认是包名反过来的顺序,mode:参数类型,IN表示输入。

3)编写一个实现类,实现接口的方法;

4)和spring的集成,编写一个bean文件,如:cxf-beans.xml,内容如下:

 

Cxf-beans.xml代码 复制代码 收藏代码
  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"  
  4.     xmlns:jaxws="http://cxf.apache.org/jaxws"  
  5.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd   
  6.                         http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">   
  7.   
  8.     <import resource="classpath:META-INF/cxf/cxf.xml" />   
  9.     <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />   
  10.     <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />   
  11.        
  12.     <jaxws:endpoint id="vote" implementor="com.zcl.cxf.service.VoteImpl" address="/Vote" />   
  13. </beans>  

 这个文件比较容易理解,就不解释了。

5)配置CXFServlet

在web.xml文件中配置CXFServlet,加载cxf-beans.xml文件,内容如下:

 

Web.xml代码 复制代码 收藏代码
  1. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  2.     xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
  3.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
  4.     id="WebApp_ID" version="2.5">   
  5.   
  6.     <context-param>   
  7.         <param-name>contextConfigLocation</param-name>   
  8.         <param-value>WEB-INF/cxf-beans.xml</param-value>   
  9.     </context-param>   
  10.        
  11.     <listener>   
  12.         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>   
  13.     </listener>   
  14.        
  15.     <servlet>   
  16.         <servlet-name>cxf</servlet-name>   
  17.         <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>   
  18.         <load-on-startup>1</load-on-startup>   
  19.     </servlet>   
  20.     <servlet-mapping>   
  21.         <servlet-name>cxf</servlet-name>   
  22.         <url-pattern>/services/*</url-pattern>   
  23.     </servlet-mapping>   
  24. </web-app>  

 把工程部署到中间件,如tomcat,就可以访问该webservice了。

 

3.JDK开发webservice

1)编写一个Java类,如下:

 

Jdkwebservice.java代码 复制代码 收藏代码
  1. package demo;   
  2.   
  3. import javax.jws.WebParam;   
  4. import javax.jws.WebService;   
  5. import javax.xml.ws.Endpoint;   
  6.   
  7. @WebService   
  8. public class JdkWebService {   
  9.   
  10.     public String doSomething(@WebParam(name="value", targetNamespace = "http://demo/", mode = WebParam.Mode.IN)String value) {   
  11.         return "Just do it," + value + "!";   
  12.     }   
  13.        
  14.     public static void main(String[] args) {   
  15.         Endpoint.publish("http://localhost:8080/jdkwsdemo/demo.JdkWebService", new JdkWebService());   
  16.     }   
  17. }  

 2)运行该java类,在浏览器上就可以访问该webservice了。

注意:开发web工程的时候,这种方法不太友好。我们可以编写一个servlet类,在servlet类的初始化方法中发布webservice,这样我们的中间件服务器启动的时候就会帮我们自动webservice了。

 

 4)  xfire

开发WebService的框架不少,每个框架都有各自的有点,最近我用xfire练习开发WebService,下面是开发WebService的小例子,希望对入门的人有些小帮助 
1.新建一个java web project命名为TestWebService,将xfire相关的jar包添加到lib目录中,写接口类和实现类 
Java代码 复制代码 收藏代码
  1. package com.lamp.service;   
  2.   
  3. public interface MessageService {   
  4.     public String getName(String name);   
  5. }  
[java] view plaincopyprint?
  1. package com.lamp.service;  
  2.   
  3. public interface MessageService {  
  4.     public String getName(String name);  
  5. }  

实现类 
Java代码 复制代码 收藏代码
  1. package com.lamp.service.impl;   
  2.   
  3. import com.lamp.service.MessageService;   
  4.   
  5. public class MessageServiceImpl implements MessageService {   
  6.   
  7.     public String getName(String name) {   
  8.         return "hellow " + name + ", welcome to WebService world";   
  9.     }   
  10.   
  11. }  
[java] view plaincopyprint?
  1. package com.lamp.service.impl;  
  2.   
  3. import com.lamp.service.MessageService;  
  4.   
  5. public class MessageServiceImpl implements MessageService {  
  6.   
  7.     public String getName(String name) {  
  8.         return "hellow " + name + ", welcome to WebService world";  
  9.     }  
  10.   
  11. }  


在src目录下新建文件夹META-INF,然后再在其下新建文件夹xfire,在xfire目录下新建配置文件services.xml 
Xml代码 复制代码 收藏代码
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <beans xmlns="http://xfire.codehaus.org/config/1.0">  
  3.   <service>  
  4.     <name>MessageService</name>  
  5.     <serviceClass>com.lamp.service.MessageService</serviceClass>  
  6.     <implementationClass>com.lamp.service.impl.MessageServiceImpl</implementationClass>  
  7.   </service>  
  8. </beans>  
[xml] view plaincopyprint?
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <beans xmlns="http://xfire.codehaus.org/config/1.0">  
  3.   <service>  
  4.     <name>MessageService</name>  
  5.     <serviceClass>com.lamp.service.MessageService</serviceClass>  
  6.     <implementationClass>com.lamp.service.impl.MessageServiceImpl</implementationClass>  
  7.   </service>  
  8. </beans>  

最后在web.xml中配置xfire的servlet 
Xml代码 复制代码 收藏代码
  1. <servlet>  
  2.         <servlet-name>XFireServlet</servlet-name>  
  3.         <servlet-class>  
  4.             org.codehaus.xfire.transport.http.XFireConfigurableServlet   
  5.         </servlet-class>  
  6.     </servlet>  
  7.   
  8.     <servlet-mapping>  
  9.         <servlet-name>XFireServlet</servlet-name>  
  10.         <url-pattern>/servlet/XFireServlet/*</url-pattern>  
  11.     </servlet-mapping>  
  12.   
  13.     <servlet-mapping>  
  14.         <servlet-name>XFireServlet</servlet-name>  
  15.         <url-pattern>/services/*</url-pattern>  
  16.     </servlet-mapping>  
[xml] view plaincopyprint?
  1. <servlet>  
  2.         <servlet-name>XFireServlet</servlet-name>  
  3.         <servlet-class>  
  4.             org.codehaus.xfire.transport.http.XFireConfigurableServlet  
  5.         </servlet-class>  
  6.     </servlet>  
  7.   
  8.     <servlet-mapping>  
  9.         <servlet-name>XFireServlet</servlet-name>  
  10.         <url-pattern>/servlet/XFireServlet/*</url-pattern>  
  11.     </servlet-mapping>  
  12.   
  13.     <servlet-mapping>  
  14.         <servlet-name>XFireServlet</servlet-name>  
  15.         <url-pattern>/services/*</url-pattern>  
  16.     </servlet-mapping>  

项目部署后在浏览器中通过http://localhost:8080/TestWebService/services访问看到远程访问的接口,并得到wsdl为http://localhost:8080/TestWebService/services/MessageService?wsdl 

这样服务器端开发完毕,现在开始客户端的开发 
新建一个java project也将xfire相关的jar引入,我用ant在客户端生成代理对象,在项目路径下新建build.xml,代码为 
Xml代码 复制代码 收藏代码
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2.   
  3. <project name="WebService" basedir="." default="gen-webservice">  
  4.   
  5.     <property file="build.properties">  
  6.     </property>  
  7.   
  8.     <path id="project-classpath">  
  9.         <fileset dir="${lib.dir}">  
  10.             <include name="**/*.jar" />    
  11.         </fileset>  
  12.     </path>  
  13.   
  14.     <target name="gen-webservice">  
  15.         <taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="project-classpath" />  
  16.   
  17.         <wsgen outputDirectory="${src.dir}"  
  18.           wsdl="${wsdl.dir}" package="com.lamp.ws.client" overwrite="true"/>  
  19.            
  20.     </target>  
  21.   
  22. </project>  
[xml] view plaincopyprint?
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2.   
  3. <project name="WebService" basedir="." default="gen-webservice">  
  4.   
  5.     <property file="build.properties">  
  6.     </property>  
  7.   
  8.     <path id="project-classpath">  
  9.         <fileset dir="${lib.dir}">  
  10.             <include name="**/*.jar" />   
  11.         </fileset>  
  12.     </path>  
  13.   
  14.     <target name="gen-webservice">  
  15.         <taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="project-classpath" />  
  16.   
  17.         <wsgen outputDirectory="${src.dir}"  
  18.           wsdl="${wsdl.dir}" package="com.lamp.ws.client" overwrite="true"/>  
  19.           
  20.     </target>  
  21.   
  22. </project>  

其引入的build.properties文件也在项目路径下 
src.dir=${basedir}/src 
lib.dir=F:/WebService/xfire-1.2.6/lib 
wsdl.dir=http://localhost:8080/TestWebService/services/MessageService?wsdl 
其中lib.jar为我存放xfire的路径,运行ant得到代理对象 
编写一个测试类 
Java代码 复制代码 收藏代码
  1. package com.lamp.test;   
  2.   
  3. import com.lamp.ws.client.MessageServiceClient;   
  4. import com.lamp.ws.client.MessageServicePortType;   
  5.   
  6. public class TestGetName {   
  7.   
  8.     public static void main(String[] args) {   
  9.         MessageServiceClient msg = new MessageServiceClient();   
  10.         MessageServicePortType portType = msg.getMessageServiceHttpPort();   
  11.         String result = portType.getName("张三");   
  12.         System.out.println(result);   
  13.     }   
  14.   
  15. }  
[java] view plaincopyprint?
  1. package com.lamp.test;  
  2.   
  3. import com.lamp.ws.client.MessageServiceClient;  
  4. import com.lamp.ws.client.MessageServicePortType;  
  5.   
  6. public class TestGetName {  
  7.   
  8.     public static void main(String[] args) {  
  9.         MessageServiceClient msg = new MessageServiceClient();  
  10.         MessageServicePortType portType = msg.getMessageServiceHttpPort();  
  11.         String result = portType.getName("张三");  
  12.         System.out.println(result);  
  13.     }  
  14.   
  15. }  

运行在控制台看到了hellow 张三, welcome to WebService world至此一个简单的WebService开发完毕
0 0