使用JWSDP完成Web Service

　　Web Service在java领域，AXIS因其容易使用，很多项目都使用了它，对于Sun提供的Web Service技术，则不多使用，现更新有关版本，重新使用了一下Sun提供的JWSDP,并写了这篇入门.供需要者参考.

　　一 Sun公司的Web Service

　　Web服务是基于web的使用开放的基于xml标准的企业应用,是和调用客户端交换数据的传输协议，Java技术和WEB服务被组织成这些亚类:

  Java Web Services Developer Pack (Java WSDP) 
  Java API for XML-Based RPC (JAX-RPC) 
  Java API for XML Registries (JAXR) 
  Java API for XML Processing (JAXP) 
  Java Architecture for XML Binding (JAXB) 
  SOAP with Attachments API for Java (SAAJ) 
  XML and Web Services Security 

　　JAX-RPC代表基于xml远程过程调用的java API，是一项为构建使用RPC和XML的Web服务和客户端的技术，通常用于分布式的CS模式中，它是一种RPC机制能使客户端执行其他系统上的过程.

　　在JAX-RPC中，一个RPC由基于XML协议如SOAP表示，这个SOAP规范定义了一个信封结构，编码规则以及为代表远程调用和响应的协定.这些调用和响应作为SOAP消息在HTTP上传输.

　　尽管SOAP消息复杂,但JAX-RPC API向应用开发者隐藏了这些复杂性.在服务器端，开发者指定那个调用过程是通过用java语言写的接口定义的方法， 开发者还要编码一个或多个实现这些方法的类.客户端程序也容易编码:一个客户端创建一个代理(一个代表服务的本地对象)，然后简单的在那个代理上调用那个方法.使用JAX-RPC,开发者不用生成或分析SOAP消息，这是JAX-RPC运行时系统做的事情:它在来往的API调用和响应到SOAP消息之间进行转换.

　　二 SUN提供的WEB服务构建工具

　　J2EE提供了APIs和创建,发布可互操作WS和客户端的工具,其中JAX-RPC(SI)标准实现提供了wscompile 和 wsdeploy 工具,使你开发,发布,调用Web Service:

　　1  wscompile可接受两种输入:WSDL和Service Endpoint Interface,输出为可移植制品和model文件.

　　2  wsdeploy只有一种输入:包括wscompile输入和输出再加上一个部署描述符文件，输出是可发布的特定平台上的web service.

　　这些工具同Java WSDP一起打包可供使用,java web服务开发包是一个免费的集成工具箱,用它构建,测试,发布XML应用,web服务以及带有最新web服务技术和标准实现的web应用.

　　(一) wscompile工具

　　1 工具介绍

　　它生成由JAX-RPC运行时需要的各种客户端和服务端制品以供开发，部署，调用一个Web服务. 这个工具有两种使用形式:批处理和Ant构建脚本.

  wscompile -gen -classpath lib/foo.jar;lib/bar.jar -d generated config.xml
  wscompile -gen  -f:infix:Name -d generated config.xml
  wscompile -define -f:nodatabinding -f:novalidation config.xml
  wscompile -import -f:explicitcontext config.xml

　　Ant脚本,在Ant中使用这个任务前要先定义:

　　其中的类路径要指向以下档案库:

jaxrpc-api.jar
jaxrpc-impl.jar
jaxrpc-spi.jar
saaj-api.jar
saaj-impl.jar
jaxp-api.jar
dom.jar
sax.jar
xalan.jar
xercesImpl.jar
activation.jar
mail.jar
jax-qname.jar
namespace.jar
xsdlib.jar
relaxngDatatype.jar

　　例子:

　　1 工具介绍

　　这个工具和wscompile协同工作来生成一个能在任何servlet容器中发布的war文件，它授受一个生WAR文件，它包括一个SEI,一个SEI实现,一些值类型，一些服务特定的异常，一个model文件,一个部署描述符(jaxrpc-ri.xml), 和一些可选的其它实现特定的制品.工具处理生的war文件并生成一个实现特定的熟的war文件.这个过程包括生成串行化器，连接(TIEs),运行时描述符以及其它为了成功的发布WS需要的制品. 这个工具也有两种使用形式:批处理和Ant构建脚本.

　　批的例子:

wsdeploy -o target.war myapp.war
Ant脚本,在Ant中使用这个任务前要先定义：

   

其中的类路径指向同wscompile相同:

　　2 wscompile的配置文件(部署描述符 jaxrpc-ri.xml)

　　它被打包在生的WAR文件中，并由wsdeploy工具使用来生成熟的WAR文件.这个描述符提供了wsdeploy工具向web容器中发布WS的信息.

　　该文件主要是使用endpoint和endpointMapping两个元素来定义端点和服务影射,把SEI及其实现聚集在一起,连同model文件提供给发布工具.

　　三 编写一个Hello例子

　　IDE环境:Eclipse,插件sysdeo,发布环境:Tomcat559.

　　使用类库:Sun公司的参考实现.

　　1  HelloIF.java,一个SEI接口，它扩展了Remote接口.

　　2  HelloImpl.java，实现了SEI接口.

　　3  web.xml ,这个文件可以是你的任何Web应用的部署描述符文件,这个例子可以发布到你的现有Web应用,只需要把那个应用的部署描述符文件放在开发环境的WEB-INF文件夹下.

　　4  config-interface.xml，描述SEI接口.

