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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

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

* Apache Axis

* RESTful Web 服务

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

此功能依赖于插件，您需要安装并启用它。

> **Note:**
> Jakarta EE：Web Services (JAX-WS) 插件在没有 Ultimate 订阅的 IntelliJ IDEA 中不可用。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Jakarta EE: Web Services (JAX-WS)  插件，然后点击   安装  。 如果出现提示，请重启 IDE。

Procedure: 创建使用 JAX-WS 的新 Jakarta EE 项目

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 从左侧的   生成器   列表中，选择 ![Jakarta EE 徽标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.java.ultimate.icons.icons.javaee.newui.jakartaEE.svg)   Jakarta EE  。

![Jakarta EE 项目向导的第一步](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_new_project_step_1_web.png)

3. 选择   Web 应用程序   模板，并设置其余的 [Jakarta EE 项目设置](new-project-wizard.html#java-ee)。

准备就绪后，点击   下一步  。

4. 从   版本   下拉菜单中选择要使用的 Jakarta EE 版本。

5. 从   依赖项   列表中，选择   XML Web 服务 (JAX-WS)   以及要包含在项目中的任何其他规范或实现。 由于 web 应用程序模板，   Servlet   规范已选中。

![将 Web 服务 依赖项添加到新项目中](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_new_project_step_2_jax_ws.png)

6. 点击   创建  。

有关创建 Jakarta EE 项目的更多信息，例如如何设置应用程序服务器，请参阅 [教程：您的第一个 Jakarta EE 应用程序](creating-and-running-your-first-jakarta-ee-application.html)。

Procedure: 将 JAX-WS 添加到现有项目

1. 在编辑器中打开构建文件（  `pom.xml`  或  `build.gradle` ，具体取决于项目中使用的 [构建工具](build-tools.html)）。

2. 添加 JAX-WS 库，并确保其版本与项目的其他部分匹配：

Maven:

Jakarta EE
: ```XML
: <dependency>
: <groupId>jakarta.xml.ws</groupId>
: <artifactId>jakarta.xml.ws-api</artifactId>
: <version>4.0.2</version>
: </dependency>
:
: ```

Java EE
: ```XML
: <dependency>
: <groupId>javax.xml.ws</groupId>
: <artifactId>jaxws-api</artifactId>
: <version>2.3.1</version>
: </dependency>
: <dependency>
: <groupId>javax.jws</groupId>
: <artifactId>javax.jws-api</artifactId>
: <version>1.1</version>
: </dependency>
:
: ```

Gradle (Groovy):

Jakarta EE
: ```GROOVY
: implementation 'jakarta.xml.ws:jakarta.xml.ws-api:4.0.2'
:
: ```

Java EE
: ```GROOVY
: implementation 'javax.xml.ws:jaxws-api:2.3.1'
: implementation 'javax.jws:javax.jws-api:1.1'
:
: ```

Gradle (Kotlin):

Jakarta EE
: ```KOTLIN
: implementation("jakarta.xml.ws:jakarta.xml.ws-api:4.0.2")
:
: ```

Java EE
: ```KOTLIN
: implementation("javax.xml.ws:jaxws-api:2.3.1")
: implementation("javax.jws:javax.jws-api:1.1")
:
: ```

3. 按 `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) 导入更改。

有关使用构建工具的更多信息，请参阅 [Maven](maven-support.html) 或 [Gradle](gradle.html)。

Procedure: 启用对任何 web service engine 的支持

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

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

2. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `工具 | Web 服务` 。 请指定外部 Web 服务引擎的路径、所需的服务器名称和端口及其他选项。更多信息，请参见 [Web 服务](web-services-settings.html)。

## See also

### 概念

[Web 服务](web-services.html) [Web 服务客户端](web-service-clients.html)

### 过程

[Web 服务客户端](web-service-clients.html) [Web 服务](web-services.html)

### 参考

[Web 服务引用](web-services-reference.html)