使用JAX-WS的maven插件发布webservice

最新推荐文章于 2025-06-06 11:30:21 发布
原创 最新推荐文章于 2025-06-06 11:30:21 发布 · 935 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java

本文介绍了一种利用Maven插件自动部署WebService的方法，并详细解释了如何解决部署过程中的missjar问题，以及如何处理wsdl文件中schema的外部xsd文件引用问题。此外，还提供了完整的WebService接口及其实现类的示例。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

1.引入插件过程中，提示miss jar的问题，换中心仓库的地址解决了

settings.xml中将中心仓库的地址改为http://uk.maven.org/maven2

2.基于契约优先的方式，wsdl中的schema如果引用外部的xsd文件，客户端使用wsimport导出会出现问题，提示找不到xsd文件

将xsd中定义的元素拷贝到wsdl中，不要单独定义

 

schema

 

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://ws.student.hqh.com"
	xmlns:tns="http://ws.student.hqh.com" elementFormDefault="qualified">
	
	<xsd:element name="getStudent" type="tns:getStudent" />
	<xsd:element name="getStudentResponse" type="tns:getStudentResponse" />
	<xsd:element name="list" type="tns:list" />
	<xsd:element name="listResponse" type="tns:listResponse" />
	<xsd:element name="listReward" type="tns:listReward" />
	<xsd:element name="listRewardResponse" type="tns:listRewardResponse" />

	<xsd:complexType name="student">
		<xsd:sequence>
			<xsd:element name="id" type="xsd:int" />
			<xsd:element name="name" type="xsd:string" />
			<xsd:element name="sex" type="xsd:string" />
			<xsd:element name="age" type="xsd:int" />
			<xsd:element name="number" type="xsd:string" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="reward">
		<xsd:sequence>
			<xsd:element name="id" type="xsd:int" />
			<xsd:element name="year" type="xsd:string" />
			<xsd:element name="rewardInfo" type="xsd:string" />
			<xsd:element name="detail" type="xsd:string" />
			<xsd:element name="student" type="tns:student" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="getStudent">
		<xsd:sequence>
			<xsd:element name="number" type="xsd:string" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="getStudentResponse">
		<xsd:sequence>
			<xsd:element name="stu" type="tns:student" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="list">
		<xsd:sequence />
	</xsd:complexType>

	<xsd:complexType name="listResponse">
		<xsd:sequence minOccurs="1" maxOccurs="unbounded">
			<xsd:element name="students" type="tns:student" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="listReward">
		<xsd:sequence>
			<xsd:element name="number" type="xsd:string" />
			<xsd:element name="date" type="xsd:date" />
		</xsd:sequence>
	</xsd:complexType>

	<xsd:complexType name="listRewardResponse">
		<xsd:sequence minOccurs="1" maxOccurs="unbounded">
			<xsd:element name="rewards" type="tns:reward" />
		</xsd:sequence>
	</xsd:complexType>
</xsd:schema>

 

 