　　5  config-wsdl.xml，使用WSDL描述服务接口，本例不介绍这个文件的使用方法，通常这个使用场景多是为访问服务生成客户端stub文件.另一个场景就是加入自定义的java类型到SOAP类型的影射等等很多细微的控制，或者是完全替代SEI接口.

　　以上文件的位置，可参看下图:

　　1　编写SEI,HelloIF:

package helloservice;
import java.rmi.Remote;
import java.rmi.RemoteException;
public interface HelloIF extends Remote {
    public String sayHello(String s) throws RemoteException;
}

　　2 实现SEI:

package helloservice;
public class HelloImpl implements HelloIF {
    public String message ="Hello";
    public String sayHello(String s) {
        return message + s;
    }
}

　　3 配置文件　config-interface.xml

   typeNamespace="urn:Foo" packageName="helloservice">
     servantName="helloservice.HelloImpl" />
 

　　其中的各个任务都有说明.

　　注意，如果你使用JAX-RPC1.1.2的话，wsdeploy生成web.xml文件有些小错误，需要手工更改，这个问题在1.1.3中已经修正.

　　好了，在Eclipse中运行各个任务，把最后得到的skysoft.war，作为一个新的应用发布，也可发布到你现有的应用，需要解压这个文件，然后拷贝需要的文件以及库文件到你的应用中即可.

　　(四)　调用服务

　　调用服务的方式有三种:静态调用，动态调用，动态调用接口.

　　1　静态调用，使用了wscompile生成的静态桩文件.

package hello;
import javax.xml.rpc.Stub;
import staticstub.*;
public class HelloClient {
 private String endpointAddress;
 public static void main(String[] args) {
  args=new String[]{"http://localhost:8080/skysoft/hello?WSDL"};
  System.out.println("Endpoint address = " + args[0]);
  try {
   Stub stub = createProxy();
   stub._setProperty(javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY,
     args[0]);
   HelloIF hello = (HelloIF) stub;
   System.out.println(hello.sayHello("Duke!"));
  } catch (Exception ex) {
   ex.printStackTrace();
  }
 }
 private static Stub createProxy() {
  // Note: MyHelloService_Impl is implementation-specific.
  return (Stub) (new MyHelloService_Impl().getHelloIFPort());
 }
}

　　2　动态调用，主要是使用ServiceFactory来执行调用.

package hello;
import java.net.URL;
import javax.xml.rpc.Service;
import javax.xml.rpc.JAXRPCException;
import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceFactory;
//import dynamicproxy.HelloIF;
import staticstub.HelloIF;
public class DynClient {
 public static void main(String[] args) {
  try {
   args = new String[] { "http://localhost:8080/skysoft/hello" };
   String UrlString = args[0] + "?WSDL";
   String nameSpaceUri = "urn:Foo";
   String serviceName = "MyHelloService";
   String portName = "HelloIFPort";
   System.out.println("UrlString = " + UrlString);
   URL helloWsdlUrl = new URL(UrlString);
   ServiceFactory serviceFactory = ServiceFactory.newInstance();
   Service helloService = serviceFactory.createService(helloWsdlUrl,
     new QName(nameSpaceUri, serviceName));
   HelloIF myProxy = (HelloIF) helloService.getPort(new QName(
     nameSpaceUri, portName), HelloIF.class);
   System.out.println(myProxy.sayHello("Buzz"));
  } catch (Exception ex) {
   ex.printStackTrace();
  }
 }
}

package hello;
import javax.xml.rpc.Call;
import javax.xml.rpc.Service;
import javax.xml.rpc.JAXRPCException;
import javax.xml.namespace.QName;
import javax.xml.rpc.ServiceFactory;
import javax.xml.rpc.ParameterMode;
public class DiiClient {
 private static String qnameService = "MyHelloService";
 private static String qnamePort = "HelloIF";
 private static String BODY_NAMESPACE_VALUE = "urn:Foo";
 private static String ENCODING_STYLE_PROPERTY = "javax.xml.rpc.encodingstyle.namespace.uri";
 private static String NS_XSD = "http://www.w3.org/2001/XMLSchema";
 private static String URI_ENCODING = "http://schemas.xmlsoap.org/soap/encoding/";
 public static void main(String[] args) {
  args=new String[]{"http://localhost:8080/skysoft/hello?WSDL"};
  System.out.println("Endpoint address dii = " + args[0]);
  try {
   ServiceFactory factory = ServiceFactory.newInstance();
   Service service = factory.createService(new QName(qnameService));
   QName port = new QName(qnamePort);
   Call call = service.createCall(port);
   call.setTargetEndpointAddress(args[0]);
   call.setProperty(Call.SOAPACTION_USE_PROPERTY, new Boolean(true));
   call.setProperty(Call.SOAPACTION_URI_PROPERTY, "");
   call.setProperty(ENCODING_STYLE_PROPERTY, URI_ENCODING);
   QName QNAME_TYPE_STRING = new QName(NS_XSD, "string");
   call.setReturnType(QNAME_TYPE_STRING);
   call.setOperationName(new QName(BODY_NAMESPACE_VALUE, "sayHello"));
   call.addParameter("String_1", QNAME_TYPE_STRING, ParameterMode.IN);
   String[] params = { "Murph!" };
   String result = (String) call.invoke(params);
   System.out.println(result);
  } catch (Exception ex) {
   ex.printStackTrace();
  }
 }
}

　　到此，这个Web Service入门描述就结束了，它提供了WS的Sun描述，以及在tomcat上发布服务的过程和一个构建脚本，借助jsp插件，使用Eclipse完成了一个简单的Web服务开发，发布，并用三种方式进行了测试.