第六天·用注解@WebServlet来实现servlet和url映射

本文介绍了如何使用@WebServlet注解替代传统的web.xml配置,以简化Servlet的声明和URL映射。在前言中,作者指出随着Servlet数量增加,web.xml配置文件的维护变得困难。在开发部分,作者给出了一个处理登录功能的Servlet示例,说明了注解的使用方法。最后的总结部分概述了当天的工作进展,包括创建用户表和完成登录功能的前后端交互,同时提到了未完成的DAO层数据处理任务。

 

(一)前言

以往每增加一个Servlet,那么配置web.xml里面就要增加相应的配置,如下 

 <servlet>
        <servlet-name>login</servlet-name>
        <servlet-class>com.exam.servlet.LoginServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>login</servlet-name>
        <url-pattern>/login</url-pattern>
    </servlet-mapping>

随着Servlet越来越多,配置文件会变得越来越长,既影响阅读,也不方便后期维护。因此,建议在Servlet里使用WebServlet注解。

(二)开发

以下为处理登录功能的Servlet(前端以ajax形式发送登录请求)

/**
 * Servlet implementation class Login
 */
@WebServlet("/login")
public class LoginServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
       
    /**
     * @see HttpServlet#HttpServlet()
     */
    public LoginServlet() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doPost(request,response);
    }

    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
     */
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        
        boolean bingo=true;//登录成功标志;
        
        //1、接收参数
        String username=request.getParameter("username");
        String password=request.getParameter("password");
        
        //2、验证参数
        if(username==null||username.length()==0){
            bingo=false;
        }
        
        if(password==null||password.length()==0){
            bingo=false;
        }
        
        //3、数据库验证(略)
        User user=new User(username,password);

        //4、返回结果
        PrintWriter writer=response.getWriter();
        writer.print(bingo);
        writer.flush();

    }

}

(三)总结

  • 今天的工作内容

  1. 数据库:创建用户表

  2. 系统:完成登录功能的前后端交互

  • 未完成内容

  1. DAO层数据处理

