java Servlet3.0 使用注解标注Servlet @WebServlet

在Servlet3.0中,可以使用标注(Annotation)来告诉容器哪些Servlet会提供服务以及额外的信息

写个例子

package cn.my.servlet;

import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
* Servlet implementation class MyServlet
*/
@WebServlet("/hello.do")
public class MyServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
System.out.println("hello");
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
}

只要在Servlet上设置@WebServlet标注,容器会自动读取当中的信息.从这个例子中可以看到,如果请求的URL是hello.do,则由MyServlet实例提供服务.

也可以使用@WebServlet提供更多信息

@WebServlet(
name="myServlet",
urlPatterns="hello.do",
loadOnStartup=1,initParams = { @WebInitParam(name = "username", value = "张三") })
public class MyServlet extends HttpServlet {

上面的@WebServlet告知web容器:

MyServlet这个Servlet的名称是myServlet,这是由name属性指定的(name属性如果没有指定的话,默认为Servlet类完整名称)

如果客户端请求
4000
的URL是/hello.do,则由具有myServlet名称的Servlet来处理,这是由urlpatterns属性来指定的.

当应用程序启动后,事实上并没有创建所有的Servlet实例.容器会在首次请求需要某个Servlet服务时,才将对应的Servlet类实例化,进行初始化操作,然后在处理请求.这意味着第一次请求该Servle的客户端,必须等待Servlet类实例化,进行初始动作所必须花费时间,才真正得到请求的处理.

如果希望应用程序启动时,就把Servlet类载入,实例化并做好初始化动作,可以使用loadOnStartup设置.设置大于0的值(默认值-1),表示启动应用程序后就要初始化Servlet(而不是实例化几个Servlet).数字代表了Servlet的初始顺序,容器必须保证有较小数字的Servlet先初始化,在使用标注的情况下,如果有多个Servlet在设置loadOnStartup时使用了相同的数字,则容器实现厂商可以自行决定要如何载入哪个Servlet.

使用@WebServlet将一个继承于javax.servlet.http.HttpServlet的类定义为Servlet组件。

　　@WebServlet有很多的属性：

　　asyncSupported：声明Servlet是否支持异步操作模式。

　　description：　　  Servlet的描述。

　　displayName：     Servlet的显示名称。

　　initParams：        Servlet的init参数。

　　name：　　　　    Servlet的名称。

　　urlPatterns：　　  Servlet的访问URL。

　　value：　　　       Servlet的访问URL。

　　Servlet的访问URL是Servlet的必选属性，可以选择使用urlPatterns或者value定义。

　　像上面的AnnotationServlet可以描述成@WebServlet(name="AnnotationServlet",value="/AnnotationServlet")。

　　也定义多个URL访问：

　　如@WebServlet(name="AnnotationServlet",urlPatterns={"/AnnotationServlet","/AnnotationServlet2"})

　　或者@WebServlet(name="AnnotationServlet",value={"/AnnotationServlet","/AnnotationServlet2"})