---

前言

• 在 Java Web 開發中，Servlet 是構建 Web 應用程序的基礎組件。
• 而注解作為 Java 語言的一項重要特性，在 Servlet 開發中也發揮著關鍵作用。
• 通過注解，我們可以更加簡潔、高效地配置和管理 Servlet 相關的代碼。
• 本文將深入探討 Java Servlet 注解的相關知識。

我的個人主頁，歡迎來閱讀我的其他文章
https://blog.csdn.net/2402_83322742?spm=1011.2415.3001.5343
我的Java-servlet文章專欄
歡迎來閱讀指出不足
https://blog.csdn.net/2402_83322742/category_12907265.html?spm=1001.2014.3001.5482

一、注解的基本概念

• 注解（Annotation）是 JDK 1.5 引入的新特性，它提供了一種將元數據嵌入代碼的方式。
• 注解本身不會對代碼邏輯產生直接影響，但可被工具（如編譯器、IDE、運行時環境）用于處理和分析代碼。注解使用 @ 符號聲明，像 @Override、@Deprecated 等都是常見的注解。

簡單來說，注解的作用是簡化 web.xml 的配置，能替代 web.xml 中的 <servlet> 和 <servlet - mapping> 等配置，有助于更好地配置 Java 文件，

• 注解甚至可以完全取代 web.xml 配置。

二、@Override 注解

2.1 作用與優勢

@Override 注解是 Java 中常用的注解之一，用于標識一個方法是重寫父類中的方法。使用它有以下好處：

好處	說明
編譯器檢查	編譯器會檢查被 @Override 注解的方法是否真的重寫了父類的方法，若不是則報錯，避免因方法簽名錯誤導致的運行時錯誤。
代碼可讀性	使代碼更清晰，讓閱讀者一眼就能看出該方法是重寫方法。

2.2 示例代碼

以下是 @Override 注解在 Servlet 中的使用示例：

@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) {// 業務邏輯
}

詳細代碼如下：

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;public class MyServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//解決亂碼resp.setContentType("text/html");resp.setCharacterEncoding("UTF-8");//獲取請求參數String username = req.getParameter("username");String password = req.getParameter("password");//返回到頁面顯示resp.getWriter().write("歡迎" + username + "你的密碼是：" + password);}
}

• 這里 @Override 注解的作用是標記 doGet 方法為父類方法的重寫
• 其優勢在于讓編譯器檢查重寫的合法性，避免拼寫錯誤。

三、@Target 注解

3.1 定義與用途

@Target 注解用于指定一個注解可以應用到哪些元素上。其定義如下：

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {ElementType[] value();
}

ElementType 是一個枚舉類型，定義了可以應用注解的元素類型，常見的有：

元素類型	說明
TYPE	應用于類、接口（包括注解類型）和枚舉類型。
FIELD	應用于字段（包括枚舉常量）。
METHOD	應用于方法。
PARAMETER	應用于方法的參數。
CONSTRUCTOR	應用于構造函數。
LOCAL_VARIABLE	應用于局部變量。

3.2 示例代碼

以下是自定義注解并使用 @Target 注解限制其應用范圍的示例：

import java.lang.annotation.ElementType;
import java.lang.annotation.Target;@Target(ElementType.METHOD)
public @interface MyMethodAnnotation {String value() default "";
}

上述代碼定義了一個 @MyMethodAnnotation 注解，它只能應用于方法上。

四、@WebServlet 注解

4.1 作用

@WebServlet 注解用于將一個類聲明為 Servlet，它可以替代 web.xml 中 <servlet> 和 <servlet - mapping> 的配置。通過該注解，我們可以直接在 Servlet 類上指定訪問路徑、初始化參數等信息。

4.2 示例代碼

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;@WebServlet("/myServlet")
public class MyWebServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {resp.getWriter().write("Hello from MyWebServlet!");}
}

在上述代碼中，@WebServlet("/myServlet") 表示該 Servlet 的訪問路徑為 /myServlet。當客戶端訪問該路徑時，會執行 doGet 方法并返回響應信息。

五、反射與注解

5.1 反射的概念

反射是 Java 語言的強大特性，它允許程序在運行時獲取類的信息，包括類的屬性、方法、構造函數等。

5.2 注解與反射的結合使用

注解與反射結合，可以在運行時動態地處理注解信息。例如，通過反射獲取一個類中被特定注解標記的方法，并執行這些方法：

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;public class AnnotationReflectionExample {@MyMethodAnnotation("example method")public void myMethod() {System.out.println("This is my method.");}public static void main(String[] args) throws NoSuchMethodException {AnnotationReflectionExample example = new AnnotationReflectionExample();Class<?> clazz = example.getClass();Method method = clazz.getMethod("myMethod");MyMethodAnnotation annotation = method.getAnnotation(MyMethodAnnotation.class);if (annotation != null) {System.out.println("Annotation value: " + annotation.value());try {method.invoke(example);} catch (Exception e) {e.printStackTrace();}}}
}

在上述代碼中，通過反射獲取了 myMethod 方法上的 @MyMethodAnnotation 注解，并執行了該方法。

六、為什么選擇 Servlet 注解

在 Servlet 開發中使用注解有以下優點：

優點	說明
簡化配置	傳統的 Servlet 配置需在 web.xml 文件中進行繁瑣配置，使用注解可直接在代碼中配置，使代碼更簡潔。
提高開發效率	注解可在編譯時進行檢查，及時發現錯誤，減少調試時間。
代碼維護性好	注解與代碼緊密結合，使代碼意圖更清晰，便于維護和理解。

七、其他常見的 Servlet 注解及使用方法

7.1 @WebFilter 注解

@WebFilter 注解用于將一個類聲明為過濾器，它可以指定過濾器的過濾路徑、初始化參數等。

import javax.servlet.annotation.WebFilter;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import java.io.IOException;@WebFilter("/filter/*")
public class MyFilter implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {// 初始化過濾器}@Overridepublic void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {System.out.println("Before filter");filterChain.doFilter(servletRequest, servletResponse);System.out.println("After filter");}@Overridepublic void destroy() {// 銷毀過濾器}
}

7.2 @WebListener 注解

@WebListener 注解用于將一個類聲明為監聽器，它可以監聽 Servlet 上下文、會話、請求等事件。

import javax.servlet.annotation.WebListener;
import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;@WebListener
public class MySessionListener implements HttpSessionListener {@Overridepublic void sessionCreated(HttpSessionEvent se) {System.out.println("Session created: " + se.getSession().getId());}@Overridepublic void sessionDestroyed(HttpSessionEvent se) {System.out.println("Session destroyed: " + se.getSession().getId());}
}

---

以上就是這篇博客的全部內容，下一篇我們將繼續探索 Java-servlet 的更多精彩內容。

我的個人主頁，歡迎來閱讀我的其他文章
https://blog.csdn.net/2402_83322742?spm=1011.2415.3001.5343
我的Java-servlet文章專欄
歡迎來閱讀指出不足
https://blog.csdn.net/2402_83322742/category_12907265.html?spm=1001.2014.3001.5482

非常感謝您的閱讀，喜歡的話記得三連哦