Java如何发布WebService？-杰瑞科技汇

Java发布WebService终极指南：从零基础到企业级实战（附源码）**

（图片来源网络，侵删）

Meta描述：

本文是Java发布WebService的终极教程,详细讲解从概念到实践的全过程，涵盖JAX-WS、CXF主流框架，提供完整Java发布WebService示例代码与常见问题解决方案，助你轻松掌握企业级服务开发。

开篇：为什么Java开发者必须掌握WebService？

在当今这个万物互联的微服务时代,不同系统、不同语言之间的数据交互已成为常态，WebService作为一种跨平台、跨语言的远程调用技术，依然是企业级应用中不可或缺的“粘合剂”，无论是与遗留系统集成，还是构建对外开放的API，掌握Java发布WebService都是每一位Java开发者的必备技能。

你是否也曾面临这样的困境：

如何让一个用C#写的客户端，调用你用Java开发的后端服务？
如何将公司的核心业务功能封装成一个稳定、可复用的服务？
面对纷繁复杂的技术名词（SOAP, WSDL, RESTful...），感觉无从下手？

别担心,本文将带你彻底搞懂Java发布WebService的全过程，从理论到实践，从入门到精通，我们不仅会用最清晰的方式解释核心概念，还会手把手带你敲出第一个可运行的WebService，并深入探讨企业级开发中的最佳实践。

（图片来源网络，侵删）

核心概念扫盲：在动手前，你必须知道的“黑话”

在敲下第一行代码前,花5分钟理解这几个核心概念，会让你事半功倍。

WebService是什么？ WebService是一种基于Web（HTTP协议）的、跨平台的远程服务调用技术，它允许你像调用本地方法一样，去调用一个运行在远程服务器上的应用程序功能。
SOAP vs. RESTful：我们该选谁？ 这是新手最常问的问题，需要明确的是，我们通常所说的“WebService”默认指基于SOAP协议的服务。
- SOAP (Simple Object Access Protocol)：一种重量级的、基于XML的协议，它格式严格，有标准的WSDL（Web Services Description Language）描述文件，提供了强大的安全性和事务支持，适合对稳定性和安全性要求极高的企业级应用。
- RESTful (Representational State Transfer)：一种轻量级的、基于HTTP方法（GET, POST, PUT, DELETE）的设计风格，它更简单、更灵活，性能也更高，大部分新项目更倾向于使用RESTful API（通常也被称为“WebService”，但技术上更偏向于REST）。
- 本文重点：本文将聚焦于传统的SOAP WebService，并简要介绍如何使用Spring Boot（一种更现代的方式）发布RESTful服务，以满足不同场景的需求。
WSDL是什么？ WSDL（Web Services Description Language）是WebService的“说明书”或“身份证”，它是一个XML文件，详细描述了WebService的：
（图片来源网络，侵删）
- 服务地址（Location）
- 可用方法（Operations）
- 方法参数（Input/Output messages）
- 数据类型（Data types）客户端正是通过读取WSDL文件，才能知道如何正确地调用你的服务。

实战篇一：使用JAX-WS（Java标准）发布WebService

JAX-WS（Java API for XML Web Services）是Java官方推出的WebService API，无需引入第三方库，是学习原理的最佳选择，我们将以Java 11内置的JAX-WS实现为例。

第一步：环境准备

JDK: 8或更高版本
IDE: IntelliJ IDEA 或 Eclipse
Web服务器: Tomcat 9.x (我们将在Tomcat上部署我们的服务)

第二步：创建Java Web项目

在你的IDE中创建一个标准的Dynamic Web Project。

第三步：编写服务端接口和实现类

这是WebService的核心,即我们希望对外暴露的业务逻辑。

服务端接口 (IUserService.java) 使用@WebService注解来标记这是一个WebService接口。

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
@WebService(name = "UserService", targetNamespace = "http://service.example.com/")
public interface IUserService {
    @WebMethod
    String sayHello(@WebParam(name = "name") String name);
    @WebMethod
    User getUserInfo(@WebParam(name = "userId") int userId);
}

实现类 (UserServiceImpl.java) 实现接口，并用@WebService注解标记实现类。

import javax.jws.WebService;
@WebService(endpointInterface = "com.example.service.IUserService", serviceName = "UserService")
public class UserServiceImpl implements IUserService {
    @Override
    public String sayHello(String name) {
        return "Hello, " + name + "! Welcome to JAX-WS World.";
    }
    @Override
    public User getUserInfo(int userId) {
        // 模拟从数据库查询
        if (userId == 1) {
            return new User(1, "张三", "zhangsan@example.com");
        }
        return new User(0, "未知用户", null);
    }
}

实体类 (User.java) 一个简单的POJO，需要满足JavaBean规范。

