根据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);
}