`

jax-ws(jws)

 
阅读更多
Java SE 6封装了JAX-WS(Java API for XML-Web Services),而JAX-WS同时支持基于SOAP的Web服务和REST风格的Web服务。JAX-WS通常可简写为JWS,当前,JWS的版本为2.x。
基于SOAP的Web服务可用单个Java类的实现,但是最好是用“接口+实现”的方式来实现最佳。
Web服务的接口称为SEI,即Service Endpoint Interface;
而Web服务的实现称为SIB,即Service Implementation Bean。

SIB可以是一个POJO,也可以是无状态的会话EJB。本文的SIB是普通Java类,通过JDK 6的类库即可实现Web服务的发布。

在JAX-WS中,Web Service操作调用表现为以XML为基础的协议如SOAP协议。SOAP定义了封装架构,编码规则以及Web Service中调用和回应表现的规则。这些调用和回应在HTTP基础上以SOAP规范的消息进行传递。
尽管SOAP协议是很复杂的,但是JAX-WS隐藏了开发人员面对的复杂性。在服务器端,开发者可以通过在使用java语言接口中定义方法来制定Web Service。开发者可以编写一个或者多个类来实现这些方法。客户端程序也很容易编写。客户端会创建一个代理(表现服务器端的本地对象)并且简单的调用代理中的方法即可。在JAX-WS中,开发者不必去创建和解析SOAP消息。JAX-WS运行系统会自动完成调用和回应之间SAOP消息的转换。
使用JAX-WS,客户端和服务器端都有一个很大的优势:java编程语言的平台独立性。此外,JAX-WS并不限制:JAX-WS客户端程序可以访问不运行在java平台上的Web Servicce。这种灵活性是由于Web Service采用了W3C定义的技术规范:Http,SOAP,WSDL。

以上摘自http://blog.csdn.net/qiudawei115/article/details/1916994
JAXWS适合几乎所有Webservice客户端的调用,因此不少巨头型的厂商如:IBM,Weblogic等,在他们的产品上都使用了以JAXWS为标准的Webservice接口。
Webservice进行总结、比较,最终觉得jaxws是目前最标准,需要额外第三方插件最少,配置最少最灵活的webservice。

JAX-WS (Java API for XML Web Services) 是一组专门用于实现 XML Web Services 的 Java API。JDK 1.6 自带 JAX-WS 版本为 2.1。不过,JAX-WS 只提供 web services 的基础功能,所以如果你希望实现 web services 的复杂功能,比如 WS-Security,WS-Policy,WS-RM 等,那就需要切换到 Apache CXF 、Metro 或者 Axis。

可以采用以下两种方法之一开发 Web 服务:
契约优先:从 WSDL 契约着手,生成 Java 类来实现服务。
代码优先:从 Java 类着手,使用 Annotation 来生成 WSDL 文件和 Java 接口。


wsimport
wsimport是在JDK的bin目录下的一个exe文件(Windows版),主要 功能是根据服务端发布的wsdl文件生成客户端存根及框架,负责与Web Service 服务器通信,并在将其封装成实例,客户端可以直接使用,就像使用本地实例一样。对Java而言,wsimport帮助程序员生成调用web service所需要的客户端类文件.java和.class。要提醒指出的是,wsimport可以用于非Java的服务器端,如:服务器端也许是C# 编写的web service,通过wsimport则生成Java的客户端实现。
命令参数说明:
    -d 生成客户端执行类的class文件的存放目录
    -s 生成客户端执行类的源文件的存放目录
    -p 定义生成类的包名
   -keep 是否保留源文件
二种生成方式:
wsimport -keep -d ./bin -s ./src -p com.test.ws http: //localhost:8088/hellowservice?wsdl   
wsimport -keep -d ./bin -s ./src -p com.test.ws ./wsdl/HellowService.wsdl

wsgen
wsgen是在JDK的bin目录下的一个exe文件(Windows版),该命令的主要功能是用来生成合适的JAX-WS。它读取Web Service的终端类文件,同时生成所有用于发布Web Service所依赖的源代码文件和经过编译过的二进制类文件。这里要特别说明的是,通常在Web Service Bean中用到的异常类会另外生成一个描述Bean,如果Web Service Bean中的方法有申明抛出异常,这一步是必需的,否则服务器无法绑定该对像。此外,wsgen还能辅助生成WSDL和相关的xsd文件。wsgen从资源文件生成一个完整的操作列表并验证web service是否合法,可以完整发布。
命令参数说明:

     -cp 定义classpath
     -r 生成 bean的wsdl文件的存放目录
     -s 生成发布Web Service的源代码文件的存放目录(如果方法有抛出异常,则会生成该异常的描述类源文件)
     -d 生成发布Web Service的编译过的二进制类文件的存放目录(该异常的描述类的class文件)

范例:
计入项目目录:新建wsdl文件夹
执行命令
wsgen -cp ./bin -r ./wsdl -s ./src -d ./bin -wsdl server.PlusImpl

即可生成wsdl文件与xsd文件

要想将服务部署到web容器中,如tomcat

则需要 sun-jaxws.xml 文件
<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"
version="2.0">
<endpoint name="calculator" implementation="test.CalculatorImpl"
url-pattern="/calculator" />
</endpoints>

web.xml文件
    <?xml version="1.0" encoding="UTF-8"?> 
    <!DOCTYPE web-app PUBLIC "-//Sun Microsystems,  
    Inc.//DTD Web Application 2.3//EN" 
    "http://java.sun.com/j2ee/dtds/web-app_2_3.dtd"> 
      
    <web-app> 
        <listener> 
            <listener-class> 
                    com.sun.xml.ws.transport.http.servlet.WSServletContextListener 
            </listener-class> 
        </listener> 
        <servlet> 
            <servlet-name>calculator</servlet-name> 
            <servlet-class> 
                com.sun.xml.ws.transport.http.servlet.WSServlet 
            </servlet-class> 
            <load-on-startup>1</load-on-startup> 
        </servlet> 
        <servlet-mapping> 
            <servlet-name>calculator</servlet-name> 
            <url-pattern>/calculator</url-pattern> 
        </servlet-mapping> 
        <session-config> 
            <session-timeout>120</session-timeout> 
        </session-config> 
    </web-app> 
注意:需要下载相应的依赖包
http://jax-ws.java.net
service的函数名不能与类名称相同,否则生成相同文件名会被覆盖 ,导致报错
分享到:
评论
发表评论

文章已被作者锁定,不允许评论。

相关推荐

    使用JAX-WS(JWS)发布WebService

    使用JAX-WS(JWS)发布WebService 使用myeclipse开发java的webservice的两种方式 方式一: (此方式只能作为调试,有以下bug:jdk1.6u17?以下编译器不支持以Endpoint.publish方式发布document方式的soap,必须在...

    jax-ws WebService客户端与服务端工程.rar

    jax-ws客户端与服务端工程.rar-------------

    jax-ws-tutorial.zip

    Java API for XML Web Services (JAX-WS) 是一种用于创建 ...参阅:https://examples.javacodegeeks.com/enterprise-java/jws/jax-ws-tutorial-beginners/ Maven 项目来演示如何创建、部署、使用和测试 JAX-WS Web 服务

    play-jax-ws:使用 Play Framework 公开您的 SOAP 服务

    play-jax-ws 使用 Play Framework 公开您的 JAX-WS SOAP 服务。 例子 请参阅example-scala和example-java 。 设置 build.sbt添加到您的build.sbt文件中: resolvers += "Koofr Github repo" at ...

    JAVA6开发WebService JWS示例

    JAX-WS 是 JAVA 中的一种 WebService 规范,早期的 JAVA Web 服务规范 JAX-RPC(Java API For XML-Remote Procedure Call)目前已经被 JAX-WS 规范取代,JAX-WS 是 JAX-RPC 的演进版本,但 JAX-WS 并不完全向后兼容 ...

    java webservice 详细开发示例介绍

    早期的基于 SOAP 的 JAVA 的 Web 服务规范 JAX-RPC(Java API For ...WS-MetaData(JSR 181)是 JAX-WS 的依赖规范,其 API位于 javax.jws.*包,使用注解配 置公开的Web服务的相关信息和配置 SOAP 消息的相关信息。

    org.liveSense.framework.gxt-1.0.5.zip

    org.liveSense.fragment.javax.jws-jre-1.6.zip,将jax-ws api包添加到系统包导出中。

    WebService例子及其如何部署到tomcat上面

    这个是使用JWS(又叫JAX-W)来实现 WebService的两个小例子

    jaxws java webservice需要的jar包

    jaxws java webservice需要的jar包

    [Java参考文档].JDK_API 1.6

    javax.xml.ws.spi 该包定义用于 JAX-WS 2.0 的 SPI。 javax.xml.xpath 此包提供了用于 XPath 表达式的计算和访问计算环境的 object-model neutral API。 org.ietf.jgss 此包提供一个框架,该框架允许应用程序开发...

    Java 1.6 API 中文 New

    javax.xml.ws.spi 该包定义用于 JAX-WS 2.0 的 SPI。 javax.xml.xpath 此包提供了用于 XPath 表达式的计算和访问计算环境的 object-model neutral API。 org.ietf.jgss 此包提供一个框架,该框架允许应用程序开发...

Global site tag (gtag.js) - Google Analytics