wsdl

 

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:tns="http://ws.student.hqh.com" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StudentWSService"
	targetNamespace="http://ws.student.hqh.com">

	<!-- 指定schema -->
	<wsdl:types>
		<xsd:schema targetNamespace="http://ws.student.hqh.com">
			<!-- <xsd:import schemaLocation="student.xsd" namespace="http://ws.student.hqh.com"/> -->
			<xsd:element name="getStudent" type="tns:getStudent" />
			<xsd:element name="getStudentResponse" type="tns:getStudentResponse" />
			<xsd:element name="list" type="tns:list" />
			<xsd:element name="listResponse" type="tns:listResponse" />
			<xsd:element name="listReward" type="tns:listReward" />
			<xsd:element name="listRewardResponse" type="tns:listRewardResponse" />

			<xsd:complexType name="student">
				<xsd:sequence>
					<xsd:element name="id" type="xsd:int" />
					<xsd:element name="name" type="xsd:string" />
					<xsd:element name="sex" type="xsd:string" />
					<xsd:element name="age" type="xsd:int" />
					<xsd:element name="number" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="reward">
				<xsd:sequence>
					<xsd:element name="id" type="xsd:int" />
					<xsd:element name="year" type="xsd:string" />
					<xsd:element name="rewardInfo" type="xsd:string" />
					<xsd:element name="detail" type="xsd:string" />
					<xsd:element name="student" type="tns:student" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="getStudent">
				<xsd:sequence>
					<xsd:element name="number" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="getStudentResponse">
				<xsd:sequence>
					<xsd:element name="stu" type="tns:student" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="list">
				<xsd:sequence />
			</xsd:complexType>

			<xsd:complexType name="listResponse">
				<xsd:sequence minOccurs="1" maxOccurs="unbounded">
					<xsd:element name="students" type="tns:student" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="listReward">
				<xsd:sequence>
					<xsd:element name="number" type="xsd:string" />
					<xsd:element name="year" type="xsd:string" />
				</xsd:sequence>
			</xsd:complexType>

			<xsd:complexType name="listRewardResponse">
				<xsd:sequence minOccurs="1" maxOccurs="unbounded">
					<xsd:element name="rewards" type="tns:reward" />
				</xsd:sequence>
			</xsd:complexType>
		</xsd:schema>
	</wsdl:types>

	<!-- 指定方法 -->
	<wsdl:message name="getStudent">
		<wsdl:part element="tns:getStudent" name="parameters" />
	</wsdl:message>
	<wsdl:message name="getStudentResponse">
		<wsdl:part element="tns:getStudentResponse" name="parameters" />
	</wsdl:message>
	<wsdl:message name="list">
		<wsdl:part element="tns:list" name="parameters" />
	</wsdl:message>
	<wsdl:message name="listResponse">
		<wsdl:part element="tns:listResponse" name="parameters" />
	</wsdl:message>
	<wsdl:message name="listReward">
		<wsdl:part element="tns:listReward" name="parameters" />
	</wsdl:message>
	<wsdl:message name="listRewardResponse">
		<wsdl:part element="tns:listRewardResponse" name="parameters" />
	</wsdl:message>

	<!-- 指定接口 -->
	<wsdl:portType name="IStudentWSService">
		<wsdl:operation name="getStudent">
			<wsdl:input message="tns:getStudent" />
			<wsdl:output message="tns:getStudentResponse" />
		</wsdl:operation>
		<wsdl:operation name="list">
			<wsdl:input message="tns:list" />
			<wsdl:output message="tns:listResponse" />
		</wsdl:operation>
		<wsdl:operation name="listReward">
			<wsdl:input message="tns:listReward" />
			<wsdl:output message="tns:listRewardResponse" />
		</wsdl:operation>
	</wsdl:portType>

	<!-- 指定接口中的方法的参数编码格式 -->
	<wsdl:binding name="studentSOAP" type="tns:IStudentWSService">
		<soap:binding style="document"
			transport="http://schemas.xmlsoap.org/soap/http" />
		<wsdl:operation name="getStudent">
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="list">
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="listReward">
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
	</wsdl:binding>

	<!-- 指定服务名称、端口、地址 -->
	<wsdl:service name="StudentWSService">
		<wsdl:port binding="tns:studentSOAP" name="studentServicePort">
			<soap:address location="http://localhost:8080/stu/ws/" />
		</wsdl:port>
	</wsdl:service>
</wsdl:definitions>

 安装插件

将插件的执行阶段绑定到了compile期间，只要项目执行编译命令，就会到指定位置寻找wsdl文件并将其转换为java文件。只拷贝接口，然后删除接口中的多余项（方法参数上指定的class） 
<!-- jaxws插件 -->
<plugin>
	  <groupId>org.codehaus.mojo</groupId>
	  <artifactId>jaxws-maven-plugin</artifactId>
	  <version>1.9</version>
	  <configuration>
	  	<wsdlDirectory>src/main/resources/META-INF/wsdl</wsdlDirectory>
	  	<wsdlFiles>
	  		<wsdlFile>student.wsdl</wsdlFile>
	  	</wsdlFiles>
	  </configuration>
	  <executions>
	  	<execution>
	  		<phase>compile</phase>
	  		<goals>
	  			<goal>wsimport</goal>
	  		</goals>
	  	</execution>
	  </executions>
