IntelliJ IDEA 2025.3 Help

启用 Web 服务客户端开发支持

要在 IntelliJ IDEA 中开发一个 web 服务客户端,请配置相应的模块并提供所有必需的库。 此页面上的说明适用于开发以下类型的 web 服务客户端:

  • GlassFish/JAXWS2.X RI/Netro 1.X/JWSDP2.0

  • Apache Axis

  • RESTful Web 服务

安装 Jakarta EE:Web Services (JAX-WS) 插件

此功能依赖于 Jakarta EE: Web Services (JAX-WS)插件,您需要安装并启用。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 打开 Marketplace 选项卡,找到 Jakarta EE:Web Services (JAX-WS)插件,然后点击 安装 (如果提示,请重启 IDE)。

为 Web 服务客户端应用创建项目

  1. 点击 新建项目 在欢迎页面上或选择 文件(F) | 新建(N) | 项目。

  2. 从 生成器 列表中选择 Jakarta EE。

  3. 为新项目命名,选择构建工具、要使用的语言,然后选择 Web 应用程序 项目模板。

  4. 选择 创建Git 仓库 选项,将新项目置于版本控制之下。

  5. 从 JDK 列表中选择您想在项目中使用的 JDK。

    如果 JDK 已安装在您的计算机上,但未在 IDE 中定义,请选择 添加 JDK 并指定 JDK 主目录的路径。

    如果您的计算机上没有必要的 JDK,请选择 下载JDK。

    创建新的 Jakarta EE 项目
  6. 在向导的下一步中,选择要支持的 Jakarta EE 版本。

    从 依赖项 列表中选择 XML Web 服务。

    将 Web 服务 依赖项添加到新项目中
  7. 点击 创建(C)。

为现有项目启用 Web 服务客户端支持

  1. 在编辑器中打开构建文件( pom.xml 或 build.gradle ,取决于您在项目中使用的构建工具)。

  2. 请添加以下依赖项,但请根据您的项目需求更改版本:

    Jakarta EE
    <dependency> <groupId>jakarta.xml.ws</groupId> <artifactId>jakarta.xml.ws-api</artifactId> <version>3.0.1</version> <scope>provided</scope> </dependency>
    Java EE
    <dependency> <groupId>javax.xml.ws</groupId> <artifactId>jaxws-api</artifactId> <version>2.3.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.jws</groupId> <artifactId>javax.jws-api</artifactId> <version>1.1</version> <scope>provided</scope> </dependency>
    Jakarta EE
    compileOnly('jakarta.xml.ws:jakarta.xml.ws-api:3.0.1')
    Java EE
    compileOnly('javax.xml.ws:jaxws-api:2.3.1') compileOnly('javax.jws:javax.jws-api:1.1')
  3. 按 Ctrl+Shift+O 导入更改。

有关使用构建工具的详细信息,请参阅 Maven 或 Gradle。

启用对任何 web service engine 的支持

IntelliJ IDEA 使用 facets 来支持最常见的 Web 服务引擎。 然而,您可以启用任何 Web 服务引擎或实现版本,即使它不受 IntelliJ IDEA facets 支持。

  1. 下载所需的 Web 服务引擎实现。

  2. 按 Ctrl+Alt+S 打开设置,然后选择 工具 | Web 服务。 请指定外部 Web 服务引擎的路径、所需的服务器名称和端口及其他选项。更多信息,请参见 Web 服务。

2026年 1月 23日