JDK1.6新特性,WebService强化
Web service是一个平台独立的,松耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML标准来描述、发布、发现、协调和配置这些应用程序,用于开发分布式的互操作的应用程序。
Web services涉及技术:
- XML XML是在web上传送结构化数据的伟大方式,Web services要以一种可靠的自动的方式操作数据,HTML不会满足要求,而XML可以使web services十分方便的处理数据,它的内容与表示的分离十分理想
- SOAP 即Simple Object Access Protocol,SOAP使用XML消息调用远程方法,这样web services可以通过HTTP协议的post和get方法与远程机器交互,而且,SOAP更加健壮和灵活易用。
- WSDL Web Service描述语言WSDL 就是用机器能阅读的方式提供的一个正式描述文档而基于XML的语言,用于描述Web Service及其函数、参数和返回值。因为是基于XML的,所以WSDL既是机器可阅读的,又是人可阅读的。
Mustang 简化了Web services 的开发和发布。XML和Web服务一直都是Mustang的关注重点。Mustang为此引入了JAX-WS(Java Architecture for XML-Web Services) 2.0 以及JAXB(Java Architecture for XML Binding) 2.0。 同时还有Streaming API for XML (STaX), 它提供了一个双向API,这个API可以通过一个事件流来读取或者写入XML,其中包括跳过某个部分,然后直接关注与文档中的另外一个小部分的能力。
JAVA中有三种WebService规范:
- JAX-WS(Java API For XML-WebService),JDK1.6 自带的版本为JAX-WS2.1,其底层支持为JAXB。早期的JAVA Web服务规范JAX-RPC(Java API ForXML-Remote Procedure Call)目前已经被JAX-WS 规范取代,JAX-WS 是JAX-RPC 的演进版本,但JAX-WS 并不完全向后兼容JAX-RPC。
- JAXM(JAVA API For XML Message),主要定义了包含了发送和接收消息所需的API,相当于Web 服务的服务器端,其API 位于javax.messaging.*包,它是JAVA EE 的可选包,因此你需要单独下载。SAAJ(SOAP With Attachment API For Java,JSR 67)是与JAXM 搭配使用的API,为构建SOAP 包和解析SOAP 包提供了重要的支持,支持附件传输,它在服务器端、客户端都需要使用。
- JAX-RS,是JAVA 针对REST(Representation State Transfer)风格制定的一套Web 服务规范,由于推出的较晚,该规范(JSR 311,目前JAX-RS 的版本为1.0)并未随JDK1.6 一起发行,你需要到JCP 上单独下载JAX-RS 规范的接口,其API 位于javax.ws.rs.*包。
目前Java环境中开发WebService主要有三种方法:
- Axis2,Axis是apache下一个开源的webservice开发组件,出现的算是比较早了,也比较成熟。这里主要介绍Axis+eclipse开发webservice,当然不用eclipse也可以开发和发布webservice,只是用eclipse会比较方便。
- Apche CXF,CXF开发webservice也是比较方便和简单的,它和spring的集成可以说是非常地好。
- JDK1.6自带的JAX-WS规范。
下面是一个用JDK1.6自带的JAX-WS规范开发的一个Hello World级别的WebService示范(环境:Eclipse):
1. 创建WebService服务
主程序:
package com.clzhang.sample.thinking; import java.text.SimpleDateFormat; import java.util.Date; import javax.jws.WebService; import javax.xml.ws.Endpoint; /** * 第1步,创建WebService服务,包含所需要的实体(Entity)等; * 第2步,利用wsimport命令生成客户端存根; * 第3步,创建WebService客户端主程序,通过客户端存根调用WebService。 * @author acer * */ @WebService public class JDK16WSServer1 { // 简单的一个参数in、一个参数out调用 public String sayHello(String greeting) { System.out.println("greeting is:" + greeting); return "I got " + greeting; } // 稍复杂的小计算,返回一个实体 public JDK16WSEntity getEntity(String name, int age, Date birthday) { JDK16WSEntity entity = new JDK16WSEntity(); entity.setAge(age); entity.setName(name); entity.setBirthday(birthday); entity.setDesc("您的姓名:" + name + ",年龄:" + age + "出生于:" + new SimpleDateFormat("yyyy-MM-dd").format(birthday)); return entity; } public static void main(String[] args) { Endpoint.publish("http://localhost:8888/service", new JDK16WSServer1()); System.out.println("WebService Server started..."); } }
实体类:
package com.clzhang.sample.thinking; import java.util.*; import javax.xml.bind.annotation.XmlRootElement; @XmlRootElement public class JDK16WSEntity { private int age; private String name; private Date birthday; private String desc; public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public String getDesc() { return desc; } public void setDesc(String desc) { this.desc = desc; } @Override public String toString() { return age + "|" + name + "|" + birthday; } }
创建完成之后,请运行主程序:JDK16WSServer1,以启动WebService服务。
2. 利用wsimport命令生成客户端代码存根
打开IE游览器,输入地址:http://localhost:8888/service?wsdl,即可以看到调用接口。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
<?xml version="1.0" encoding="UTF-8"?><!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.4-b01. --><!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.4-b01. --><definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://thinking.sample.clzhang.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://thinking.sample.clzhang.com/" name="JDK16WSServer1Service"> <types> <xsd:schema> <xsd:import namespace="http://thinking.sample.clzhang.com/" schemaLocation="http://localhost:8888/service?xsd=1"></xsd:import> </xsd:schema> </types> <message name="sayHello"> <part name="parameters" element="tns:sayHello"></part> </message> <message name="sayHelloResponse"> <part name="parameters" element="tns:sayHelloResponse"></part> </message> <message name="getEntity"> <part name="parameters" element="tns:getEntity"></part> </message> <message name="getEntityResponse"> <part name="parameters" element="tns:getEntityResponse"></part> </message> <portType name="JDK16WSServer1"> <operation name="sayHello"> <input wsam:Action="http://thinking.sample.clzhang.com/JDK16WSServer1/sayHelloRequest" message="tns:sayHello"></input> <output wsam:Action="http://thinking.sample.clzhang.com/JDK16WSServer1/sayHelloResponse" message="tns:sayHelloResponse"></output> </operation> <operation name="getEntity"> <input wsam:Action="http://thinking.sample.clzhang.com/JDK16WSServer1/getEntityRequest" message="tns:getEntity"></input> <output wsam:Action="http://thinking.sample.clzhang.com/JDK16WSServer1/getEntityResponse" message="tns:getEntityResponse"></output> </operation> </portType> <binding name="JDK16WSServer1PortBinding" type="tns:JDK16WSServer1"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"></soap:binding> <operation name="sayHello"> <soap:operation soapAction=""></soap:operation> <input> <soap:body use="literal"></soap:body> </input> <output> <soap:body use="literal"></soap:body> </output> </operation> <operation name="getEntity"> <soap:operation soapAction=""></soap:operation> <input> <soap:body use="literal"></soap:body> </input> <output> <soap:body use="literal"></soap:body> </output> </operation> </binding> <service name="JDK16WSServer1Service"> <port name="JDK16WSServer1Port" binding="tns:JDK16WSServer1PortBinding"> <soap:address location="http://localhost:8888/service"></soap:address> </port> </service> </definitions>
打开一个DOS窗口,输入(需要将jdk1.6.x/bin目录包括到path环境变量中):
wsimport -s d:\tddownload -d d:\tddownload -p com.clzhang.sample.thinking.client http://localhost:8888/service?wsdl
命令参数说明:
-d:生成客户端执行类的class文件的存放目录
-s:生成客户端执行类的源文件的存放目录
-p:定义生成类的包名
然后拷贝client目录以自己项目的目录。我这里的目录结构如下图所示:
服务主程序(JDK16WSServer1.java)、实体类(JDK16WSEntity.java)、客户端调用程序(JDK16WSClient1.java)存放于thinking目录下;
客户端代码存根存放于停刊thinking/client目录下。
3. 创建客户端主程序调用
package com.clzhang.sample.thinking; import java.util.*; import java.text.SimpleDateFormat; import javax.xml.datatype.DatatypeFactory; import javax.xml.datatype.XMLGregorianCalendar; import com.clzhang.sample.thinking.client.JDK16WSServer1; import com.clzhang.sample.thinking.client.JDK16WSServer1Service; import com.clzhang.sample.thinking.client.Jdk16WSEntity; public class JDK16WSClient1 { public static void main(String[] args) throws Exception { JDK16WSServer1Service jwss = new JDK16WSServer1Service(); JDK16WSServer1 jws = jwss.getJDK16WSServer1Port(); String returnGreeting = jws.sayHello("How are you?"); System.out.println(returnGreeting);
// 字符串日期-》日期(java.util.Date)-》GregorianCalendar-》XMLGregorianCalendar SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); GregorianCalendar gCal = new GregorianCalendar(); gCal.setTime(sdf.parse("1980-4-3")); XMLGregorianCalendar xmlCal = DatatypeFactory.newInstance().newXMLGregorianCalendar(gCal); Jdk16WSEntity entity = jws.getEntity("张三", 23, xmlCal); System.out.println(entity.getDesc());
// XMLGregorianCalendar-》GregorianCalendar-》日期(java.util.Date)-》字符串日期 System.out.println(sdf.format(entity.getBirthday().toGregorianCalendar().getTime())); } }
注意,程序中用到了XMLGregorianCalendar、GregorianCalendar、java.util.Date、字符串日期的互相转换。运行客户端主程序。
客户端输出:
I got How are you? 您的姓名:张三,年龄:23出生于:1980-04-03 1980-04-03
服务端输出:
WebService Server started...
greeting is:How are you?
4. 如何把WebService发布到tomcat服务器?
把WebService发布到tomcat服务器并没有好的方法。折中的方法是,通过一个自启动Servlet,在Servlet初始化阶段,注册WebService服务。
4.1 创建Servlet
package com.clzhang.sample.thinking; import java.io.IOException; import javax.servlet.GenericServlet; import javax.servlet.ServletConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.xml.ws.Endpoint; public class JDK16WSServlet extends GenericServlet { private static final long serialVersionUID = 1L; @Override public void init(ServletConfig servletConfig) throws ServletException { super.init(servletConfig); Endpoint.publish("http://localhost:8888/service", new JDK16WSServer1()); System.out.println("WebService Server started..."); } public void service(ServletRequest servletRequest, ServletResponse servletResponse) throws ServletException, IOException { servletResponse.getWriter().println("<a href=\"http://localhost:8888/service?wsdl\">WSDL</a>"); } }
4.2 修改web.xml
<servlet> <servlet-name>WSServlet</servlet-name> <servlet-class>com.clzhang.sample.thinking.JDK16WSServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>WSServlet</servlet-name> <url-pattern>/servlet/WSServlet</url-pattern> </servlet-mapping>
4.3 启动Tomcat
打开IE访问:http://localhost:8888/service?wsdl,即可以访问WSDL。客户端程序也可以运行。
关于JDK1.6新特性暂时到这儿,更多信息参考:更多信息,参考:http://www.oracle.com/technetwork/java/javase/features-141434.html