</plugin>

 

 

接口

package com.hqh.student.ws;

import java.util.List;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.ws.RequestWrapper;
import javax.xml.ws.ResponseWrapper;

import com.hqh.student.model.Reward;
import com.hqh.student.model.Student;


/**
 * This class was generated by the JAX-WS RI.
 * JAX-WS RI 2.1.3-b02-
 * Generated source version: 2.1
 * 
 */
@WebService(name = "IStudentWSService", targetNamespace = "http://ws.student.hqh.com")
public interface IStudentWSService {


    /**
     * 
     * @param number
     * @return
     *     returns com.hqh.student.ws.Student
     */
    @WebMethod
    @WebResult(name = "stu", targetNamespace = "")
    @RequestWrapper(localName = "getStudent", targetNamespace = "http://ws.student.hqh.com")
    @ResponseWrapper(localName = "getStudentResponse", targetNamespace = "http://ws.student.hqh.com")
    public Student getStudent(
        @WebParam(name = "number", targetNamespace = "")
        String number);

    /**
     * 
     * @return
     *     returns java.util.List<com.hqh.student.ws.Student>
     */
    @WebMethod
    @WebResult(name = "students", targetNamespace = "")
    @RequestWrapper(localName = "list", targetNamespace = "http://ws.student.hqh.com")
    @ResponseWrapper(localName = "listResponse", targetNamespace = "http://ws.student.hqh.com")
    public List<Student> list();

    /**
     * 
     * @param year
     * @param number
     * @return
     *     returns java.util.List<com.hqh.student.ws.Reward>
     */
    @WebMethod
    @WebResult(name = "rewards", targetNamespace = "")
    @RequestWrapper(localName = "listReward", targetNamespace = "http://ws.student.hqh.com")
    @ResponseWrapper(localName = "listRewardResponse", targetNamespace = "http://ws.student.hqh.com")
    public List<Reward> listReward(
        @WebParam(name = "number", targetNamespace = "")
        String number,
        @WebParam(name = "year", targetNamespace = "")
        String year);

}

 

实现类

 

package com.hqh.student.ws;

import java.util.List;

import javax.jws.WebService;

import org.springframework.beans.factory.BeanFactory;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.hqh.student.model.Reward;
import com.hqh.student.model.Student;
import com.hqh.student.service.StudentService;


@WebService(endpointInterface="com.hqh.student.ws.IStudentWSService",
			serviceName="StudentWSService",
			portName="studentServicePort",
			targetNamespace="http://ws.student.hqh.com",
			wsdlLocation="META-INF/wsdl/student.wsdl")
public class StudentWSServiceImpl implements IStudentWSService{
	private static final BeanFactory factory = new ClassPathXmlApplicationContext("beans.xml");
	public StudentWSServiceImpl() {
		if(studentService==null) {
			studentService = factory.getBean(StudentService.class);
		}
	}
	
	private StudentService studentService;
	
	@Override
	public Student getStudent(String number) {
		return studentService.getStudent(number);
	}

	@Override
	public List<Student> list() {
		return studentService.list();
	}

	@Override
	public List<Reward> listReward(String number, String year) {
		return studentService.listReward(number, year);
	}

}

 

开启服务

 

package com.hqh.student.ws;

import javax.xml.ws.Endpoint;

public class MyLocalServer {
	public static void main(String[] args) {
		Endpoint.publish("http://localhost:8080/stu/ws", new StudentWSServiceImpl());
	}
}

 

客户端模块