<think> 我们正在讨论JavaWeb中@WebServlet注解的使用方法。根据引用内容,@WebServlet注解Servlet 3.0规范引入的,它允许我们不再需要在web.xml中配置Servlet,而是通过注解来简化配置。 接下来,我将按照以下步骤详细说明: 1. @WebServlet注解的基本用法 2. 注解中可配置的属性 3. 注意事项(包括与web.xml的冲突等) 4. 配置样例 5. 常见问题及解决方案 ### 1. @WebServlet注解的基本用法 在Servlet类上使用`@WebServlet`注解,并指定至少一个URL映射(通过`urlPatterns`或`value`属性)。例如: ```java @WebServlet("/hello") public class HelloServlet extends HttpServlet { // ... 重写doGet或doPost等方法 } ``` 这样,Servlet就会映射到`/hello`这个路径上,无需在web.xml中配置。 ### 2. 注解中可配置的属性 `@WebServlet`注解提供了多个属性用于配置Servlet,包括: - `name`:指定Servlet的名称(相当于web.xml中的`<servlet-name>`),默认值为全限定类名。 - `value` 或 `urlPatterns`:指定一组URL映射(相当于`<url-pattern>`),`value``urlPatterns`不能同时使用,但必须至少指定一个。 - `loadOnStartup`:指定Servlet的加载顺序(相当于`<load-on-startup>`),数值越小优先级越高。 - `initParams`:指定Servlet的初始化参数(相当于`<init-param>`),需要使用`@WebInitParam`注解。例如: ```java @WebServlet( name = "MyServlet", urlPatterns = {"/myservlet"}, initParams = { @WebInitParam(name = "param1", value = "value1"), @WebInitParam(name = "param2", value = "value2") } ) ``` ### 3. 注意事项 - **避免与web.xml重复配置**:引用[2]明确指出,如果同时使用web.xml注解配置同一个Servlet(即同一个Servlet类),则web.xml中的`<servlet-name>`不能与注解中的`name`相同,否则容器会忽略注解配置。因此,建议只使用一种配置方式。 - **web.xml的metadata-complete属性**:引用[5]提到,web.xml的顶层标签`<web-app>`有一个`metadata-complete`属性。如果设置为`true`,则容器会忽略所有注解(即注解配置无效);如果设置为`false`或者不设置,则容器会处理注解。因此,若要使用注解,需要确保`metadata-complete="false"`(默认值)或删除该属性。 - **混合配置的情况**:引用[4]提到,注解配置文件(web.xml)可以共存。通常,不会经常变化的配置使用注解,可能变化的配置使用web.xml。但要注意避免重复配置同一Servlet。 ### 4. 配置样例 以下是一个使用多个初始化参数URL映射的样例: ```java @WebServlet( name = "AdvancedServlet", urlPatterns = {"/advanced", "/adv"}, loadOnStartup = 1, initParams = { @WebInitParam(name = "encoding", value = "UTF-8"), @WebInitParam(name = "maxSize", value = "1024") } ) public class AdvancedServlet extends HttpServlet { // ... 代码 } ``` ### 5. 常见问题及解决方案 - **注解无效(Servlet无法访问)**: 1. 检查web.xml中`<web-app>`标签的`metadata-complete`属性是否为`true`,若是则改为`false`或删除。 2. 检查是否同时使用了web.xml配置了同一个Servlet,且名字冲突,需要去掉其中一个配置。 3. 确保项目使用的是Servlet 3.0及以上规范(可以在项目设置中查看JavaEE版本)。 - **出现404错误**: 1. 检查注解中的URL映射是否正确,以及访问的URL是否匹配。 2. 检查Servlet类是否在正确的包路径下,并且被容器正确加载。 ### 总结 使用`@WebServlet`注解可以极大地简化Servlet的配置,使开发更加便捷。但在使用时需要注意与web.xml的配置冲突,以及确保容器支持注解处理(metadata-complete属性设置为false)。对于初始化参数、URL映射等配置,可以直接在注解中完成。 §§相关问题§§ 1. 如何在@WebServlet注解中配置多个URL映射? 2. 使用@WebServlet注解时如何处理Servlet的初始化参数? 3. 为什么有时候@WebServlet注解会失效? 4. 在同一个项目中混合使用注解web.xml配置Servlet需要注意什么? 5. 如何设置Servlet的启动加载顺序(loadOnStartup)? </think> ### JavaWeb中使用@WebServlet注解简化开发的方法 在JavaWeb开发中,`@WebServlet`注解Servlet 3.0规范引入的核心特性,它通过**声明式配置**替代传统的XML配置,显著简化了Servlet开发流程。以下是具体实现方法及注意事项: --- ### 一、基础使用步骤 1. **添加注解Servlet类** 在Servlet类声明前添加`@WebServlet`注解,并指定URL映射: ```java @WebServlet("/user") // 映射到 /user 路径 public class UserServlet extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) { // 业务逻辑 } } ``` 2. **配置初始化参数(可选)** 通过`initParams`属性传递初始化参数: ```java @WebServlet( urlPatterns = "/login", initParams = { @WebInitParam(name = "maxAttempts", value = "3"), @WebInitParam(name = "timeout", value = "300") } ) public class LoginServlet extends HttpServlet { ... } ``` --- ### 二、关键配置属性 | 属性 | 说明 | 示例 | |------|------|------| | `urlPatterns` / `value` | URL映射规则(必选) | `@WebServlet("/api/*")` | | `name` | Servlet名称(默认类名) | `name = "CustomServlet"` | | `loadOnStartup` | 启动加载顺序 | `loadOnStartup = 1` | | `initParams` | 初始化参数 | 见上文示例 | --- ### 三、简化开发的实践技巧 1. **完全替代web.xml** 当所有Servlet使用注解配置时,可删除`web.xml`中的`<servlet>``<servlet-mapping>`节点[^1][^3]。 2. **动态URL模式** 支持多种匹配规则: ```java @WebServlet({"/order", "/order/*", "*.do"}) ``` 3. **与Filter/Listener注解协同** 配合`@WebFilter``@WebListener`实现注解配置: ```java @WebFilter("/*") // 全局过滤器 public class LogFilter implements Filter { ... } ``` --- ### 四、注意事项 1. **避免配置冲突** **禁止**同时使用注解`web.xml`配置同一个Servlet,否则容器可能忽略注解配置[^2][^5]。 2. **启用注解支持** 在`web.xml`中确保`<web-app>`的`metadata-complete`设置为`false`(默认值): ```xml <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" metadata-complete="false"> ``` 3. **变更管理策略** - 固定配置(如URL路由)→ 用注解 - 需动态修改的参数(如数据库连接)→ 保留在`web.xml`中[^4] --- ### 五、常见问题解决 - **注解失效(404错误)**: 检查`metadata-complete="false"`,并确保未在`web.xml`中重复配置同名Servlet[^5]。 - **容器兼容性**: 需使用支持Servlet 3.0+的服务器(Tomcat 7+、Jetty 8+等)。 --- ### 总结 `@WebServlet`通过**代码即配置**的模式,将Servlet注册流程从XML迁移到源码层,减少了配置文件的维护成本。对于新项目建议全注解开发,旧项目迁移时可逐步替换,但需注意避免混合配置冲突[^1][^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值