本文根据SUN官方网站Enterprise Java Technologies Tech Tips栏目上的一篇文章改写的,所有过程均调试通过。
一.前言
SOA思想的核心在于"S",凡是从服务的角度去看待系统功能,并且构建和实现应用,都可以认为是SOA的某种实现形式。下面一段要说的是:SOA技术的核心在于"O"--只有做到Service-Orientation的技术,才能真正称为SOA技术。
怎样才能算作Service-Orientation?我们再以OO进行类比:VB之所以被称为基于对象(Object-Based)而不是面向对象(Object-Oriented)的语言,是因为VB的运行时结构不具有VMT等基本构造,语法上也不支持私有成员,继承等基础特性,两者结合,就造成无法支持封装,继承,多态等面向对象的关键技术。一句话,VB不是围绕“对象”这个核心概念设计的语言。对于SOA技术,它也可以从这个角度划分两个层次:一个是SOA的“运行时”相关结构标准,例如SOAP,WSDL,WS-*等,相当于OO中的对象内部结构,VMT构造等。另外一个则是语言和工具层面的支持,例如基于元数据的服务描述,支持Web Service的类库,Proxy生成工具等,相当于OO语言中提供的基本OO语法,类库,编绎器等。这两个层次共同构成SOA体系结构中的要素,让人们能够围绕“服务”这个核心概念进行系统开发和应用。因此,一种技术架构,平台或产品要称作SOA,应当同时具备这一两方面的特征。
所以,下面将要讨论的JAX-WS技术,从上面的观点来看,也就是SOA技术的第二个层次,即语言和工具层面的支持--Java,例如基于元数据的服务描述,支持Web Service的类库,Proxy生成工具等.
Java API for XML Web Services(JAX-WS)2.0,是Java EE 5平台的一个重要的部分。作为Java API for XML-baseed RPC 1.1(JAX-RPC)的后续版本,在JAX-RPC 1.1中,开发人员需要写一个接口类Service Endpoint Interface(SEI),在JAX-WS 2.0中,开发人员一上来就可以直接写自己的实现类. 通过使用annotations,自动生成SEI和其他一些文件.这样有助于开发人员专注于自己想开发的部分,而不必要地分散精力去维护其他的一些附属文件.
二.快速实践JAX-WS2.0
下面通过一个两个数相加的简单例子来看看,JAX-WS 2.0 API的应用过程.程序是一个独立的客户端传给服务端两个整数,经过服务端处理后,将结果返回到客户端并打印出来.
一. 环境配置.
1. JDK 5.0 or higher
下载: http://java.sun.com/javase/downloads/index.jsp
2. Java EE 5.0 App Server.
这个例子是基于Java EE 5的一个开源实现项目GlassFish。https://glassfish.dev.java.net/public/downloadsindex.html
本例子所需的基本代码的压缩包可以通过这个链接下载。里面包括了这个例子需要的代码,构建脚本和一个build文件。
环境变量的配置:
·
GLASSFISH_HOME.
这个应该指向你安装GlassFish的目录(比如,我系统上的是:J:\Sun\AppServer)
· ANT_HOME.
这个应该指向ant所安装的目录。在你下载GlassFish bundle时Ant已经被包含在里面了。(对于Windows系统,它是在lib\ant子目录)。不过你也可以从
Apache Ant Project page.下载Ant。对于这个例子需要Apache ant 1.6.5
· JAVA_HOME.
这个应该指向你系统上安装的JDK 5.0(or higher)的目录。
同时,把ant的bin目录添加到Path环境变量中去(J:\apache-ant-1.6.5\bin),当然了JDK的bin目录也加进去了。
然后下载例子的代码包并且解压。根文件夹是jaxws-techtip。
endpoint\
目录下有一个文件Calculator.java
client\
目录下有一个文件JAXWSClient.java
二.编写构建服务端
随着第一步环境配置的完全,现在该开始构建一个web服务了。在这个例子里,web服务是从一个Java类来开发的。为了构建这个web服务:
1.写一个端点实现类(endpoint implementation class)。
2.编绎这个端点实现类。
3.有选择的产生对web服务的运行必须具备的那些可移植的制品。
4.把web服务打包成一个WAR文件并且在App Server中部署它。
1 编写实现类.
进到endpoint\
目录下,可以看到里面有一个文件Calculator.java.它是一个端点实现类,具备有对两个整数进行相加的简单服务。
JAX-WS 2.0大量地依赖注释(annotations)的使用,它是A Metadata Facility for the Java Programming Language (JSR 175)描述的规范和Web Services Metadata for the Java Platform (JSR 181)描述的规范。
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/a41954a27d6ad96fa2c2cf816e677448.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/1327ab569c1ae82736693a50b8e33378.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/37c8bf68cdc3cc81759c34160776bc53.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/7ff8d92cded7e0ce15e7ca1acc870052.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/37c8bf68cdc3cc81759c34160776bc53.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/7ff8d92cded7e0ce15e7ca1acc870052.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6a9c071a08f1dae2d3e1c512000eef41.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/717446ca04a6125dc5b6b54e0fa14ab4.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/0196c3df5ea9e936f21e9932cca91014.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/6810355c2f78c12e91b7997a8e8c583a.gif)
研究上面的实现类Calculator
,注意到类里的两个注释的使用@WebService
跟@WebMethod。一个正确的端点实现类必须包含有一个@WebService注释。这个注释标注这个类将作为一个web服务对外开放。@WebService的name属性表明了web服务描述语言(WSDL)里的端口类型(
portType)(在这个例子里是”Calculator”)。而
serviceName="CalculatorService"对应的是一个WSDL里的服务元素(service)。targetNamespace属性为WSDL说明了XML的命名空间。所有的这些属性都是可选的。对于这些属性的默认值是什么,请参考Web Services Metadata for the Java Platform规范,JSR 181。
再来看看另外一个重要的注释@WebMethod,被它注释过的方法说明将它以一个
web服务的方法暴露出来,被其他应用来调用。
@WebMethod注释里的operationName
声明了WSDL里的一个元素WSDL operation(在这个例子里,”add”),另外一
个属性action =("urn:Add
"),它为WSDL还有一些从这个web服务操作(web service operation)生
成的元素声明了一个命名空间。这两个属性都是可选的。如果你没有列出来的
话,WSDL操作(operation)的值将会默认为方法名,还有action值也会默认为
服务的targetNamespace。
2
编绎实现类
写完了上面的实现类之后,你需要编绎它。点击 开始->程序->Sun Microsystems->“Start Default Server”启动应用服务器或者通过在DOS窗口下敲下面的命令来启动它:<GF_install_dir>\bin\asadmin start-domain domain1,其中GF_install_dir是你安装GlassFish的目录,也就是说先到<GF_install_dir>\bin目录下,然后用命令asadmin start-domain domain1来启动应用服务器。现在将目录转到jaxws-techtip文件夹下,运行下面的ant命令,也就是执行第一个任务complie:
ant compile
执行这个命令就相当于执行以下的javac命令(都是在同一行):
javac -classpath $GLASSFISH_HOME/lib/javaee.jar -d
./build/classes/service/ endpoint/Calculator.java
3 为web服务的执行产生可移植的制品
这一步是可选的。如果在这个web服务的部署期间,他们没有和一个可配置的服务单元绑定,GlassFish的部署工具能够自动地产生这些制品。然而对于刚刚接触JAX-WS来说,对于弄清楚整个编程模式来说,通过手动产生地会话会更有帮助,即运行下面的命令:
ant generate-runtime-artifacts
这个任务将会在jaxws-techtip目录下生成build/generated目录,并且运行了下面的wsgen命令(都是在同一行):
$GLASSFISH_HOME/bin/wsgen -cp ./build/classes/service -keep -d ./build/classes/service –r ./build/generated -wsdl endpoint.Calculator
一个WSDL文件(CalculatorService.wsdl)在build/generated目录下生成了,还在同个目录下生成了另外一个schema文件(CalculatorService_schema1.xsd),它为CalculatorService.wsdl定义了schema。
JavaBean技术组件(JavaBeans)在编组(marshaling,java->XML)的方法调用,响应,还有service-specific异常中起了很大的作用。这些类将会在web服务在一个应用服务器中运行的时候被使用。JavaBean类在jaxws-techtip目录下的 /build/classes/service/endpoint/jaxws目录被生成了,这些类是:
Add.java
Add.class
AddResponse.java
AddResponse.class
4 打包并部署WAR文件
接下来你需要做的工作就是对服务进行打包和部署。为了做这个,你需要在一个部署描述符中详细说明这个服务。Web服务可以绑定成servlet的形式或者无状态的session bean形式打包成Web Archive (WAR)文件。在这个例子里把它绑定为一个servlet。
为了把这个服务打包成一个WAR文件,定位到jaxws-techtip文件夹,并且在DOS窗口上运行下面的命令:
ant pkg-war
对于这个war文件的结构,我们可以到build.xml文件里看看pkg-war目标:
<targetname="pkg-war"depends="init-common">
<mkdirdir="${assemble.dir}"/>
<echomessage="mybuildclassesdiris:${build.classes.dir}"level="verbose"/>
<mkdirdir="${build.classes.dir}/tmp"/>
<mkdirdir="${build.classes.dir}/tmp/WEB-INF"/>
<mkdirdir="${build.classes.dir}/tmp/WEB-INF/classes"/>
<mkdirdir="${build.classes.dir}/tmp/WEB-INF/wsdl"/>
<copyfile="${web.xml}"
tofile="${build.classes.dir}/tmp/WEB-INF/web.xml"failonerror="false"/>
<copytodir="${build.classes.dir}/tmp/WEB-INF/classes">
<filesetdir="${build.classes.dir}/service">
<includename="**/*.class"/>
<includename="**/${handler.name}"/>
</fileset>
</copy>
<copytodir="${build.classes.dir}/tmp/WEB-INF/wsdl">
<filesetdir="${build.generated.dir}">
<includename="**/*.*"/>
</fileset>
</copy>
<echomessage="Creatingwarfile${assemble.dir}/${appname}-web.war"level="verbose"/>
<jarjarfile="${assemble.dir}/${appname}-web.war"update="true">
<filesetdir="${build.classes.dir}/tmp"casesensitive="yes">
<includename="**/*class*"/>
<includename="**/${handler.name}"/>
</fileset>
<filesetdir="${build.classes.dir}/tmp/"casesensitive="true">
<includename="WEB-INF/web.xml"/>
</fileset>
<filesetdir="${build.classes.dir}/tmp"casesensitive="yes">
<includename="WEB-INF/wsdl/*.*"/>
</fileset>
</jar>
<echomessage="createdwarfile${assemble.dir}/${appname}-web.war"level="verbose"/>
</