同样引入jaxws插件，绑定到compile期间，根据指定的url地址将wsdl转换为java文件

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.hqh.student</groupId>
	<artifactId>student-client</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>student-client</name>
	<url>http://maven.apache.org</url>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>

	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.10</version>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<!-- jaxws插件 -->
				<groupId>org.codehaus.mojo</groupId>
				<artifactId>jaxws-maven-plugin</artifactId>
				<version>1.9</version>
				<configuration>
					<wsdlUrls>
						<wsdlUrl>http://localhost:8080/stu/ws?wsdl</wsdlUrl>
					</wsdlUrls>
				</configuration>
				<executions>
					<execution>
						<phase>compile</phase>
						<goals>
							<goal>wsimport</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
</project>

 执行maven：compile命令，将转换后的文件拷贝到src目录下，新建测试类

 

package com.hqh.ws.test;

import java.util.List;

import javax.xml.datatype.XMLGregorianCalendar;

import org.junit.Test;

import com.hqh.student.ws.IStudentWSService;
import com.hqh.student.ws.Reward;
import com.hqh.student.ws.Student;
import com.hqh.student.ws.StudentWSService;

public class TestStudent {
	IStudentWSService iservice = new StudentWSService().getStudentServicePort();
	@Test
	public void testGetStudent() {
		Student stu = iservice.getStudent("20130001");
		System.out.println(stu.getName());
	}
	
	@Test
	public void testList() {
		List<Student> students = iservice.list();
		for(Student stu : students) {
			System.out.println(stu.getName()+","+stu.getSex()+","+stu.getNumber());
		}
	}
	
	@Test
	public void listReward() {
		List<Reward> rewards = iservice.listReward("20130002", "2010");
		for(Reward r : rewards)
			 System.out.println(r.getId()+","+r.getRewardInfo()+","+r.getDetail()+","+r.getStudent().getName());
	}
}

 

