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

 

 */