基于XML的Web服务Java接口(JAX-WS)、Jakarta XML Web Services Eclipse 实现

2023-10-25 20:53
文章标签 java xml 实现 服务 接口 web eclipse services ws jakarta jax

本文主要是介绍基于XML的Web服务Java接口(JAX-WS)、Jakarta XML Web Services Eclipse 实现，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

简介

JAX-WS（Java API for XML-Based Web Services），是创建web服务的Java编程接口，特别是SOAP服务。是Java XML编程接口之一，是Java SE 和Java EE 平台的一部分。
JAX-WS 2.0 规范是代替JAX-RPC 1.0的下一代Web服务API。JAX-RPC（The Java API for XML Based RPC）是基于XML的RPC（远程过程调用）的Java API。
JAX-WS 2.0 使用JAXB（The Java Architecture for XML Binding）进行XML数据绑定，所谓绑定就是指XML请求和XML响应如何映射成java对象。

参考资源

JAX-WS 2.0参考资源

https://jcp.org/en/jsr/detail?id=224
在这里插入图片描述

https://jakarta.ee/specifications/xml-web-services/2.3/
在这里插入图片描述

JAX-WS 3.0参考资源

https://jakarta.ee/specifications/xml-web-services/3.0/
在这里插入图片描述

JAX-WS 4.0参考资源

https://jakarta.ee/specifications/xml-web-services/4.0/
在这里插入图片描述

Jakarta Web Services Metadata

Jakarta Web Services Metadata项目是Jakarta XML Web Services 项目的一部分，它用Java为web 服务定义了一个编程模型。

代码库：https://github.com/jakartaee/jws-api
在这里插入图片描述

Jakarta Web Services Metadata 3.0 Specification Document (HTML)：
https://jakarta.ee/specifications/web-services-metadata/3.0/ws-metadata-spec-3.0

Jakarta Web Services Metadata 3.0 Javadoc：
https://jakarta.ee/specifications/web-services-metadata/3.0/apidocs/jakarta.jws/module-summary.html

参考实现

旧项目（已经归档、只读）

https://javaee.github.io/metro-jax-ws/
在这里插入图片描述

https://github.com/javaee/metro-jax-ws
在这里插入图片描述
在这里插入图片描述

新项目（Jakarta XML Web Services Eclipse 实现）

主页：
https://eclipse-ee4j.github.io/metro-jax-ws/
在这里插入图片描述

代码库：
https://github.com/eclipse-ee4j/metro-jax-ws
在这里插入图片描述
XML web服务的Eclipse 实现是一个web服务框架，它为最终用户和中间件开发者开发web服务解决方案提供了工具和基础设施（infrastructure）。
使用XML web服务的Eclipse 实现，客户端和web有一个大的优势：Java编程语言的平台无关性。

Jakarta XML Web Services Eclipse 实现需要的软件

  • Java SE 11或以后版本
  • Ant 1.10.6或以后版本
  • 在GlassFish v7.x 、Apache Tomcat 10.1.x下测试过

安装Jakarta XML Web Services Eclipse 实现

下载Jakarta XML Web Services Eclipse实现独立zip发布包

打开主页：https://eclipse-ee4j.github.io/metro-jax-ws/
在这里插入图片描述
点击右侧的Download就可以下载独立发布包，例如，下载jaxws-ri-4.0.0.zip。
解压后的目录：
在这里插入图片描述

bin子目录下的内容：
在这里插入图片描述

docs子目录下的内容：
在这里插入图片描述

lib子目录下的内容：
在这里插入图片描述

samples子目录下的内容：
在这里插入图片描述

安装到Tomcat中

设置CATALINA_HOME环境变量，指向Tomcat的安装目录，例如：
在这里插入图片描述
在这里插入图片描述
在cmd窗口，切换到Jakarta XML Web Services Eclipse实现解压后的目录，例如：D:\jaxws-ri-4.0.0\jaxws-ri
在这里插入图片描述

这个目录下有build.xml文件：
在这里插入图片描述

