JDK1.6使用注解轻松开发Web服务

       在项目中使用使用Ws服务，同时采用JDK1.6于是学习一下JDK1.6发布Web服务的应用开发、发现使用JDK1.6注解ws方便简单。

    对Webservice的支持是JavaSE6的一大新特性。我们知道，想要发布一个Webservice，首先要创建相关的业务逻辑类，然后把这些业务逻辑类部署到SOAP服务器上，生成客户端访问的代码，最后部署到客户端进行测试。这是创建一个简单Webservice的主要步骤，事实上，部署和发布Webservice要复杂的多。而JavaSE6中实现了一个内置的轻量级SOAP服务器，我们可以把Webservice部署到Java平台中，并进行简单的测试。另外，JavaSE 6中加入了@Webservice等注解(Annotation)，有了这些注解，创建Webservice变得十分简单。本实验将在JavaSE 6中创建和发布一个Webservice，并通过Netbeans创建Webservice客户端对已发布的Service进行测试，通过实验来理解JavaSE 6对Webservice的支持。

软件需求：
jdk 1.6以上版本

 

下面首先看看web服务的代码，然后讲解web服务的各种信息和注意事项；

^_^

 

开发的代码如下：

定义web服务的接口类

package cn.com.unutrip.spring.ws;

import javax.jws.WebService;
/**
 *
 * 此接口定义Web服务
 * JDK1.6注解开发Ws服务
 * @author longgangbai
 *
 */
public interface IRemoteService {
 public String hello(String username);
}

 

web服务的实现类：

 

package cn.com.unutrip.spring.ws;

import java.util.Date;

import javax.jws.Oneway;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.soap.SOAPBinding;
/**
 *
 *
 * JDK1.6注解开发Ws服务
 * @author longgangbai
 *
 */

@WebService(serviceName = "REMOTESERVICE", targetNamespace = "http://cn.unutrip.com/RemoteService")
@SOAPBinding(style = SOAPBinding.Style.RPC)//默认的方式
public class RemoteServiceImpl implements IRemoteService {

/**

*

*

*/

 

 

 @WebResult(name = "Greetings")//注解返回的结果信息，可以使用默认值
 @WebMethod  //注解web服务的方法
 public String hello(@WebParam(name = "MyName")
 String name) {
  return "Hello," + name;
 }

 

 

 @Oneway  //没有返回值
 @WebMethod(action = "printSystemTime", operationName = "printSystemTime")
 public void printTime() {
  System.out.println(new Date(System.currentTimeMillis()));
 }

}

 

web服务的发布：

 

package cn.com.unutrip.spring.ws;

import javax.xml.ws.Endpoint;

/**
 *
 *
 * JDK1.6注解开发Ws服务
 *
 * @author longgangbai
 *
 */
public class WSPublish {
 public static void main(String[] args) {
  Thread wsPublisher = new Thread(new WebServicePublish());
  wsPublisher.start();
 }

 private static class WebServicePublish implements Runnable {
  public void run() {

//发布web发Endpoint发布
   Endpoint.publish("http://localhost:8888/HelloService",
     new RemoteServiceImpl());
  }
 }
}

 

访问路径如下：http://localhost:8888/HelloService?WSDL

访问的WSDL如下：

<?xml version="1.0" encoding="UTF-8" ?>

- < definitions xmlns =" http://schemas.xmlsoap.org/wsdl/ " xmlns:tns =" http://cn.unutrip.com/RemoteService " xmlns:xsd =" http://www.w3.org/2001/XMLSchema " xmlns:soap =" http://schemas.xmlsoap.org/wsdl/soap/ " targetNamespace =" http://cn.unutrip.com/RemoteService " name =" REMOTESERVICE ">

  < types />

- < message name =" hello ">

  < part name =" MyName " type =" xsd:string " />

  </ message >

- < message name =" helloResponse ">

  < part name =" Greetings " type =" xsd:string " />

  </ message >

  < message name =" printSystemTime " />

- < portType name =" RemoteServiceImpl ">

- < operation name =" hello " parameterOrder =" MyName ">

  < input message =" tns:hello " />

  < output message =" tns:helloResponse " />

  </ operation >

- < operation name =" printSystemTime ">

  < input message =" tns:printSystemTime " />

  </ operation >

  </ portType >

- < binding name =" RemoteServiceImplPortBinding " type =" tns:RemoteServiceImpl ">

  < soap:binding style =" rpc " transport =" http://schemas.xmlsoap.org/soap/http " />

- < operation name =" hello ">

  < soap:operation soapAction ="" />

- < input >

  < soap:body use =" literal " namespace =" http://cn.unutrip.com/RemoteService " />

  </ input >

- < output >

  < soap:body use =" literal " namespace =" http://cn.unutrip.com/RemoteService " />

  </ output >

  </ operation >

- < operation name =" printSystemTime ">

  < soap:operation soapAction =" printSystemTime " />

- < input >

  < soap:body use =" literal " namespace =" http://cn.unutrip.com/RemoteService " />

  </ input >

  </ operation >

  </ binding >

- < service name =" REMOTESERVICE ">

- < port name =" RemoteServiceImplPort " binding =" tns:RemoteServiceImplPortBinding ">

  < soap:address location =" http://localhost:8888/HelloService " />

  </ port >

  </ service >

  </ definitions >

 

 

讲解：

注意代码中使用到的几个Annotation：

@WebService注解将 Java 类标记为实现Web Service类，或者将Java接口标记为定义Web Service接口，其中serviceName属性指定了Web Service的服务名称，当映射到WSDL时，此名称被用作 此名称被用作 wsdl:service 的名称。这一个注解对应的是javax.jws.WebService，我们可以在jdk1.6的API文档里查看到所有的属性和用法。

 

@WebResult指定Web Service返回的值和WSDL之间的映射。@WebMethod指定了Web Service中要暴露的方法。标记了@WebMethod的方法可以通过Web Service客户端来远程调用(RPC)。

 

@WebParam注解用来向Web Service传递参数的。注意，@WebMethod标注的方法必须带有返回类型，除非同时标注了@Oneway。

 

◎WebResult：注解放值的可以设置默认值的。如实例中。

注意使用Endpoint发布web服务信息。