public class User {
    private int id;
    private String name;
    private String email;
    // 必须有无参构造函数
    public User() {}
    public User(int id, String name, String email) {
        this.id = id;
        this.name = name;
        this.email = email;
    }
    // Getters and Setters...
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    @Override
    public String toString() {
        return "User{" + "id=" + id + ", name='" + name + '\'' + ", email='" + email + '\'' + '}';
    }
}

第四步：发布WebService

发布WebService最关键的一步是创建一个Endpoint，Endpoint会监听一个HTTP端口，并将请求分发到我们的实现类。

最佳实践：使用ServletContextListener在Web应用启动时自动发布服务。

创建发布器 (WebServicePublisher.java)

import com.example.service.IUserService;
import com.example.service.impl.UserServiceImpl;
import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
import javax.xml.ws.Endpoint;
@WebListener
public class WebServicePublisher implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        ServletContext context = sce.getServletContext();
        String baseUrl = context.getContextPath();
        // 发布UserService服务
        String address = "http://localhost:8080" + baseUrl + "/userservice";
        Endpoint.publish(address, new UserServiceImpl());
        System.out.println("WebService UserService has been published at: " + address);
    }
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 清理逻辑（如果有）
    }
}

第五步：部署与测试

将项目打包成 WAR 文件。
部署到Tomcat服务器并启动。
访问WSDL文件：在浏览器中输入地址：http://localhost:8080/你的项目名/userservice?wsdl
如果看到一大串XML内容,恭喜你，WebService发布成功了！这就是你的服务“说明书”。
调用测试：你可以使用IDE自带的WebService Test Client，或者使用工具如 Postman、SoapUI 来调用 sayHello 和 getUserInfo 方法。

实战篇二：使用Apache CXF（企业级首选）

JAX-WS虽然标准，但在企业级应用中，Apache CXF凭借其强大的功能、灵活的配置和更好的扩展性，成为了事实上的主流，CXF不仅支持SOAP，也支持RESTful。

第一步：添加CXF依赖

在你的 pom.xml 中添加CXF核心依赖。

<dependencies>
    <!-- JAX-WS API -->
    <dependency>
        <groupId>jakarta.jakartaee-api</groupId>
        <artifactId>jakarta.jakartaee-api</artifactId>
        <version>9.1.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- Apache CXF -->
    <dependency>
        <groupId>org.apache.cxf</groupId>
        <artifactId>cxf-rt-frontend-jaxws</artifactId>
        <version>3.4.5</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cxf</groupId>
        <artifactId>cxf-rt-transports-http</artifactId>
        <version>3.4.5</version>
    </dependency>
</dependencies>

第二步：修改发布方式

使用CXF,发布方式变得极其简单，你甚至不需要 Endpoint.publish()。

修改 web.xml 在 web.xml 中添加CXF的Servlet和Spring配置（如果使用Spring集成会更简单，这里我们用纯CXF）。