运行ant install命令。这个命令其实执行了两个大的操作：

  • 拷贝Jakarta XML Web Services Eclipse实现lib子目录下的jar文件到Tomcat安装目录下面的/shared/lib子目录中
  • 更新Tomcat安装目录下面/conf/catalina.properties文件中的属性shared.loader，使之等于${catalina.home}/shared/lib/*.jar

build.xml文件片段：

<target name="install" depends="update-catalina-props" description="Install XML-WS RI 4.0.0 jars"><echo message="Installing XML-WS RI 4.0.0 for ${catalina.home} ..."/><mkdir dir="${catalina.lib.home}"/><copy toDir="${catalina.lib.home}" overwrite="true"><fileset dir="${basedir}/lib" includes="*.jar"/></copy></target><target name="update-catalina-props"><echo message="Backing up ${catalina.home}/conf/catalina.properties..."/><copy file="${catalina.home}/conf/catalina.properties" tofile="${catalina.home}/conf/catalina.properties.backup"/><echo message="Adding XML-WS RI jars to shared.loader property in ${catalina.home}/conf/catalina.properties..."/><replace file="${catalina.home}/conf/catalina.properties" token="shared.loader=" value="shared.loader=$${catalina.home}/shared/lib/*.jar,"/>
</target>

执行ant install命令的窗口输出信息：
在这里插入图片描述

Jakarta XML Web Services Eclipse 实现依赖的jar包

https://eclipse-ee4j.github.io/metro-jax-ws/4.0.0/docs/release-documentation.html#jar-dependency
在这里插入图片描述

SOAP1.1+HTTP样例：运行fromjava样例（来自Jakarta XML Web Services Eclipse实现发布包）

说明

fromjava这个样例演示了从一个Java service endpoint的实现开始，如何构建、部署、调用一个简单的web服务。其中Java service endpoint的实现使用了Java注释。
在这里插入图片描述

fromjava的目录结构：
在这里插入图片描述

服务实现类只有一个方法addNumbers，输入两个整数，返回一个整数，抛出AddNumbersException异常：
在这里插入图片描述

运行web服务有两种方式：

  • 在servlet容器中运行
  • 作为一个j2se webservice endpoint运行（不需要servlet容器）

运行方式一：在tomcat容器中运行web服务

设置环境变量JAXWS_HOME指向JAX-WS的安装目录

在这里插入图片描述

在cmd窗口切换到fromjava的目录

在这里插入图片描述

运行ant clean

运行ant clean的作用是删掉${build.home}目录。其中${build.home}目录指向${basedir}/build，就是fromjava/build目录。（其实这个命令不运行也可以，因为下一步运行ant server命令的时候其中含有ant clean的步骤）
在这里插入图片描述

运行ant server -Dtomcat=true

运行ant server -Dtomcat=true的作用是构建、部署web服务的WAR包，因为要将web服务运行在tomcat中，所以加了-Dtomcat=true这个属性。这个命令做了四个工作：

<target name="server" depends="setup"><antcall target="clean"/><antcall target="build-server-java"/><antcall target="create-war"/><antcall target="deploy"/>
</target>

运行输出：
在这里插入图片描述
在这里插入图片描述

现在fromjava目录下的文件布局（注：照理${env.AS_HOME}这个目录不应该生成的，对我们没有什么用）：

D:\JAXWS-RI-4.0.0\JAXWS-RI\SAMPLES\FROMJAVA
│  build.xml
│  Readme.txt
│  
├─${env.AS_HOME}
│  └─domains
│      └─domain1
│          └─autodeploy
│                  jaxws-fromjava.war
│                  
├─build
│  ├─classes
│  │  └─fromjava
│  │      └─server
│  │          │  AddNumbersException.class
│  │          │  AddNumbersImpl.class
│  │          │  AddWebservice.class
│  │          │  EndpointStopper$1.class
│  │          │  EndpointStopper.class
│  │          │  
│  │          └─jaxws
│  │                  AddNumbers.class
│  │                  AddNumbers.java
│  │                  AddNumbersExceptionBean.class
│  │                  AddNumbersExceptionBean.java
│  │                  AddNumbersResponse.class
│  │                  AddNumbersResponse.java
│  │                  
│  └─war
│          jaxws-fromjava.war
│          
├─etc
│      deploy-targets.xml
│      sun-jaxws.xml
│      web.xml
│      
└─src└─fromjava├─client│      AddNumbersClient.java│      └─serverAddNumbersException.javaAddNumbersImpl.javaAddWebservice.javaEndpointStopper.java

到<tomcat安装目录>/webapps下查看，war包已经拷贝过来了：
在这里插入图片描述

运行tomcat

因为生成客户端代码的时候要访问web服务动态生成的wsdl文件，所以要先启动tomcat。
在这里插入图片描述
在这里插入图片描述

到<tomcat安装目录>/webapps下查看，war包已经被自动部署了：
在这里插入图片描述

部署以后的文件布局：

D:\APACHE-TOMCAT-10.1.13\WEBAPPS\JAXWS-FROMJAVA
├─META-INF
│      MANIFEST.MF
│      war-tracker
│      
└─WEB-INF│  sun-jaxws.xml│  web.xml│  └─classes└─fromjava└─server│  AddNumbersException.class│  AddNumbersImpl.class│  AddWebservice.class│  EndpointStopper$1.class│  EndpointStopper.class│  └─jaxwsAddNumbers.classAddNumbers.javaAddNumbersExceptionBean.classAddNumbersExceptionBean.javaAddNumbersResponse.classAddNumbersResponse.java

看看wsdl文件能否正常生成

访问http://localhost:8080/jaxws-fromjava/addnumbers?wsdl
可以看到，正常生成了wsdl文件。生成客户端代码的时候，就要访问这个wsdl的地址。
在这里插入图片描述

<?xml version='1.0' encoding='UTF-8'?><!-- Published by XML-WS Runtime (https://github.com/eclipse-ee4j/metro-jax-ws). Runtime's version is XML-WS Runtime 4.0.0 git-revision#129f787. --><!-- Generated by XML-WS Runtime (https://github.com/eclipse-ee4j/metro-jax-ws). Runtime's version is XML-WS Runtime 4.0.0 git-revision#129f787. --><definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://server.fromjava/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://server.fromjava/" name="AddNumbersImplService">
<types>
<xsd:schema>
<xsd:import namespace="http://server.fromjava/" schemaLocation="http://localhost:8080/jaxws-fromjava/addnumbers?xsd=1"/>
</xsd:schema>
</types>
<message name="addNumbers">
<part name="parameters" element="tns:addNumbers"/>
</message>
<message name="addNumbersResponse">
<part name="parameters" element="tns:addNumbersResponse"/>
</message>
<message name="AddNumbersException">
<part name="fault" element="tns:AddNumbersException"/>
</message>
<portType name="AddNumbersImpl">
<operation name="addNumbers">
<input wsam:Action="http://server.fromjava/AddNumbersImpl/addNumbersRequest" message="tns:addNumbers"/>
<output wsam:Action="http://server.fromjava/AddNumbersImpl/addNumbersResponse" message="tns:addNumbersResponse"/>
<fault message="tns:AddNumbersException" name="AddNumbersException" wsam:Action="http://server.fromjava/AddNumbersImpl/addNumbers/Fault/AddNumbersException"/>
</operation>
</portType>
<binding name="AddNumbersImplPortBinding" type="tns:AddNumbersImpl">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
<operation name="addNumbers">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal"/>
</input>
<output>
<soap:body use="literal"/>
</output>
<fault name="AddNumbersException">
<soap:fault name="AddNumbersException" use="literal"/>
</fault>
</operation>
</binding>
<service name="AddNumbersImplService">
<port name="AddNumbersImplPort" binding="tns:AddNumbersImplPortBinding">
<soap:address location="http://localhost:8080/jaxws-fromjava/addnumbers"/>
</port>
</service>
</definitions>

运行ant clean

运行ant clean：
在这里插入图片描述

运行ant client

运行ant client的目的是为了生成客户端代码并编译：

<target name="generate-client" depends="setup"><wsimportdebug="true"verbose="${verbose}"keep="true"destdir="${build.classes.home}"package="fromjava.client"wsdl="http://localhost:8080/jaxws-fromjava/addnumbers?wsdl"></wsimport>
</target><target name="client" depends="generate-client"><javacfork="true"srcdir="${basedir}/src"destdir="${build.classes.home}"includes="**/client/**,**/common/**"><classpath refid="jaxws.classpath"/></javac>
</target>

在这里插入图片描述

运行后，客户端代码布局：

D:\JAXWS-RI-4.0.0\JAXWS-RI\SAMPLES\FROMJAVA\BUILD
├─classes
│  └─fromjava
│      └─client
│              AddNumbers.class
│              AddNumbers.java
│              AddNumbersClient.class
│              AddNumbersException.class
│              AddNumbersException.java
│              AddNumbersException_Exception.class
│              AddNumbersException_Exception.java
│              AddNumbersImpl.class
│              AddNumbersImpl.java
│              AddNumbersImplService.class
│              AddNumbersImplService.java
│              AddNumbersResponse.class
│              AddNumbersResponse.java
│              ObjectFactory.class
│              ObjectFactory.java
│              package-info.class
│              package-info.java
│              
└─war

运行ant run

执行ant run表示运行客户端。

<target name="run"><java fork="true" classname="fromjava.client.AddNumbersClient"><classpath><path refid="jaxws.classpath"/><pathelement location="${build.classes.home}"/><pathelement location="${basedir}/etc"/></classpath></java>
</target>

在这里插入图片描述

运行方式二：作为一个j2se webservice endpoint运行（不运行在servlet容器中）

运行ant clean server-j2se

运行ant clean server-j2se生成服务端代码，并且用Endpoint API来部署：

<target name="server-j2se" depends="setup"><antcall target="clean"/><antcall target="build-server-java"/><echo message="Starting endpoint... To stop: ant server-j2se-stop "/><java fork="true" classname="fromjava.server.AddWebservice"><classpath><path refid="jaxws.classpath"/><pathelement location="${build.classes.home}"/></classpath></java>
</target>

在这里插入图片描述

生成的文件布局：

D:\JAXWS-RI-4.0.0\JAXWS-RI\SAMPLES\FROMJAVA\BUILD
├─classes
│  └─fromjava
│      └─server
│          │  AddNumbersException.class
│          │  AddNumbersImpl.class
│          │  AddWebservice.class
│          │  EndpointStopper$1.class
│          │  EndpointStopper.class
│          │  
│          └─jaxws
│                  AddNumbers.class
│                  AddNumbers.java
│                  AddNumbersExceptionBean.class
│                  AddNumbersExceptionBean.java
│                  AddNumbersResponse.class
│                  AddNumbersResponse.java
│                  
└─war

访问http://localhost:8080/jaxws-fromjava/addnumbers?wsdl
可以正常生成wsdl文件：

在这里插入图片描述

运行ant clean client run

另外打开一个cmd窗口，运行ant clean client run，目的是在根据endpoint发布的wsdl文件生成客户端代码、编译、并且运行。
在这里插入图片描述
在这里插入图片描述

运行后，客户端的代码布局：
D:\JAXWS-RI-4.0.0\JAXWS-RI\SAMPLES\FROMJAVA\BUILD
├─classes
│ └─fromjava
│ └─client
│ AddNumbers.class
│ AddNumbers.java
│ AddNumbersClient.class
│ AddNumbersException.class
│ AddNumbersException.java
│ AddNumbersException_Exception.class
│ AddNumbersException_Exception.java
│ AddNumbersImpl.class
│ AddNumbersImpl.java
│ AddNumbersImplService.class
│ AddNumbersImplService.java
│ AddNumbersResponse.class
│ AddNumbersResponse.java
│ ObjectFactory.class
│ ObjectFactory.java
│ package-info.class
│ package-info.java
│
└─war

运行ant server-j2se-stop，停止web服务

<target name="server-j2se-stop" depends="setup"><get src="http://localhost:9090/stop" dest="stop.status"/>
</target>

在这里插入图片描述

Jakarta XML Web Services Eclipse实现下载方式二：用maven下载

在maven工程的pom.xml文件中增加如下依赖：

  <dependencies><dependency><groupId>jakarta.xml.ws</groupId><artifactId>jakarta.xml.ws-api</artifactId><version>4.0.0</version></dependency><dependency><groupId>com.sun.xml.ws</groupId><artifactId>jaxws-rt</artifactId><version>4.0.0</version>        </dependency></dependencies>

这篇关于基于XML的Web服务Java接口(JAX-WS)、Jakarta XML Web Services Eclipse 实现的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/285137。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
Java进阶13讲__第12讲_1/2

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory
阅读更多...
hdu1043（八数码问题，广搜 + hash（实现状态压缩） ）

hdu1043（八数码问题，广搜 + hash（实现状态压缩） ）

利用康拓展开将一个排列映射成一个自然数，然后就变成了普通的广搜题。 #include<iostream>#include<algorithm>#include<string>#include<stack>#include<queue>#include<map>#include<stdio.h>#include<stdlib.h>#include<ctype.h>#inclu
阅读更多...
JAVA智听未来一站式有声阅读平台听书系统小程序源码

JAVA智听未来一站式有声阅读平台听书系统小程序源码

智听未来，一站式有声阅读平台听书系统 🌟&nbsp;开篇：遇见未来，从“智听”开始 在这个快节奏的时代，你是否渴望在忙碌的间隙，找到一片属于自己的宁静角落？是否梦想着能随时随地，沉浸在知识的海洋，或是故事的奇幻世界里？今天，就让我带你一起探索“智听未来”——这一站式有声阅读平台听书系统，它正悄悄改变着我们的阅读方式，让未来触手可及！ 📚&nbsp;第一站：海量资源，应有尽有 走进“智听
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2