WebService：JDK发布service

那么如何才可以发布一个WebService呢？

???????? 在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。

???JAX-WS是指Java Api for XML – WebService.

1. 用Jdk1.6.0_21以后的版本发布一个WebService服务.
2. 与Web服务相关的类，都位于javax.jws.*包中。
   1. 主要类有：
      1. @WebService － 它是一个注解，用在类上指定将此类发布成一个ws.
      2. 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_HOMEbin目录下.

常用参数为:

-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文件找到应该如何调用！

?

?*/