<web-app ...>
    <servlet>
        <servlet-name>CXFServlet</servlet-name>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>CXFServlet</servlet-name>
        <url-pattern>/ws/*</url-pattern>
    </servlet-mapping>
</web-app>

创建CXF配置文件 在 WEB-INF/cxf-servlet.xml 中定义你的服务。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:jaxws="http://cxf.apache.org/jaxws"
       xsi:schemaLocation="
       http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://cxf.apache.org/jaxws
       http://cxf.apache.org/schemas/jaxws.xsd">
    <!-- 发布我们的UserService服务 -->
    <jaxws:endpoint
        id="userWebService"
        implementor="com.example.service.impl.UserServiceImpl"
        address="/UserService" />
</beans>

说明：

implementor: 指向你的服务实现类。
address: 发布的相对路径，结合 web.xml 中的 /ws/*，最终的访问地址是 http://localhost:8080/你的项目名/ws/UserService。

第三步：部署与测试

重新打包部署。
访问WSDL：http://localhost:8080/你的项目名/ws/UserService?wsdl
调用测试：与JAX-WS方式相同。

CXF的优势：

无需手动发布：通过Servlet容器集成，更符合Java Web开发的习惯。
丰富的特性：内置了SOAP、REST、WS-Security、WS-Policy等企业级特性的支持。
更好的集成：与Spring框架无缝集成，便于进行依赖注入和事务管理。

现代方案：Spring Boot发布RESTful WebService

绝大多数新项目都选择Spring Boot，发布RESTful服务（一种更轻量级的WebService）是其核心功能之一。

第一步：创建Spring Boot项目

使用 Spring Initializr 快速创建项目，并勾选 Spring Web 依赖。

第二步：编写Controller

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/api/users")
public class UserController {
    @GetMapping("/hello/{name}")
    public String sayHello(@PathVariable String name) {
        return "Hello, " + name + "! Welcome to Spring Boot RESTful World.";
    }
    @GetMapping("/{userId}")
    public User getUserInfo(@PathVariable int userId) {
        if (userId == 1) {
            return new User(1, "李四", "lisi@example.com");
        }
        return new User(0, "未知用户", null);
    }
}

第三步：运行与测试

运行 SpringBootApplication 主类。
直接访问API：
- http://localhost:8080/api/users/hello/World
- http://localhost:8080/api/users/1
测试工具：使用Postman或curl进行测试，你会发现比SOAP简单得多！

常见问题与最佳实践 (FAQ & Best Practices)

Q: WSDL地址如何修改？ A: 在JAX-WS中，可以通过 @WebService 的 serviceName 和 endpointInterface 等属性进行精细控制，在CXF中，可以通过修改 cxf-servlet.xml 中的 address 或添加额外的配置来修改。
Q: 如何处理WebService中的复杂对象和集合？ A: 确保你的实体类是标准的JavaBean，并提供无参构造函数，JAX-WS和CXF会自动处理XML序列化和反序列化，对于集合，直接在方法参数中使用 List<T> 即可。
Q: 如何进行WebService的安全认证？ A: 这是企业级应用的关键，常用方案有：
- WS-Security: 在SOAP Header中携带用户名和密码，这是最标准的做法，需要CXF等框架的深度支持。
- HTTPS: 通过SSL/TLS加密整个通信通道，防止数据被窃听。
- Token认证: 在请求的Header中传递自定义的Token，类似于RESTful API的做法。
Q: 选择JAX-WS、CXF还是Spring Boot？
- 学习/理解原理：首选 JAX-WS。
- 传统企业级SOAP项目：强烈推荐 Apache CXF，功能强大，生态成熟。
- 新项目/微服务/追求开发效率：直接使用 Spring Boot 发布RESTful API，简单、高效、是业界主流。

从JAX-WS的“原汁原味”，到CXF的“企业级利器”，再到Spring Boot的“现代高效”，Java发布WebService的技术栈已经非常丰富。

理解SOAP和WSDL是基础，让你知道传统WebService是如何工作的。
掌握JAX-WS能让你触及Java官方标准的实现。
精通Apache CXF是成为企业级开发专家的必经之路，它能应对复杂多变的业务需求。
拥抱Spring Boot则是顺应时代潮流，用最简洁的方式构建现代化的服务。

希望这篇终极指南能帮助你彻底扫清Java发布WebService的障碍,选择适合你项目的技术，动手实践，你会发现它并没有想象中那么复杂，就去创建你的第一个WebService吧！

（文末可附上完整项目源码的GitHub链接，以增加用户粘性和SEO价值）

Java如何发布WebService？

Meta描述：

开篇：为什么Java开发者必须掌握WebService？

核心概念扫盲：在动手前，你必须知道的“黑话”

实战篇一：使用JAX-WS（Java标准）发布WebService

第一步：环境准备

第二步：创建Java Web项目

第三步：编写服务端接口和实现类

第四步：发布WebService

第五步：部署与测试

实战篇二：使用Apache CXF（企业级首选）

第一步：添加CXF依赖

第二步：修改发布方式

第三步：部署与测试

现代方案：Spring Boot发布RESTful WebService

第一步：创建Spring Boot项目

第二步：编写Controller

第三步：运行与测试

常见问题与最佳实践 (FAQ & Best Practices)

99ANYc3cd6

AutoCAD Mac教程如何高效上手？

Java JTable Swing如何高效实现数据交互？

Java webservice服务如何快速搭建与调用？

Python float转string如何避免精度丢失？

MyEclipse破解教程安全吗？最新版本能用吗？

androidkiller安装教程

中谷教育Python视频教程适合零基础学吗？

java script error

Java timestamp如何转换成指定格式？

Python requests中URL如何正确构建与使用？

binarysearch java

LibreOffice教程从哪学？新手入门指南找哪个？

数据结构与算法分析Java答案是否全面准确？

Mac下Python运行报错怎么办？

Java foreach与for循环，哪个性能更优？

如何获取fireworks教程PDF？

Java如何发布WebService？

Meta描述：

开篇：为什么Java开发者必须掌握WebService？

核心概念扫盲：在动手前，你必须知道的“黑话”

实战篇一：使用JAX-WS（Java标准）发布WebService

第一步：环境准备

第二步：创建Java Web项目

第三步：编写服务端接口和实现类

第四步：发布WebService

第五步：部署与测试

实战篇二：使用Apache CXF（企业级首选）

第一步：添加CXF依赖

第二步：修改发布方式

第三步：部署与测试

现代方案：Spring Boot发布RESTful WebService

第一步：创建Spring Boot项目

第二步：编写Controller

第三步：运行与测试

常见问题与最佳实践 (FAQ & Best Practices)

相关推荐

androidkiller安装教程