使用Maven的jaxws-maven-plugin插件，将wsdl生成java
fdyufgf的博客
01-23 664
使用Maven的jaxws-maven-plugin插件，将wsdl生成java
【WebService学习】-----使用wsgen工具构建JAX-WS的WebService
梦悠哉的博客
05-16 413
1. 简介 jdk中自带的工具wsgen为构建JAX-WS的WebService提供了便利，我们需要使用JAX-WS的注解编写一个服务实现类，wsgen工具将会解析服务实现类并且生成构建服务的必要文件。wsgen工具目录在$jdk/bin文件下面。 wegen工具可以生成文件如下： 1.为构建WebService服务生成JAX-WS便携式文件。 2.生成WSDL和XSD文件，用于测试和web服务客...
使用jaxws-maven-plugin代替wsimport生成webservice客户端代码
qq_40448623的博客
05-14 888
JDK11使用jaxws-maven-plugin代替wsimport生成webservice客户端代码 一、背景 jdk11移除了wsimport，详情可见，https://stackoverflow.com/questions/53192401/where-is-wsimport-after-jdk11 二、使用jaxws-maven-plugin 可以使用jaxws-maven-plugin插件生成客户端代码，以下使用了一个公网可以访问的webservice地址作为示例,亲测可用 <pl
JAX-WS Web服务开发实践指南
最新发布
weixin_35639680的博客
06-06 425
Java API for XML Web Services (JAX-WS) 是 Java EE 规范的一部分，它提供了一种简单的方式来创建Web服务和客户端，使用SOAP协议进行消息交换。JAX-WS特别适合构建服务导向架构（SOA），它为开发者提供了将普通Java类转换为Web服务的工具。
jaxws-maven-插件
02-02
MojoHaus JAX-WS Maven插件 这是 。 发行 确保gpg-agent正在运行。 执行mvn -B release:prepare release:perform 要发布网站，请执行以下操作： cd target/checkout mvn verify site site:stage scm-publish:publish-scm
JAX-WS 使用maven创建
didui0897的博客
01-20 604
maven 创建jar jar包依赖 　　<dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.10</version> <...
jaxws-maven-plugin plugin.xml
wuyujin1997的博客
06-16 592
文章目录locationjaxws-maven-plugin plugin.xml location /Users/leung/javaweb/mvnrepo/org/codehaus/mojo/jaxws-maven-plugin/1.12/jaxws-maven-plugin-1.12.jar!/META-INF/maven/plugin.xml jaxws-maven-plugin plugin.xml <?xml version="1.0" encoding="UTF-8"?> <
Java开发Web Service客户端技巧：wsimport、jaxws-maven-plugin、整合Spring
叉叉哥的BLOG
10-18 4249
搭建一个简单的Web Service服务器要想跑Web Service客户端，前提是要有个Web Service服务器。如果你已经有Web Service服务器，那么可以跳过这一步。如果没有，可以使用JAX-WS搭建一个简单的Web Service服务器。@WebService public class HelloWorld { public String sayHello(String na
JAX-WS + Spring 实现webService示例.docx
10-25
在本文中，我们将深入探讨如何使用JAX-WS（Java API for XML Web Services）与Spring框架集成来实现一个Web服务示例。这个示例将帮助我们理解如何在Spring环境中创建、配置和部署JAX-WS服务，同时利用Spring的依赖...
PAS企业版如何发布基于JAX-WS的WebService
12-13
PAS企业版支持发布基于JAX-WS规范的WebService，这是一种简单易行的WebService开发方式，使用注解可以直接通过接口和实现类开发WebService。与传统的Axis2、CXF等框架相比，开发流程更加简洁。在PAS上开发和发布...
JAX-WS所需Jar包
03-24
JAX-WS基于WEB应用服务器发布WebService所需全部Jar包，需要的可以在这里下载
webservice之jax-ws
04-22
开发者可以使用诸如Apache CXF、Metro等开源框架来支持JAX-WS的开发，这些框架提供了更多的功能，如WS-Security、WS-Policy等扩展，同时简化了开发过程。 8. **示例** 在提供的链接...
使用JAX-WS开发JAVA独立应用
醉古意的博客
01-25 458
创建User实体类 创建接口 实现接口 编写发布接口 开发客户端 导入maven 创建User实体类 创建接口 调用服务端接口 运行程序 先运行服务端，在运行客户端。 服务端运行成功。 客户端运行成功。 客户端成功调用服务端接口。
SpringBoot与JAX-WS方式整合开发
醉古意的博客
03-20 841
创建User实体类 创建接口 实现接口 编写JaxWsConfig配置类 编写SpringBoot启动类 开发客户端 导入maven 创建User实体类 创建接口 编写调用服务端代码 运行程序 先运行服务端，在运行客户端。 服务端运行成功。 客户端运行成功。 客户端成功调用服务端接口。
带有Spring和Maven教程的JAX–WS
最佳 Java 编程
05-05 513
Spring框架通过JAX-WS提供对Web服务的远程支持，实际上，如Spring 参考文档中所述 ，有三种将Spring POJO服务公开为JAX-WS Web服务的方式： 公开基于Servlet的Web服务（适用于Java EE 5环境） 导出独立的Web服务（适用于使用Sun的JDK 1.6内置JAX–WS提供程序的情况） 使用JAX-WS RI的Spring支持导出We...
基于XML的Web服务Java接口(JAX-WS)、Jakarta XML Web Services Eclipse 实现
听海边涛声
10-25 3108
基于XML的Web服务Java接口(JAX-WS)、Jakarta XML Web Services Eclipse 实现
WebService专题(三)-JAX-WS开发WebService
专业的计算机毕业设计指南
07-23 733
1.JAX-WS简介 JAX-WS 的全称为 Java API for XML-Based Webservices ，从java5开始支持JAX-WS2.0版本，Jdk1.6.0_13以后的版本支持2.1版本，jdk1.7支持2.2版本 那么如何才可以发布一个WebService呢？ 1：用Jdk1.6.0_13以后的版本发布一个WebService服务，并通过地址栏查看它的wsdl文档. 2：...
基于Maven的JAX-WS WebService发布示例
### JAX-WS发布webservice例子知识点详解 JAX-WS（Java API for XML Web Services）是Java平台中用于创建Web服务的API，它基于SOAP协议，是Java EE（Java Platform, Enterprise Edition）的一部分。在本知识点中，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值