# 创建 Web 应用程序元素

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

Web 应用程序的元素和部署设置在 Web 模块部署描述符  `web.xml`  中定义，该描述符在您 [启用模块的 Web 应用程序支持](enabling-web-application-support.html)时自动创建。

为了与用户界面保持一致，模块部署描述符也称为  Assembly Descriptors 。

您可以使用编辑器，并利用 IntelliJ IDEA 代码辅助功能来编辑源代码。

## 定义 Web 应用程序元素的模板

IntelliJ IDEA 未提供创建 servlets、listeners 和 filters 的默认模板。 不过，您可以自行定义这些模板。

Servlet:

[Servlets](https://docs.oracle.com/javaee/5/tutorial/doc/bnafe.html) 作为 Web 应用程序的一部分，通过  `<servlet>`  和  `<servlet-name>`  元素在  `web.xml`  Web 应用程序部署描述符中创建和配置。

Procedure:

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. 在   文件   选项卡上，点击 ![创建模板](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以创建新的文件模板。

3. 将新模板的名称设为  `Servlet` ，并将  `Servlet`  指定为文件名。 确保扩展程序为  `java` 。

4. 请将以下代码粘贴为模板主体：

```JAVA
                        #if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")

import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.*;
import java.io.IOException;

@WebServlet(name = "${Class_Name}", value = "/${Class_Name}")
public class ${Class_Name} extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    }

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    }
}
```

5. 应用更改并关闭对话框。

![为 web 应用程序的筛选器元素定义模板](https://resources.jetbrains.com/help/img/idea/2026.3/web-element-servlet-template.png)

Servlet  元素定义了 servlet 的名称并指定了实现它的已编译类。 或者，您可以指定 JSP，而不是指定 servlet 类。

Servlet 元素还包含初始化属性的定义。

请注意，您可以在编辑器中使用注解，将与调用 servlet 的 URL 集相关联的 URL 模式映射到 servlet。

监听器:

侦听器接收与 Web 应用程序相关的任何事件的通知，例如 Web 应用程序的部署/卸载、HTTP 会话的激活/停用，以及应用程序/会话属性的添加、删除和替换。

Procedure:

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. 在   文件   选项卡上，点击 ![创建模板](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以创建新的文件模板。

3. 将新模板的名称设为  `监听器` ，并将  `监听器`  指定为文件名。 确保扩展程序为  `java` 。

4. 请将以下代码粘贴为模板主体：

```JAVA
                        #if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")

import javax.servlet.*;
import javax.servlet.http.*;

public class ${Class_Name} implements ServletContextListener, HttpSessionListener, HttpSessionAttributeListener {

    public ${Class_Name}() {}

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        /* This method is called when the servlet context is initialized(when the Web application is deployed). */
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        /* This method is called when the servlet Context is undeployed or Application Server shuts down. */
    }

    @Override
    public void sessionCreated(HttpSessionEvent se) {
        /* Session is created. */
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        /* Session is destroyed. */
    }

    @Override
    public void attributeAdded(HttpSessionBindingEvent sbe) {
        /* This method is called when an attribute is added to a session. */
    }

    @Override
    public void attributeRemoved(HttpSessionBindingEvent sbe) {
        /* This method is called when an attribute is removed from a session. */
    }

    @Override
    public void attributeReplaced(HttpSessionBindingEvent sbe) {
        /* This method is called when an attribute is replaced in a session. */
    }
}
```

5. 应用更改并关闭对话框。

![为 web 应用程序的筛选器元素定义模板](https://resources.jetbrains.com/help/img/idea/2026.3/web-element-listener-template.png)

过滤器:

Procedure:

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. 在   文件   选项卡上，点击 ![创建模板](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以创建新的文件模板。

3. 将新模板的名称设为  `过滤器` ，并将  `过滤器`  指定为文件名。 确保扩展程序为  `java` 。

4. 请将以下代码粘贴为模板主体：

```JAVA
                        #if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
#parse("File Header.java")

import javax.servlet.*;
import javax.servlet.annotation.*;

@WebFilter(filterName = "${Class_Name}")
public class ${Class_Name} implements Filter {
    public void init(FilterConfig config) throws ServletException {
    }

    public void destroy() {
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws ServletException, IOException {
        chain.doFilter(request, response);
    }
}
```

5. 应用更改并关闭对话框。

![为 web 应用程序的筛选器元素定义模板](https://resources.jetbrains.com/help/img/idea/2026.3/web-element-filter-template.png)

## 添加元素

在添加新元素之前，请确保您已经为其 [创建了文件模板](#elements-templates)。

Procedure:

1. 在   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 或  `视图 | 工具窗口 | 项目` ），右键点击 [包](add-items-to-project.html#new-package)所在的   Web  模块并选择   Servlet  、   过滤器  或   监听器  。

2. 为新元素命名并点击   OK  。

## See also

### 过程

[Jakarta EE](java-ee.html)