根据WebService学习笔记系列(二)中的介绍,使用tcpmon可以捕获到我们发出或者接收到的xml内容,接天我们就对这些xml内容做一个简单的分析。还记得在WebService学习笔记系列(四)中我们详细介绍过服务器端程序的编写,本文的服务端程序依然沿用其中的服务端代码,但是系列(四)对于接口上的注解并没有详细的解释,今天先来看看接口上的注解有什么作用。
@WebService
public interface IMyServer {
@WebResult(name="addResult")
public int add(@WebParam(name="a")int a,@WebParam(name="b")int b);
public int minus(int a,int b);
}
上面这一段代码是我们在服务器端定义的一个接口,实现了这个接口的类就可以被发布,供其他人调用。这个接口中一共有两个方法,一个是add,一个是minus,这两个方法的不同就是add方法上添加了@WebResult(name=”addResult”)注解,add的参数之前添加了@WebParam(name=”a”)注解,而minus上没有添加任何注解,我们来看看添加了注解的方法和没添加注解的方法有什么不同。
public class MyFirstClient {
public static void main(String[] args) {
IMyServer myServerImpl = new MyServerImplService()
.getMyServerImplPort();
System.out.println(myServerImpl.add(3, 4)+"------");
myServerImpl.minus(7, 1);
}
}
这是一段客户端调用服务端的代码,具体调用方式见这里。客户端分别调用了服务器端两个方法,一个是add方法,另一个是minus方法,我们来看看tcpmon捕获的结果(tcpmon使用方式见这里)。
调用add方法时,发送的xml
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:add xmlns:ns2="http://lenve.server/">
<a>3</a>
<b>4</b>
</ns2:add>
</S:Body>
</S:Envelope>
调用add时,收到的xml:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:addResponse xmlns:ns2="http://lenve.server/">
<addResult>7</addResult>
</ns2:addResponse>
</S:Body>
</S:Envelope>
调用minus是发送的xml:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:minus xmlns:ns2="http://lenve.server/">
<arg0>7</arg0>
<arg1>1</arg1>
</ns2:minus>
</S:Body>
</S:Envelope>
调用minus时收到的xml:
<?xml version="1.0" ?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:minusResponse xmlns:ns2="http://lenve.server/">
<return>6</return>
</ns2:minusResponse>
</S:Body>
</S:Envelope>
add和minus方法都需要两个参数,由于我们在服务端的接口中已经指定了add方法的参数名@WebParam(name=”a”),所以调用add方法时,发送的就是<a>3</a><b>4</b>
,而调用minus时发送的是<arg0>7</arg0><arg1>1</arg1>
,这是因为我们没有指定参数名,所以系统给分配了参数名,一个良好的服务端必须要指定有意义的参数名,这样才方便第三方调用,而对于返回值也是一样,如果指定了返回值名称@WebResult(name="addResult")
,系统返回的xml就会使用<addResult>7</addResult>
,如果没有指定返回名称,系统就会使用默认的return<return>6</return>
。这便是服务端添加注解的作用。命名空间也是可以手动指定的,<ns2:minus xmlns:ns2="http://lenve.server/">
,你如果不想使用这个命名空间,可以自己在服务端通过注解手动指定命名空间名称,指定方式:
@WebService(targetNamespace="http://www.lenve.test")
public interface IMyServer {
@WebResult(name="addResult")
public int add(@WebParam(name="a")int a,@WebParam(name="b")int b);
public int minus(int a,int b);
}