JavaEE5 Jax-ws 学习(Soap webservice)

http://blog.csdn.net/birdsaction/article/details/3408350

我们使用ＪＡＸ－ＷＳ建立一个简单的 WEB 服务 ，建立业务逻辑代码 ，就是暴露给客户的 服务的代码.

到这里下载 JAX-WS 2.0的 包: https://jax-ws.dev.java.net/

1. package com.birds.ws;
3. import javax.jws.WebMethod;
4. import javax.jws.WebService;
6. /**
7.  * @author birds
8.  * @since Nov 27, 2008 9:20:16 PM
9.  */
10. @WebService
11. public class HelloQuick {
12.     public HelloQuick() {
13.     }
14.     @WebMethod
15.     public String show() {
16.         return "SHOW YOU!";
17.     }
19. }
20. // 上面的代码，足够简单， 在HelloQuick类上面 ，有一个 Annotation修饰 @WebService
21. 这个修饰必须是 javax.jws.WebService ，  javax.jws.WebServiceProvider 其中一个，
22. 默认构造函数必须有一个。
23. 业务方法 show() 函数上面有一个 @WebMethod修饰，，如果这个函数有参数，就需要增加参数的修饰
24. 比方说： show(@WebParam(name = "msg") String msg){}  多了一个参数
25. 知道更多的细节，参考 jax-ws的文档，

       建立环境 : 这里使用 Tomcat 6.0

       需要编写 配置 webapps/jaxws2/WEB-INF/Web.xml

27. xml version="1.0" encoding="UTF-8"?>
28. <web-app version="2.5" 
29.     xmlns="http://java.sun.com/xml/ns/javaee" 
30.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
31.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
32.     http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
34.   <listener>
35.      <listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListenerlistener-class>
36.   listener>
37.   
38.   <servlet>
39.      <servlet-name>fishservlet-name>
40.      <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServletservlet-class>
41.   servlet>
42.   
43.   <servlet-mapping>
44.      <servlet-name>fishservlet-name>
45.      <url-pattern>/quickurl-pattern>
46.   servlet-mapping>
47.     
48.   <welcome-file-list>
49.     <welcome-file>index.jspwelcome-file>
50.   welcome-file-list>
51. web-app>

             WSServletContextListener ,和 WSServlet 都是 系统运行需要的配置，

             还需要建立一个 sun-jaxws.xml 

54. xml version="1.0" encoding="UTF-8"?>
55. <endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime'
56.     version='2.0'>
57.     <endpoint name='fish' implementation='com.birds.ws.HelloQuick'
58.         url-pattern='/quick' />
59. endpoints>
62.             // Parse the descriptor file and build endpoint infos
63.             DeploymentDescriptorParser parser = new DeploymentDescriptorParser(
64.                 classLoader,new ServletResourceLoader(context), createContainer(context), new ServletAdapterList());
65.             URL sunJaxWsXml = context.getResource(JAXWS_RI_RUNTIME);
66.             if(sunJaxWsXml==null)
67.                 throw new WebServiceException(WsservletMessages.NO_SUNJAXWS_XML(JAXWS_RI_RUNTIME));
68.             List adapters = parser.parse(sunJaxWsXml.toExternalForm(), sunJaxWsXml.openStream());
70.             delegate = createDelegate(adapters, context);
72.             context.setAttribute(WSServlet.JAXWS_RI_RUNTIME_INFO,delegate);
73.             
74.         } catch (Throwable e) {
75.             logger.log(Level.SEVERE,
76.                 WsservletMessages.LISTENER_PARSING_FAILED(e),e);
77.             context.removeAttribute(WSServlet.JAXWS_RI_RUNTIME_INFO);
78.             throw new WSServletException("listener.parsingFailed", e);
79.         }
80.  // JAXWS_RI_RUNTIME 为  /WEB-INF/sun-jaxws.xml 
81. 这个监听器 主要是 解析 endpoints ,
82.  delegate = createDelegate(adapters, context);
83.   context.setAttribute(WSServlet.JAXWS_RI_RUNTIME_INFO,delegate);
84.  这两行代码  把解析的 endpoint 结果 放入 session中 ,给后面的 WSServlet使用，
85.  下面是 
86. com.sun.xml.ws.transport.http.servlet.WSServlet 部分源代码.
88. public void init(ServletConfig servletConfig) throws ServletException {
            super.init(servletConfig);
            delegate = getDelegate(servletConfig);
        }
89. // 这个地方就是取出 上面监听器 解析sun-jaxws.xml 结果,
90. delegate  这个是 主要处理大部分逻辑的代码 ，是 WSServletDelegate类
91. 看 WSServelt 的doPost方法，将会调用
92. protected void doPost( HttpServletRequest request, HttpServletResponse response) throws ServletException {
            if (delegate != null) {
                delegate.doPost(request,response,getServletContext());
            }
        }
93. 这里便会访问到 WSServletDelegate 的doPost方法
94.  ServletAdapter target = getTarget(request);
                if (target != null) {
                    if (logger.isLoggable(Level.FINEST)) {
                        logger.finest(
                            WsservletMessages.SERVLET_TRACE_GOT_REQUEST_FOR_ENDPOINT(target.name));
                    }
                    target.handle(context, request, response);
                } else {
                    Localizer localizer = getLocalizerFor(request);
                    writeNotFoundErrorPage(localizer, response, "Invalid Request");
    }
