现在webservice加xml技术已经逐渐成熟,但要真正要用起来还需时日!!
由于毕业设计缘故,我看了很多关于webservice方面的知识,今天和大家一起来研究研究webservice的各种使用方法。
一、利用jdk web服务api实现,这里使用基于
SOAP message 的
Web 服务
1.首先建立一个
Web services EndPoint: ![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
package Hello;
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.jws.WebService;
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.jws.WebMethod;
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.ws.Endpoint;
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
@WebService
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class Hello
{
@WebMethod
public String hello(String name) {
return "Hello, " + name + "\n";
}
public static void main(String[] args) {
// create and publish an endpoint
Hello hello = new Hello();
Endpoint endpoint = Endpoint.publish("http://localhost:8080/hello", hello);
}
}
2.使用 apt 编译 Hello.java(例:apt -d [存放编译后的文件目录] Hello.java ) ,会生成 jaws目录 3.使用java Hello.Hello运行,然后将浏览器指向就会出现下列显示 4.使用wsimport 生成客户端 使用如下:wsimport -p . -keep 这时,会在当前目录中生成如下文件:
5.客户端程序:
1
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
class HelloClient
{ 2
public static void main(String args[]) { 3
HelloService service = new HelloService(); 4
Hello helloProxy = service.getHelloPort(); 5
String hello = helloProxy.hello("你好"); 6
System.out.println(hello); 7
} 8
} 9
以上方法还稍显繁琐,还有更加简单的方法
二、使用xfire,我这里使用的是myeclipse集成的xfire进行测试的
利用xfire开发WebService,可以有三种方法:
1一种是从javabean 中生成;
2 一种是从wsdl文件中生成;
3 还有一种是自己建立webservice
步骤如下:
用myeclipse建立webservice工程,目录结构如下:
首先建立webservice接口,
代码如下:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
package com.myeclipse.wsExample;
2
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
// Generated by MyEclipse
3
4
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public interface IHelloWorldService
{ 5
6
public String example(String message);7
8
} 接着实现这个借口:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
package com.myeclipse.wsExample;
2
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
// Generated by MyEclipse
3
4
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class HelloWorldServiceImpl implements IHelloWorldService
{ 5
6
public String example(String message) { 7
return message; 8
} 9
10
} 修改service.xml 文件,加入以下代码:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< service >
2
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< name > HelloWorldService </ name >
3
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< serviceClass >
4
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
com.myeclipse.wsExample.IHelloWorldService
5
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ serviceClass >
6
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< implementationClass >
7
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
com.myeclipse.wsExample.HelloWorldServiceImpl
8
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ implementationClass >
9
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< style > wrapped </ style >
10
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< use > literal </ use >
11
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< scope > application </ scope >
12
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ service >
把整个项目部署到tomcat服务器中 ,打开浏览器,输入,可以看到如下:
然后再展开HelloWorldService后面的wsdl可以看到:
客户端实现如下:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
package com.myeclipse.wsExample.client;
2
3
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import java.net.MalformedURLException;
4
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import java.net.URL;
5
6
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.codehaus.xfire.XFireFactory;
7
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.codehaus.xfire.client.Client;
8
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.codehaus.xfire.client.XFireProxyFactory;
9
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.codehaus.xfire.service.Service;
10
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.codehaus.xfire.service.binding.ObjectServiceFactory;
11
12
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import com.myeclipse.wsExample.IHelloWorldService;
13
14
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class HelloWorldClient
{ 15
public static void main(String[] args) throws MalformedURLException, Exception { 16
// TODO Auto-generated method stub17
Service s=new ObjectServiceFactory().create(IHelloWorldService.class);18
XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire());19
String url="http://localhost:8989/HelloWorld/services/HelloWorldService";20
21
try22
{ 23
24
IHelloWorldService hs=(IHelloWorldService) xf.create(s,url);25
String st=hs.example("zhangjin");26
System.out.print(st);27
}28
catch(Exception e)29
{ 30
e.printStackTrace();31
}32
}33
34
} 35
这里再说点题外话,有时候我们知道一个wsdl地址,比如想用java客户端引用.net 做得webservice,使用myeclipse引用,但是却出现无法通过验证的错误,这时我们可以直接在类中引用,步骤如下:
1
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public static void main(String[] args) throws MalformedURLException, Exception
{ 2
// TODO Auto-generated method stub 3
Service s=new ObjectServiceFactory().create(IHelloWorldService.class); 4
XFireProxyFactory xf=new XFireProxyFactory(XFireFactory.newInstance().getXFire()); 5
6
7
//远程调用.net开发的webservice 8
Client c=new Client(new URL("http://www.webxml.com.cn/webservices/qqOnlineWebService.asmx?wsdl")); 9
Object[] o=c.invoke("qqCheckOnline", new String[]{ "531086641","591284436"});10
11
//调用.net本机开发的webservice12
Client c1=new Client(new URL("http://localhost/zj/Service.asmx?wsdl"));13
Object[] o1=c1.invoke("HelloWorld",new String[]{});14
15
}
三、使用axis1.4调用webservice方法
前提条件:下载axis1.4包和tomcat服务器 ,并将axis文件夹复制到tomcat服务器的webapp文件夹中
这里我就说一下最简单的方法:
首先建立一个任意的java类(例如:HelloWorld.java),复制到axis文件夹下,将其扩展名改为jws,然后重新启动tomcat,在浏览器中输入,就会得到一个wsdl文件,其客户端调用方法如下:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.rpc.Service;
2
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.rpc.ServiceException;
3
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.rpc.ServiceFactory;
4
5
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import java.net.MalformedURLException;
6
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import java.net.URL;
7
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import java.rmi.RemoteException;
8
9
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.namespace.QName;
10
11
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class TestHelloWorld
{ 12
13
14
public static void main(String[] args) throws MalformedURLException, ServiceException, RemoteException { 15
// TODO Auto-generated method stub16
17
String wsdlUrl ="http://localhost:8989/axis/HelloWorld.jws?wsdl";18
String nameSpaceUri ="http://localhost:8989/axis/HelloWorld.jws";19
String serviceName = "HelloWorldService";20
String portName = "HelloWorld";21
22
ServiceFactory serviceFactory = ServiceFactory.newInstance();23
Service afService =serviceFactory.createService(new URL(wsdlUrl),new QName(nameSpaceUri, serviceName));24
HelloWorldInterface proxy = (HelloWorldInterface)afService.getPort(new QName(nameSpaceUri, portName),HelloWorldInterface.class);25
System.out.println("return value is "+proxy.getName("john") ) ;26
27
}28
29
} 30
四、使用axis2开发webservice(这里首先感谢李宁老师)
使用axis2 需要先下载
axis2-1.4.1-bin.zip
axis2-1.4.1-war.zip
同理,也需要将axis2复制到webapp目录中
在axis2中部署webservice有两种方法,
第一种是pojo方式,这种方式比较简单,但是有一些限制,例如部署的类不能加上包名
第二种方式是利用xml发布webservice,这种方法比较灵活,不需要限制类的声明
下面分别说明使用方法:
1.pojo方式:在
Axis2中不需要进行任何的配置,就可以直接将一个简单的
POJO发布成
WebService。其中
POJO中所有的
public方法将被发布成
WebService方法。先实现一个pojo类:
1
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class HelloWorld
{ 2
public String getName(String name) 3
{ 4
return "你好 " + name; 5
} 6
public int add(int a,int b) 7
{ 8
return a+b; 9
} 10
} 11
由于这两个方法都是public类型,所以都会发布成webservice。编译HelloWorld类后,将HelloWorld.class文件放到%tomcat%\webapps\axis2\WEB-INF\pojo目录中(如果没有pojo目录,则建立该目录),然后打开浏览器进行测试:
输入一下url:
会列出所有webservice
这是其中的两个webservice列表,接着,在客户端进行测试:
首先可以写一个封装类,减少编码,代码如下:
1
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
package MZ.GetWebService;
2
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import javax.xml.namespace.QName;
3
4
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.apache.axis2.AxisFault;
5
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.apache.axis2.addressing.EndpointReference;
6
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.apache.axis2.client.Options;
7
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
import org.apache.axis2.rpc.client.RPCServiceClient;
8
9
10
![](http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif)
public class GetWSByAxis2
{ 11
private static String EndPointUrl;12
private static String QUrl="http://ws.apache.org/axis2";13
private QName opAddEntry; 14
public String WSUrl;15
public RPCServiceClient setOption() throws AxisFault16
{ 17
RPCServiceClient serviceClient = new RPCServiceClient();18
Options options = serviceClient.getOptions();19
EndpointReference targetEPR = new EndpointReference(WSUrl);20
options.setTo(targetEPR);21
return serviceClient;22
}23
24
public QName getQname(String Option){ 25
26
return new QName (QUrl,Option);27
}28
//返回String29
public String getStr(String Option) throws AxisFault30
{ 31
RPCServiceClient serviceClient =this.setOption(); 32
33
opAddEntry =this.getQname(Option);34
35
String str = (String) serviceClient.invokeBlocking(opAddEntry, 36
new Object[]{}, new Class[]{String.class })[0];37
return str;38
}39
// 返回一维String数组40
public String[] getArray(String Option) throws AxisFault41
{ 42
RPCServiceClient serviceClient =this.setOption(); 43
44
opAddEntry =this.getQname(Option);45
46
String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry, 47
new Object[]{}, new Class[]{String[].class })[0];48
return strArray;49
}50
//从WebService中返回一个对象的实例51
public Object getObject(String Option,Object o) throws AxisFault52
{ 53
RPCServiceClient serviceClient =this.setOption(); 54
QName qname=this.getQname(Option);55
Object object = serviceClient.invokeBlocking(qname, new Object[]{},new Class[]{o.getClass()})[0];56
return object;57
}58
59
/ 读者可以自己封装数据类型,如int,byte,float等数据类型60
} 61
客户端调用方法:
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
MZ.GetWebService.GetWSByAxis2 ws = new MZ.GetWebService.GetWSByAxis2();
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
ws.WSUrl = " http://localhost:8989/axis2/services/HelloWorld " ;
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
HelloWorld hello = (HelloWorld)ws.getObject( " getName " , HelloWorld. class );
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
System.out.println(hello.getName( " zhangjin " ));
2.使用service.xml发布webservice,这种方式和直接放在pojo目录中的POJO类不同。要想将MyService类发布成Web Service,需要一个services.xml文件,这个文件需要放在META-INF目录中,该文件的内容如下:
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< service name = " HelloWorld " >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< description >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
HelloWorld webservice
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ description >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< parameter name = " ServiceClass " >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
service.HelloWorld
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ parameter >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< messageReceivers >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< messageReceiver mep = " http://www.w3.org/2004/08/wsdl/in-out "
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
class = " org.apache.axis2.rpc.receivers.RPCMessageReceiver " />
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< messageReceiver mep = " http://www.w3.org/2004/08/wsdl/in-only "
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
class = " org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver " />
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ messageReceivers >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ service >
其中
<service>元素用于发布
Web Service,一个
<service>元素只能发布一个
WebService类,
name属性表示
WebService名,如下面的
URL可以获得这个
WebService的
WSDL内容:
除此之外,还有直接可以在其中制定webservice操作方法:可以这样些service.xml文件
service name = " HelloWorld " >
< description >
HelloWorld service
</ description >
< parameter name = " ServiceClass " >
service.HelloWorld
</ parameter >
< operation name = " getName " >
< messageReceiver class = " org.apache.axis2.rpc.receivers.RPCMessageReceiver " />
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ operation >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
< operation name = " add " >
< messageReceiver
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
class = " org.apache.axis2.rpc.receivers.RPCMessageReceiver " />
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ operation >
![](http://www.blogjava.net/Images/OutliningIndicators/None.gif)
</ service >
如果要发布多个webservice,可以在文件两段加上<serviceGroup><service></service>...<service></service></serviceGroup>发布