JDK1.6 自带webservice构建

JDK1.6中自带了webservice的功能,因为集成了JAX-WS,这非常方便,不用再用第三方包来开发了。

下面我们开始构建:

  1,先用Eclipse建立一个动态网站,注意需要生成web.xml,建工程的时候不要忘记勾选;

  2,建立类实现Web Services接口,下面是一个简单定义Web Services接口的实现类:

代码

1 package javaWebServiceTest;
2
3  import javax.jws.WebMethod;
4  import javax.jws.WebParam;
5  import javax.jws.WebResult;
6  import javax.jws.WebService;
7  import javax.jws.WebParam.Mode;
8  import javax.jws.soap.SOAPBinding;
9  import javax.jws.soap.SOAPBinding.Style;
10  import javax.jws.soap.SOAPBinding.Use;
11
12  import webServiceInterface.Person;
13
14 @WebService(name="SayHello", portName="SayHellowServicePort", serviceName="SayHelloServiceName",
15         targetNamespace="http://www.webservice.com")
16 @SOAPBinding(style = Style.RPC,use = Use.LITERAL)  
17 public class ChService {
18    
19    @WebMethod(action="sayHello", operationName="saySomeWord")
20    @WebResult(name="Person", partName="PersonName")
21    public Person sayHelloWord(@WebParam(name="paramA", partName="p1", mode = Mode.IN)String name){
22        Person persons = new Person();
23        persons.setName("My name is " +name);
24        return persons;
25    }
26
27 }
28

 

 

    

 3,Person类

1 package webServiceInterface;
2
3
4 public class Person
5 {
6    String name;
7
8    public String getName() {
9        return name;
10    }
11
12    public void setName(String name) {
13        this.name = name;
14    }
15 }

这样,我们基本上就实现了webservice的构建,是不是感觉不是很难,跟写普通的java方法一样,其实jdk自带的webservice是通过注释注入方法实现的。所以上面那些以"@"符号开头的都是非常重要的,也是必须的。

下面我们来配置我们写的WebService到Apache中:

1,上面第一步,我们生成了一个web.xml类,我们向<web-app>节点里面加入以下内容:

代码

1 <listener>          
2    <listener-class>  
3            com.sun.xml.ws.transport.http.servlet.WSServletContextListener  
4    </listener-class>  
5  </listener>
6    
7    <servlet>  
8        <servlet-name>TestService</servlet-name>  
9        <servlet-class>  
10            com.sun.xml.ws.transport.http.servlet.WSServlet  
11        </servlet-class>  
12    </servlet>  
13      
14    <servlet-mapping>  
15        <servlet-name>TestService</servlet-name>  
16        <url-pattern>/jdkService</url-pattern>
17    </servlet-mapping>

 2,在web.xml的目录中再建立一个sun-jaxws.xml来配置endpoint的相关内容。

 

代码

1 <?xml version="1.0" encoding="UTF-8"?>
2 <endpoints xmlns=http://java.sun.com/xml/ns/jax-ws/ri/runtime version=2.0>  
3    <endpoint
4    name=TestService
5    implementation=javaWebServiceTest.ChService
6    binding="http://java.sun.com/xml/ns/jaxws/2003/05/soap/bindings/HTTP/"
7    url-pattern=‘/jdkService/>
8 </endpoints>

 

 

好了,配置完了。把我们建立的项目加入到apache7.0中,然后启动。

在浏览器输入:http://localhost:8080/TestWebService/jdkService?wsdl,便可以访问到。

如图:

 

 

现在我们来说说那些以"@"符号开头的内容。

1,@WebService(name="SayHello", portName="SayHellowServicePort",  serviceName="SayHelloServiceName", targetNamespace="http://www.possystem.com")

name: SayHello
  用户实例化用,例:
      private WinService.SayHelloClient win = new winformService.WinService.SayHelloClient();
  WSDL中:<portType name="SayHello">
 serviceName: SayHelloServiceName
      指定Web Service的名称 ,WSDL中:<service name="SayHelloServiceName">
 portName: SayHellowServicePort
       WSDL中:<port name="SayHellowServicePort" binding="tns:SayHellowServicePortBinding">   
 wsdlLocation:wsdlLocation 是引用预先存在的 WSDL 文件的 URL(相对或绝对)。
 targetNamespace:wsdl命名空间

 

2,@SOAPBinding(style = Style.RPC,use = Use.LITERAL) 
style: 定义发送到 Web Service 的消息和从 Web Service 发送的消息的编码样式。
        Document和RPC两种形式    
        默认值:
             javax.jws.soap.SOAPBinding.Style.DOCUMENT 
         
   use:  定义发送到 Web Service 的消息和从 Web Service 发送的消息的格式样式。          
         ENCODED和 LITERAL两种形式

          默认值:
             javax.jws.soap.SOAPBinding.Use.LITERAL    

 

3, @WebMethod(action="sayHello", operationName="saySomeWord")

   action: sayHello
     此操作的动作。 对于 SOAP 绑定,此方法可确定 soap 动作的值。
     WSDL中: <soap12:operation soapAction="sayHello" />
  operationName: sayHelloWord1
     与此方法匹配的 wsdl:operation 的名称。
     此名称也用于客户端调用的方法的名称。
  exclude 
         将某一方法标记为不作为一个 web 方法公开。

 

4, @WebResult(name="Person", partName="PersonName")

   name: Person
     返回值的名称。 如果操作是 rpc 样式,并且partName尚未指定, 表示此返回值的 wsdl:part 的名称
     WSDL中:<part name="Person" type="tns:person" /> 
  partName: PersonName
     表示此返回值的 wsdl:part 的名称。 
     此名称只在操作是 rpc 样式,或者操作是文档样式且参数样式为 BARE 时使用。
     WSDL中:<part name="PersonName" type="tns:person" />

 

5,  public Person sayHelloWord(@WebParam(name="paramA", partName="p1", mode = Mode.IN)String name){……}
   name: paramA
   如果该操作是 rpc 样式的,并且尚未指定 @WebParam.partName,则此名称是表示参数的 wsdl:part 的名称。
   如果该操作是文档样式的,或者参数映射到某一个头,则此名称是表示参数的 XML 元素的本地名称。 
   如果操作是文档样式的,参数样式为 BARE 并且模式为 OUT 或 INOUT,则必须指定一个名称。
   客户端调用时参数名称显示该值。
  partName: p1
   表示此参数的 wsdl:part 的名称。 
   此名称仅在操作是 rpc 样式,或者操作是文档样式且参数样式为 BARE 时使用。 
   WSDL中:
    <message name="sayHelloWord1">
       <part name="p1" type="xsd:string" /> 
      </message>
     客户端调用时参数名称显示该值。
    这个主要是根据样式来。
    mode:参数的流向(IN、OUT 或 INOUT 之一)。 

 

以上只是对一些常用的作了一些解释,都是自我理解的,有不正确的地方,还请指正。    


郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。