论坛首页 Java企业应用论坛

感受野马(Mustang)性情,体会Java SE 6.0的新特性之二--Web服务

浏览 3182 次
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
   发表时间:2006-12-17  

在前一篇文章中,讲述了Java SE 6.0新特征的概观。本文将介绍Web服务。

Java Web 涉及到的JSR有 105,173,181,222,224,250。

由于Web服务日趋流行,利用Web服务的功能性的API特征正从最新的Java EE版本中向Java SE 6平台迁移。换言之,针对Web服务不需另外加入额外的工具,在Java EE和Java SE平台拥有相同的API。野马将大把不同的Web服务相关的API加到标准的工具柜中:以JSR 181针对Java 平台的Web服务元数据,通过JSR 224的基于XML 的Web服务Java API(JAX-WS);针对Java的带有附件的SOAP API(SAAJ)作为JSR 67

与三个Web服务API相关的包新增到Java SE 6.0里JAX-WS API 放置到javax.xml.ws包; SAAJ类在javax.xml.soap 包; Web服务的元数据类放置在javax.jws包里。

javax.jws

JSR 181 及其针对Java 平台Web服务元数据的规范提供一个在类中利用标注设计和开发Web服务的机制。标注从J2SE 5.0引入,在Java SE 6.0得到了进一步扩展。在第10章将会完整描述。但是,标注基本上允许将@tag加入到类,方法和特性来描述相关的元数据。一个解析器然后能定位标记并采取适当的行动;尽管行动什么时候发生完全依赖于标记自身。

JAX-WS 2.0 很容易使用. 本文将介绍如何使用Java SE 6。以JAX-WS如何建立一个简单的Web服务。首先建立一个建立一个将要作为Web服务发布的类,如表1所示:

<!---->

 

Java 代码 列表1
  1. package hello;   
  2.   
  3. public class CircleFunctions {   
  4.   
  5.    public double getArea(double radius) {   
  6.        return java.lang.Math.PI * (r * r);   
  7.     }   
  8.   
  9.    public double getCircumference(double radius) {   
  10.        return 2 * java.lang.Math.PI * r;   
  11.    }   
  12. }   
  13.   

 为了输出这些方法,必需做两件事情:引入javax.jws.WebService  包;在类的前面增加@WebService  标注以告诉Java编译器将发布此类为Web服务。下面的代码显示了这种变化(以黑体显示增加的代码)。

<!---->

Java 代码 列表2
  1. package hello;   
  2.   
  3. import javax.jws.WebService;   
  4.   
  5. @WebService  
  6.   
  7. public class CircleFunctions {   
  8.    public double getArea(double r) {   
  9.        return java.lang.Math.PI * (r * r);   
  10.     }   
  11.   
  12.    public double getCircumference(double r) {   
  13.         return 2 * java.lang.Math.PI * r;   
  14.     }   
  15.   
  16. }   
  17.   

在此,有两个基本的标注@WebService@WebMethod。@WebService标注指明HelloService 类作为Web服务。如果没有制定,标注的名称就是类的名称。也能制定命名空间,服务名,WSDL 位置和endpoint 接口等。在指定的上下文环境中,可以使用javax.xml.ws.Endpoint类的publish() 静态方法发布上面的类作为Web服务。代码见列表3:

Java 代码 列表3
  1. import javax.xml.ws.Endpoint;   
  2.   
  3. public static void main(String[] args) {   
  4.   
  5.       Endpoint.publish(   
  6.          "http://localhost:8080/WebServiceExample/circlefunctions",   
  7.          new CircleFunctions());   
  8.   
  9. }   
  10.   

现在,用javac编译源代码。但是源文件能做什么呢?通过对源文件运行 javac编译器进行编译只是产生了class文件。并没有产生特殊的东西。但是在编译类之后,也需要运行wsgen 命令行工具(wsgen 是Web service generator的缩写)。编译源代码后还必需完成更多的步骤:像下面一样调用wsgen工具。

> wsgen –cp . hello.CircleFunctions   

Wsgen工具将在一个叫做wsgen子目录下产生大量的源代码,然后将这些源代码编译成class文件。尽管从未编辑这些文件,但是可以浏览这些文件。注意在使用Wsgen工具时,原始的源代码必需在相应的包里。否则将产生错误。

就这么简单。当运行应用程序时,Java SE 6平台拥有一个小的Web应用服务器,它将在地址为http://localhost:8080/WebServiceExample/circlefunctions 发布Web服务。通过显示CircleFunction的WSDL 来验证Web服务。当JVM仍然运行时,在浏览器输入:

http://localhost:8080/WebServiceExample/circlefunctions?WSDL   

如果在浏览器里看见大量描述Web服务的功能的XML代码,那么Web服务就成功发布了。

 

论坛首页 Java企业应用版

跳转论坛:
Global site tag (gtag.js) - Google Analytics