(二) wsdeploy工具 1 工具介紹
這個(gè)工具和wscompile協(xié)同工作來(lái)生成一個(gè)能在任何servlet容器中發(fā)布的war文件，它授受一個(gè)生WAR文件，它包括一個(gè)SEI,一個(gè)SEI實(shí)現,一些值類(lèi)型，一些服務(wù)特定的異常，一個(gè)model文件,一個(gè)部署描述符(jaxrpc-ri.xml), 和一些可選的其它實(shí)現特定的制品.工具處理生的war文件并生成一個(gè)實(shí)現特定的熟的war文件.這個(gè)過(guò)程包括生成串行化器，連接(TIEs),運行時(shí)描述符以及其它為了成功的發(fā)布WS需要的制品. 這個(gè)工具也有兩種使用形式:批處理和Ant構建腳本.
批的例子:
wsdeploy -o target.war myapp.war
Ant腳本,在A(yíng)nt中使用這個(gè)任務(wù)前要先定義：
<taskdef name="wsdeploy" classname="com.sun.xml.rpc.tools.ant.Wsdeploy">
<classpath path="${classpath}"/>
</taskdef>
其中的類(lèi)路徑指向同wscompile相同:
<wsdeploy classpath="xyz.jar" tmpdir="${tmp}" outWarFile="stock.war" inWarFile="stock-raw.war"/>
<wsdeploy keep="true" outWarFile="stock.war" inWarFile="stock-raw.war"><classpath refid="compile.classpath"/></wsdeploy>
<wsdeploy fork="true" source="1.0.3" outWarFile="stock.war" inWarFile="stock-raw.war"></wsdeploy>
2 wscompile的配置文件(部署描述符 jaxrpc-ri.xml)
它被打包在生的WAR文件中，并由wsdeploy工具使用來(lái)生成熟的WAR文件.這個(gè)描述符提供了wsdeploy工具向web容器中發(fā)布WS的信息.
該文件主要是使用endpoint和endpointMapping兩個(gè)元素來(lái)定義端點(diǎn)和服務(wù)影射,把SEI及其實(shí)現聚集在一起,連同model文件提供給發(fā)布工具.
三 編寫(xiě)一個(gè)Hello例子
IDE環(huán)境:Eclipse,插件sysdeo,發(fā)布環(huán)境:Tomcat559.
使用類(lèi)庫:Sun公司的參考實(shí)現.
本例要使用的材料: 1 HelloIF.java,一個(gè)SEI接口，它擴展了Remote接口.
2 HelloImpl.java，實(shí)現了SEI接口.
3 web.xml ,這個(gè)文件可以是你的任何Web應用的部署描述符文件,這個(gè)例子可以發(fā)布到你的現有Web應用,只需要把那個(gè)應用的部署描述符文件放在開(kāi)發(fā)環(huán)境的WEB-INF文件夾下.
4 config-interface.xml，描述SEI接口.
5 config-wsdl.xml，使用WSDL描述服務(wù)接口，本例不介紹這個(gè)文件的使用方法，通常這個(gè)使用場(chǎng)景多是為訪(fǎng)問(wèn)服務(wù)生成客戶(hù)端stub文件.另一個(gè)場(chǎng)景就是加入自定義的java類(lèi)型到SOAP類(lèi)型的影射等等很多細微的控制，或者是完全替代SEI接口.
以上文件的位置，可參看下圖:
1 編寫(xiě)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 實(shí)現SEI:
package helloservice;
public class HelloImpl implements HelloIF {
public String message ="Hello";
public String sayHello(String s) {
return message + s;
}
}
3 配置文件 config-interface.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="http://java.sun.com/xml/ns/jax-rpc/ri/config">
<service name="MyHelloService" targetNamespace="urn:Foo"
typeNamespace="urn:Foo" packageName="helloservice">
<interface name="helloservice.HelloIF"
servantName="helloservice.HelloImpl" />
</service>
</configuration>
4 構建服務(wù)，下面是一個(gè)Ant構建腳本.<?xml version="1.0" encoding="GBK"?>
<project name="webservice" default="build" basedir=".">
<property name="jaxrpc.lib.dir" value="D:\Sun\AppServer\lib">
</property>
<property name="classes.dir" value=".\build\classes">
</property>
<property name="src.dir" value=".\build\src">
</property>
<property name="war.file" value="hello_raw.war">
</property>
<property name="nonclass.dir" value=".\build\nonclass">
</property>
<property name="build" value="${nonclass.dir}">
</property>
<property name="assemble" value=".\assemble">
</property>
<property name="assemble.war" value=".\assemble\war">
</property>
<property name="assemble.ear" value=".\assemble\ear">
</property>
<path id="jaxrpc-classpath">
<fileset dir="${jaxrpc.lib.dir}">
<include name="**/*.jar" />
</fileset>
<fileset dir="D:\jdbc\postgresql">
<include name="*.jar" />
</fileset>
</path>
<path id="compile.classpath">
<fileset dir="${jaxrpc.lib.dir}">
<include name="**/*.jar" />
</fileset>
<fileset dir="D:\jwsdp-1.5\jaxrpc\lib">
<include name="**/*.jar" />
</fileset>
</path>
<taskdef name="wscompile" classpathref="jaxrpc-classpath" classname="com.sun.xml.rpc.tools.ant.Wscompile">
</taskdef>
<taskdef name="wsdeploy" classpathref="jaxrpc-classpath" classname="com.sun.xml.rpc.tools.ant.Wsdeploy">
</taskdef>
<target name="prepare">
<mkdir dir="${src.dir}" />
<mkdir dir="${nonclass.dir}" />
<mkdir dir="${classes.dir}" />
<mkdir dir="${assemble}" />
<mkdir dir="${assemble.war}" />
<mkdir dir="${assemble.ear}" />
</target>
<target name="build" depends="prepare" description="生成java制品,如生成可供wsdeploy使用的web檔案,稱(chēng)為生war,就象作菜一樣,先順菜,以及model,wsdl文件,這里生成的WSDL文件,wsdeploy并不使用">
<echo message="build the WAR...." />
<wscompile import="false" define="true" gen="false" keep="true" base="${classes.dir}" sourceBase="${src.dir}" classpath=".\classes" nonClassDir="${nonclass.dir}" model="model.xml.gz" xPrintStackTrace="true" config="config-interface.xml" verbose="true">
<classpath refid="compile.classpath" />
</wscompile>
</target>
<target name="deploy" description="生成可供發(fā)布的web檔案,稱(chēng)為煮熟的war,這個(gè)階段也生成了WSDL文件并被直接打包了">
<echo message="deploy the WAR...." />
<wsdeploy keep="false" verbose="true" tmpDir=".\tmp" outWarFile="skysoft.war" inWarFile="hello_raw.war">
<classpath refid="compile.classpath" />
</wsdeploy>
</target>
<target name="create-war" description="打包由wscompile生成的制品,以及所有發(fā)布所用的材料">
<echo message="Creating the WAR...." />
<delete file="${assemble.war}/${war.file}" />
<delete dir="${assemble.war}/WEB-INF" />
<copy todir="${assemble.war}/WEB-INF/classes/">
<!--fileset dir="${build}/" includes="**/*.class" excludes="**/*Client.class, **/*.wsdl, **/*mapping.xml" /-->
<fileset dir="./classes" includes="**/*.class" excludes="**/*Client.class, **/*.wsdl, **/*mapping.xml" />
</copy>
<copy todir="${assemble.war}/WEB-INF/lib/">
<fileset dir="./lib" includes="**/*.jar" excludes="**/*Client.class, **/*.wsdl, **/*mapping.xml" />
</copy>
<copy file="jaxrpc-ri.xml" todir="${assemble.war}/WEB-INF" />
<copy file="model.xml.gz" todir="${assemble.war}/WEB-INF" />
<war destfile="${assemble.war}/${war.file}" webxml="./web.xml" filesonly="true">
<fileset dir="${assemble.war}" includes="WEB-INF/**, build/**" />
</war>
<copy file="${assemble.war}/${war.file}" todir="." />
</target>
<target name="genstaticstub" description="生成靜態(tài)樁,供靜態(tài)的調用服務(wù)">
<echo message="gen statics tub" />
<wscompile client="true" keep="true" base="." sourceBase="." xPrintStackTrace="true" config="config-wsdl.xml" verbose="true">
<classpath refid="compile.classpath" />
</wscompile>
</target>
<target name="generate-dynamic-interface" description="根據WSDL文件生成SEI及其它材料,供動(dòng)態(tài)調用">
<echo message="generate dynamic interface" />
<wscompile import="true" keep="true" features="norpcstructures" base="./dynmicstub" sourceBase="./dynmicstub" xPrintStackTrace="true" config="config-wsdl.xml" verbose="true">
<classpath refid="compile.classpath" />
</wscompile>
</target>
</project>
其中的各個(gè)任務(wù)都有說(shuō)明.
注意，如果你使用JAX-RPC1.1.2的話(huà)，wsdeploy生成web.xml文件有些小錯誤，需要手工更改，這個(gè)問(wèn)題在1.1.3中已經(jīng)修正.
好了，在Eclipse中運行各個(gè)任務(wù)，把最后得到的skysoft.war，作為一個(gè)新的應用發(fā)布，也可發(fā)布到你現有的應用，需要解壓這個(gè)文件，然后拷貝需要的文件以及庫文件到你的應用中即可.
(四) 調用服務(wù)
調用服務(wù)的方式有三種:靜態(tài)調用，動(dòng)態(tài)調用，動(dòng)態(tài)調用接口.
1 靜態(tài)調用，使用了wscompile生成的靜態(tài)樁文件.
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 動(dòng)態(tài)調用，主要是使用ServiceFactory來(lái)執行調用.
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();
}
}
}
3 動(dòng)態(tài)調用接口(DII),這種方式不需要任何附加代碼，根據WSDL提供的調用方法的元描述，動(dòng)態(tài)確定方法及其參數返回類(lèi)型，有些類(lèi)似于CORBA的接口池提供的服務(wù).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();
}
}
}
到此，這個(gè)Web Service入門(mén)描述就結束了，它提供了WS的Sun描述，以及在tomcat上發(fā)布服務(wù)的過(guò)程和一個(gè)構建腳本，借助jsp插件，使用Eclipse完成了一個(gè)簡(jiǎn)單的Web服務(wù)開(kāi)發(fā)，發(fā)布，并用三種方式進(jìn)行了測試.
