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,即可以看到调用接口。
<?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出生于:--
--
服务端输出:
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