95. 这部分代码 开始处理请求 并且生成WSDL服务
96. 当tomcat启动成功后 在浏览器中输入
97. http://localhost:8080/jaxws2/quick?wsdl
98. 将会显示 WSDL xml服务结果.

109. <definitions targetNamespace="http://ws.birds.com/" name="HelloQuickService">
110. −
111.     <types>
112. −
113.     <xsd:schema>
114. <xsd:import namespace="http://ws.birds.com/" schemaLocation="http://localhost:8080/jaxws2/quick?xsd=1"/>
115. xsd:schema>
116. types>
117. −
118.     <message name="show">
119. <part name="parameters" element="tns:show"/>
120. message>
121. −
122.     <message name="showResponse">
123. <part name="parameters" element="tns:showResponse"/>
124. message>
125. −
126.     <portType name="HelloQuick">
127. −
128.     <operation name="show">
129. <input message="tns:show"/>
130. <output message="tns:showResponse"/>
131. operation>
132. portType>
133. −
134.     <binding name="HelloQuickPortBinding" type="tns:HelloQuick">
135. <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
136. −
137.     <operation name="show">
138. <soap:operation soapAction=""/>
139. −
140.     <input>
141. <soap:body use="literal"/>
142. input>
143. −
144.     <output>
145. <soap:body use="literal"/>
146. output>
147. operation>
148. binding>
150.     <service name="HelloQuickService">
152.     <port name="HelloQuickPort" binding="tns:HelloQuickPortBinding">
153. <soap:address location="http://localhost:8080/jaxws2/quick"/>
154. port>
155. service>
156. definitions>

            上面的tomcat 6.0可能启动有错误 ，，这个需要把jax-ws 需要的几个包复制到 tomcat6.0/endorsed 目录下，这个目录原本没有，需要自己创建，主要是覆盖java虚拟机默认的 加载jaxb-api.jar ,

可以看看 http://java.sun.com/j2se/1.5.0/docs/guide/standards/index.html ，

如果不是用tomcat做服务发布的话， 用普通的java命令的话 需要在java安装目录下 建立 这个endorsed目录,把jar包放到下面，

jdk1.5 把叫做 " Endorsed Standards Override Mechanism ".

// 下面是 客户端代码 ，用来调用创建好的服务

// 用 jdk提供的 wsimport 的命令 来生成 对应的客户端服务代码，，也可以自己编写，如果你很清楚 jax-ws的机制。

wsimport -p com.birds.ws.myclient.HelloServices http://localhost:8080/jaxws2/quick?wsdl

-p 选项是 可以帮你生成包名. 

 生成了六个文件

HelloQuick.class, HelloQuickService.class,ObjectFactory.class,package-info.class

Show.class, ShowResponse.class

如果想看到源代码 可以加上 -keep 选项，

以上就可以方面的创建 客户端服务代码，不用自己手工编写 
下面就很容易的调用。
public static void main(String[] args) {HelloQuickService HelloQuickService = new HelloQuickService();HelloQuick quick = HelloQuickService.getHelloQuickPort();System.out.println(quick.show());}
这样就是一个简单的jax-ws 应用。
 
 
=========================================
http://piggy.iteye.com/blog/322585
前面一篇《jbossws快速入门》指出，使用jax-ws开发web service难度大大减低。本文再以Metro为示例，写一个简短的教程。




注：Metro，是GlassFish服务器的子项目，大家可以浏览jax-ws参考实现了解更多的信息。




Web Service EndPoint 



Java代码 
 
package helloservice;      
     
@javax.jws.WebService(      
        serviceName="HelloService",       
        name="Hello",      
        targetNamespace="http://www.jboss.org/example")      
public class HelloBean {   
    private String message = new String("Hello, ");      
     
    @javax.jws.WebMethod      
    public String sayHello(String name) {      
        return message + name + ".";      
    }      
}    
package helloservice;   @javax.jws.WebService(   serviceName="HelloService",    name="Hello",   targetNamespace="http://www.jboss.org/example")   
public class HelloBean {private String message = new String("Hello, ");   @javax.jws.WebMethod   public String sayHello(String name) {   return message + name + ".";   }   
}  





Deploy Web Service 



在部署文件web.xml里加入监听器及适配器。 

Xml代码 
 
<listener>  
    <listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListenerlistener-class>  
listener>  
<servlet>  
    <servlet-name>HelloServiceservlet-name>  
    <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServletservlet-class>  
servlet>  
<servlet-mapping>  
    <servlet-name>HelloServiceservlet-name>  
    <url-pattern>/hellourl-pattern>  
servlet-mapping>  
com.sun.xml.ws.transport.http.servlet.WSServletContextListener

HelloServicecom.sun.xml.ws.transport.http.servlet.WSServlet

HelloService/hello






还需要在部署文件sun-jaxws.xml描述EndPoint。 

Xml代码 
 
xml version="1.0" encoding="UTF-8"?>  
<endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime' version='2.0'>  
  <endpoint  
    name='HelloService'  
    implementation='helloservice.HelloBean'  
    url-pattern='/hello'/>  
endpoints>  








如果没有配置，无法使用/hello进行访问，但可以用HelloService?wsdl进行访问到，这是适配器的作用。

本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！