@WebServlet注解配置Servlet
从Servlet3.0开始,配置Servlet支持注解方式,但还是保留了配置web.xml方式,所有使用Servlet有两种方式:
- Servlet类上使用@WebServlet注解进行配置
- web.xml文件中配置
@WebServlet常用属性
属性 | 类型 | 是否必须 | 说明 |
---|---|---|---|
asyncSupported | boolean | 否 | 指定Servlet是否支持异步操作模式 |
displayName | String | 否 | 指定Servlet显示名称 |
initParams | WebInitParam[] | 否 | 配置初始化参数 |
loadOnStartup | int | 否 | 标记容器是否在应用启动时就加载这个Servlet |
name | String | 否 | 指定Servlet名称 |
urlPatterns/value | String[] | 否 | 这两个属性作用相同,指定Servlet处理的url |
1.UserServlet
通过注解方式配置,web.xml中不需要配置该Servlet
- @WebServlet(name = "myUserServlet",
- urlPatterns = "/user/test",
- loadOnStartup = 1,
- initParams = {
- @WebInitParam(name="name", value="小明"),
- @WebInitParam(name="pwd", value="123456")
- }
- )
- public class UserServlet extends HttpServlet {
- private static final long serialVersionUID = 7109220574468622594L;
- @Override
- public void init(ServletConfig config) throws ServletException {
- super.init(config);
- System.out.println("servlet初始化...");
- }
- @Override
- protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
- response.setContentType("text/html");
- response.setCharacterEncoding("utf-8");
- PrintWriter pw = response.getWriter();
- pw.append("Hello Servlet!<br>" );
- //servletName
- pw.append("servletName:" + getServletName() + "<br>");
- //initParam
- ServletConfig servletConfig = this.getServletConfig();
- Enumeration<String> paramNames = servletConfig.getInitParameterNames();
- while (paramNames.hasMoreElements()) {
- String paramName = paramNames.nextElement();
- pw.append(paramName + ":" + servletConfig.getInitParameter(paramName) + "<br>");
- }
- pw.close();
- }
- @Override
- protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
- doGet(request, response);
- }
- }
2.测试结果
2.1应用启动时,servlet就会初始化,因为配置了loadOnStartup=1
2.2访问/user/test,页面上显示结果;表名参数正确初始化以及自定义的servlet名称
3.注
(1).loadOnStartup属性:标记容器是否在启动应用时就加载Servlet,默认不配置或数值为负数时表示客户端第一次请求Servlet时再加载;0或正数表示启动应用就加载,正数情况下,数值越小,加载该Servlet的优先级越高;
(2).
name属性:可以指定也可以不指定,通过getServletName()可以获取到,若不指定,则为Servlet的完整类名,如:cn.edu.njit.servlet.UserServlet
(3).urlPatterns/value属性: String[]类型,可以配置多个映射,如:urlPatterns={"/user/test", "/user/example"}
(4).在使用注解方式时,需要注意:
- <web-app> </web-app>根元素中不能配置属性metadata-complete="true",否则无法加载Servlet。metadata-complete属性表示通知Web容器是否寻找注解,默认不写或者设置false,容器会扫描注解和Web分片,为Web应用程序构建有效的元数据;设置true,表示将由部署描述符为Web程序提供所有的配置信息
- web.xml中不能再配置该Servlet
(5).urlPatterns的常用规则:
- /*或者/:拦截所有
- *.do:拦截指定后缀
- /user/test:拦截路径
- /user/*.do、/*.do、test*.do都是非法的,启动时候会报错