WebService：JDK发布service
那么如何才可以发布一个WebService呢？
在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。
JAX-WS是指Java Api for XML – WebService.
- 用Jdk1.6.0_21以后的版本发布一个WebService服务.
- 与Web服务相关的类，都位于javax.jws.*包中。
- 主要类有：
- @WebService － 它是一个注解，用在类上指定将此类发布成一个ws.
- Endpoint – 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。
- 主要类有：
JAX(Java Api for Xml)-WS规范是一组XML webservices的JAVA API。JAX-WS允许开发者可以选择RPC-oriented或者message-oriented 来实现自己的web services。
在JAX-WS中，一个远程调用可以转换为一个基于XML的协议例如SOAP。在使用JAX-WS过程中，开发者不需要编写任何生成和处理SOAP消息的代码。JAX-WS的运行时实现会将这些API的调用转换成为对应的SOAP消息。
在服务器端，用户只需要通过Java语言定义远程调用所需要实现的接口SEI （service endpoint interface），并提供相关的实现，通过调用JAX-WS的服务发布接口就可以将其发布为WebService接口。
在客户端，用户可以通过JAX-WS的API创建一个代理（用本地对象来替代远程的服务）来实现对于远程服务器端的调用。
当然JAX-WS 也提供了一组针对底层消息进行操作的API调用，你可以通过Dispatch 直接使用SOAP消息或XML消息发送请求或者使用Provider处理SOAP或XML消息。
通过web service所提供的互操作环境，我们可以用JAX-WS轻松实现JAVA平台与其他编程环境（.net等）的互操作。
JAX-WS与JAX-RPC之间的关系
Sun最开始的web services的实现是JAX-RPC 1.1 (JSR 101)。这个实现是基于Java的RPC,并不完全支持schema规范，同时没有对Binding和Parsing定义标准的实现。
JAX-WS2.0 (JSR 224)是Sun新的web services协议栈，是一个完全基于标准的实现。在binding层，使用的是the Java Architecture for XML Binding (JAXB, JSR 222)，在parsing层，使用的是theStreaming API for XML (StAX, JSR 173)，同时它还完全支持schema规范。
1:需要注意的是,jdk1.6._07以后jdk版本发布WebService时必须要完整的对代码进行注解,如果使用的是jdk1.6.0_21以后版本,因为它已经内含了ws2.1所以,可以只对类添加@WebService的注解.
以下是两段不同的代码:
在jdk1.6.0_13的版本上发布的ws:
packagecom.itcast;
import javax.jws.WebMethod;
importjavax.jws.WebService;
importjavax.jws.soap.SOAPBinding;
importjavax.jws.soap.SOAPBinding.Style;
importjavax.xml.ws.Endpoint;
@WebService(targetNamespace="http://loalhost:9999/helloworld")
@SOAPBinding(style=Style.RPC)//只支持RPC的消息风格
public classHelloWorld {
//以下通过@WebMethod注解,对外公开方法
@WebMethod
publicString sayHello(){
return"HelloWorld";
}
public staticvoid main(String[] args) {
Endpoint.publish("http://localhost:9999/helloworld",newHelloWorld());
}
}
2:以下是在jdk1.6.0_24上发布的WebService代码:
packagecom.itcast;
importjavax.jws.WebService;
importjavax.xml.ws.Endpoint;
@WebService//注意只有此一个注解,此注解也是必须的,默认的SOAP消息风格为:DOCUMENT
public classHelloWorld {
publicString sayHello(){
return"HelloWorld";
}
public staticvoid main(String[] args) {
Endpoint.publish("http://localhost:9999/helloworld",newHelloWorld());
}
}
发布一个Webservice的详细步骤及注意事项
l １、在类上添加@WebService注解。
• 这是jdk1.6提供的一个注解。它位于：javax.jws.*包中。
l ２、通过EndPoint(端点服务)发布一个webService。
• Endpoint也是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。
• static Endpoint.publish(String address,Object implementor)
在给定地址处针对指定的实现者对象创建并发布端点。
• stop方法用于停止服务。
• EndPoint发布完成服务以后，将会独立的线程运行。所以，publish之后的代码，可以正常执行。
l 其他注意事项：
• 给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。
• 不支持静态方法，final方法。－
• 如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开。
• 如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。
例子：
package cn.leaf.two;
import java.util.Date;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;
/**
* 发布第一个web服务
*@author 熊诗言
*/
@WebService
public class OneService{
//以下方法由于是final的，所以不会对外公开
publicfinal String sayHi(String name){
returnname+",你好，现在时间是:"+new Date();
}
//通过exclude=true,设置在发布时不包含此方法
@WebMethod(exclude=true)
publicString sayHi1(String name){
returnname+",你好，现在时间是:"+new Date();
}
publicString sayHi2(String name){
returnname+",你好，现在时间是:"+new Date();
}
publicstatic void main(String[] args) throws Exception{
//发布服务，地址也必须是真实的地址
Endpointend = Endpoint.publish("http://127.0.0.1:9999/one",newOneService());
System.out.println(“服务发布成功”);
Thread.sleep(2000);
end.stop();
}
}
客户端的操作：服务发布成功后
l 在地址栏输入(注意后面的参数?wsdl)
• http://127.0.0.1:9999/helloworld?wsdl
l 目前不是访问webService,只是获取一个用于描述WebService的说明文件,即:wsdl文件.
l wsdl- WebService Description Language,是以XML文件形式来描述WebService的”说明书”,有了说明书,我们才可以知道如何使用或是调用这个服务.
说明书看不懂怎么办？别急JDK能看懂：
wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要.
wsimport.exe位于JAVA_HOME\bin目录下.
常用参数为:
-d<目录> - 将生成.class文件。默认参数。
-s<目录> - 将生成.java文件。
-p<生成的新包名> -将生成的类，放于指定的包下。
(wsdlurl) - http://server:port/service?wsdl，必须的参数。
示例：
C:/> wsimport –s . http://192.168.0.100/one?wsdl
注意：-s不能分开，-s后面有个小点，用于指定源代码生成的目录。点即当前目录。
如果使用了-s参数则会在目录下生成两份代码，一份为.class代码。一份为.java代码。
.class代码，可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。
/**
* 通过调用生成的类,来调用远程代码，必须要对照WSDL文件找到应该如何调用！
*/
