博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
JAX-WS(一)之使用wsgen从Java创建简单的WebService
阅读量:6259 次
发布时间:2019-06-22

本文共 2175 字,大约阅读时间需要 7 分钟。

概念

JAX-WS2.0的全称Java API for XML-Based Web Service 2.0.JAX-WS2.0是对JAX-RPC1.0规范的扩展,是JAX-RPC1.1的后续版本,JAX-RPC2.0标准发布不久后就被重命名为JAX-WS2.0.

JAX-WS2.0是Sun新的Web service协议栈,是一个完全基于标准实现的。在binding层,使用的是the Java Architecture for XML Binding(JAXB),在parsing层,使用的是the Streaming API for XML(StAX),同时它还完全支持schema规范。

术语

  • SEI:Service Endpoint Interface
  • JAX:Java API for XML Web Servcie
  • JAX-WS RI:JAX-WS Reference Implementation
  • SAAJ:SOAP with Attachments API for Java

创建 Web Service方式

JAX-WS 2.0有两种创建Web Service的开发过程:自顶向下和自定向上。自顶向下方式指通过一个WSDL文件来创建Web Service;自底向上是从Java类出发创建Web Service。两种开发过程最终形成的文件包括:

  1. SEI(对应WSDL中的一个Web Service port,在Java中表现为一个接口);
  2. SEI实现类;
  3. WSDL和XSD文件;

从Java开始的开发步骤:

  1. 声明某个类为@WebService,即将它声明为SEI实现类,然后对需要暴露的方法标注为@WebMethod;
  2. 运行wsgen命令生成其他所需文件;
  3. 发布Web Service;

SEI实现类

最简单的SEI实现类:

package net.oseye; import javax.jws.WebMethod;import javax.jws.WebService; @WebServicepublic class Hello {    @WebMethod    public String SayHello(String name){        return String.format("Hello,%s",name);    }}

此时的目录结构如下:

使用wsgen命令生成所需文件

  1. 进入JAX-WS-Java-Server项目目录如:
    1. D:\MyTemp\workspace\JAX-WS-Java-Server>
  2. 执行wsgen命令:
    1. wsgen -cp ./bin -r ./wsdl -s ./src -d ./bin -wsdl net.oseye.Hello
  3. 执行中可能出现“directory not found: wsdl”,手动建立wsdl目录。
  4. 成功后可在bin、src目录的命名空间net.oseye里看到生成的jaxws文件夹,以及在wsdl目录中的HelloService.wsdl和HelloService_schema1.xsd。

此时的目录结构如下:

 

发布Web Service

在应用程序中发布,JDK停工非常方便的API:Enndpoint.publish

package net.oseye; import javax.xml.ws.Endpoint; public class Main {     /**     * @param args     */    public static void main(String[] args) {        Endpoint.publish("http://localhost:8808/HelloService", new Hello());    } }

运行应用程序,地址栏输入:http://localhost:8808/HelloService,接客预览:

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文件)

 

转自:

转载于:https://www.cnblogs.com/549294286/p/3473807.html

你可能感兴趣的文章
如何在excel单元格中插入图片批注
查看>>
Android 基础动画之补间动画详解
查看>>
业界 | 全球最大生物识别数据库被判定合法
查看>>
Hanlp等七种优秀的开源中文分词库推荐
查看>>
常见移动设备的 CSS3 Media Query 整理(iPhone/iPad/Galaxy/HTC One etc.)
查看>>
redis第二步(事务和锁)
查看>>
rufus:一款制作linux U盘启动的神器
查看>>
[动态代理三部曲:中] - 从动态代理,看Class文件结构定义
查看>>
函数式编程与面向对象编程[5]:编程的本质
查看>>
[Spring实战系列](9)装配集合
查看>>
vue需注意的地方
查看>>
搞定计算机网络面试,看这篇就够了
查看>>
原生开发移动web单页面(step by step)6——history api应用
查看>>
【iOS 开发】Xcode9 自动签名更新设备列表
查看>>
[Elasticsearch]Elasticsearch+kibana+marvel安装
查看>>
《Kotlin 程序设计》第四章 Kotlin 语法基础
查看>>
开源堡垒机 Jumpserver v1.4.8 发布 , Bug 修复版本
查看>>
(十五)Java并发性和多线程-死锁
查看>>
第1章 JVM语言家族概览 《Kotin 编程思想·实战》
查看>>
spring之HttpInvoker
查看>>