转自:http://hi.baidu.com/jackfrued/blog/item/eed1b9108cd00b0a213f2e29.html
本文将向读者简要介绍Servlet 3.0中引入的各种新特性。然后,我们将通过示例代码详细讲解Servlet 3.0的过滤器和监听器的用法。同时,我们还将讨论如何将框架及其他程序库插入一个web应用中。 本文最后简要讨论Servlet 3.0对异步处理的支持,以及对现有API的重要改进之处。
一、Servlet 3.0新特性简述
Servlet 3.0规范为使用它的开发人员实现了以下目标:
为了使开发过程更加轻松,Servlet 3.0引入了注释。类似于EJB 3.1的改变,注释的引入使得web部署描述符web.xml成为可选项。
可插性
每当我们使用第三方框架如Struts、JSF或者Spring的时候,我们需要在web.xml中为相应的Servlet添加相应的条目,这使得web部署描述符变得繁琐并且难以维护。 Servlet 3.0中引入的可插性使得web应用程序更加模块化,也更加易于维护。由于可插性是通过web片段来实现的,所以它使得开发人员不必再在web.xml中建立太多的Servlet配置条目。
异步处理
新的Servlet规范中的另一项重大变化是支持异步处理,这对于AJAX应用程序来说是一个非常有用的特性。当Servlet创建发送请求的线程的时候,它通常必须等待诸如数据库或者消息连接等资源返回响应,之后它才能在这个线程中执行其他操作。异步处理通过允许线程执行其它的操作而避免了这样的阻塞式请求。
除了上面提到的特性之外,新规范还对现有的API做了改进处理,相关内容将在本文末尾部分进行详细介绍。
注意:为了运行使用Servlet 3.0开发的Servlet,我们的servlet 容器应该运行在Java SE 6或更高版本中。
二、Servlet中的注释
Servlet 3.0中的重大革新之一是支持注释。通过使用注释定义Servlet和过滤器,就无需在web部署描述符(web.xml)中建立Servlet/过滤器条目了。
@WebServlet
为了在web应用中定义Servlet组件,我们可以使用@WebServlet。我们可以将其用于继承类javax.servlet.http.HttpServlet的类。注释@WebServlet具有许多属性。例如name、urlPatterns和initParams,我们可以通过它们来定义Servlet的行为。对于url模式,我们必须规定注释本身,或者规定注释的属性。
我们可以利用@WebServlet定义一个简单的Servlet,如下所示:
@WebServlet(name
=
"
GetQuoteServlet
"
, urlPatterns
=
{
"
/getquote
"
})
public
class
GetQuoteServlet
extends
HttpServlet{
@Override
protected
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
PrintWriter out
=
response.getWriter();
try
{
String symbol
=
request.getParam
eter ("symbol"
);
out.println(
"Stock Price is
"
+
StockQuoteBean.getPrice(symbol);
}
finally
{
out.close();
}
}
}
public
class
StockQuoteBean {
private
StockQuoteServiceEntity serviceEntity
=
new
StockQuoteServiceEntity();
public
double
getPrice(String symbol) {
if
(symbol
!=
null
) {
return
serviceEntity.getPrice(symbol);
}
else
{
return
0.0
;
}
}
}
我们可以修改这个Servlet,让它使用注释属性处理来自多个url的请求。
@WebServlet(name
=
"
GetQuoteServlet
"
, urlPatterns
=
{
"
/getquote
"
,
"
/stockquote
"
} )
public
class
GetQuoteServlet
extends
HttpServlet {
@Override
protected
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
PrintWriter out
=
response.getWriter();
try
{
String symbol
=
request.getParameter(
"
symbol
"
);
out.println(
"Stock Price is" +
StockQuoteBean.getPrice(symbol);
}
finally
{
out.close();
}
}
}
@WebFilter
我们可以使用注释@WebFilter来定义过滤器。这个注释还具有可选参数。我们可以在任何实现了javax.servlet.Filter接口的类上使用@WebFilter。类似于@WebServlet注释,我们也必须为这个注释指定url模式。
@WebFilter(filterName
=
"
AuthenticateFilter
"
, urlPatterns
=
{
"
/stock.jsp
"
,
"
/getquote
"
})
public
class
AuthenticateFilter
implements
Filter {
public
void
doFilter(ServletRequest request, ServletResponse response,
FilterChain chain)
throws
IOException, ServletException {
String username
=
((HttpServletRequest) request).getParameter(
"
uname
"
);
String password
=
((HttpServletRequest) request).getParameter(
"
password
"
);
if
(username
==
null
||
password
==
null
) {
((HttpServletResponse) response).sendRedirect(
"
index.jsp
"
); }
if
(username.equals(
"
admin
"
)
&&
password.equals(
"
admin
"
)) {
chain.doFilter(request, response); }
else
{
((HttpServletResponse) response).sendRedirect(
"
index.jsp
"
); }
}
public
void
destroy() {
}
public
void
init(FilterConfig filterConfig) {
}
}
@WebInitParam
我们可以使用注释@WebInitParam把init参数指定为Servlet或者过滤器。另外,我们还可以使用注释@WebFilter和@WebServlet 的initParam属性来规定init参数。
@WebServlet(name
=
"
GetQuoteServlet
"
, urlPatterns
=
{
"
/getquote
"
})
@WebInitParam(name
=
"
default_market
"
, value
=
"
NASDAQ
"
)
public
class
GetQuoteServlet
extends
HttpServlet {
@Override
protected
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
response.setContentType(
"
text/html;charset=UTF-8
"
);
PrintWriter out
=
response.getWriter();
try
{
String market
=
getInitParameter(
"
default_market
"
);
String symbol
=
request.getParameter(
"
symbol
"
);
out.println("S
tock Price in" + market + "is"
+
StockQuoteBean.getPrice(symbol, market));
}
finally
{
out.close();
}
}
}
下面是一个将注释@WebInitParam用作@WebServlet和@WebFilter initParams 属性的一部分的例子:
@WebServlet(name
=
"
GetQuoteServlet
"
,
urlPatterns
=
{
"
/getquote
"
},
initParams
=
{@WebInitParam(name
=
"
default_market
"
, value
=
"
NASDAQ
"
)}
)
public
class
GetQuoteServlet
extends
HttpServlet {
@Override
protected
void
doGet(HttpServletRequest request, HttpServletResponse response)
throws
ServletException, IOException {
response.setContentType(
"
text/html;charset=UTF-8
"
);
PrintWriter out
=
response.getWriter();
try
{
String market
=
getInitParameter(
"
default_market
"
);
String symbol
=
request.getParameter(
"
symbol
"
);
out.println(
"
Stock Price in" +market + "is
" + StockQuoteBean.getPrice(symbol, market));
}
finally
{
out.close();
}
}
}
@WebListener
我们可以将注释@WebListener用于充当给定web应用上下文中各种web应用事件的监听器的类。我们可以使用@WebListener来标注一个实现ServletContextListener、ServletContextAttributeListener、ServletRequestListener、ServletRequestAttributeListener、HttpSessionListener和HttpSessionAttributeListener的类。下面是一个使用ServletContextListener的例子:
@WebListener
public
class
QuoteServletContextListener
implements
ServletContextListener {
public
void
contextInitialized(ServletContextEvent sce) {
ServletContext context
=
sce.getServletContext();
context.setInitParameter(“default_market”, “NASDAQ”);
}
public
void
contextDestroyed(ServletContextEvent sce) {
}
}
@MultipartConfig
使用注释@MultipartConfig可以为Servlet指定多部分组成的MIME类型请求。MIME附件是从该请求对象中读取的。
三、元数据和通用注释
除了上面描述的特定于Servlet的注释之外,Servlet 3.0还支持所有定义为JSR 175(Java元数据规范)和JSR 250(用于Java平台通用注释) 的一部分的注释,包括:
- 与安全有关的注释,诸如@DeclareRoles 和@RolesAllowed
- 使用EJB的注释,诸如@EJB和@EJBs
- 用于资源注入的注释,诸如@resource和@Resources
- 使用JPA的注释,诸如@PersistenceContext、@PersistenceContexts、@PersistenceUnit和@PersistenceUnits
- 生命周期注释,诸如@PostConstruct 和@PreDestroy
- 提供web服务索引的注释,诸如@WebServiceRef 和@WebServiceRefs
四、注释,还是web.xml?
注释的引入使得web部署描述符(web.xml)成为配置web组件时的可选项,而非强制性的。然而,如果您必须对配置进行修改或者更新的话,您可能仍然会使用部署描述符。容器将根据描述符web.xml中的metadata-complete元素的值来决定使用web.xml或者注释。如果该属性的值为true,那么容器就不会处理注释和web片段;部署描述符是所有的元数据信息的唯一来源。只有当该元素metadata-complete不存在或其值不为true时才,容器才会处理注释和web片段。
五、针对Web框架的可插性
就像前面所说的那样,Servlet 3.0的某些改进使得我们可以将框架和程序库插入一个web应用。这个特性减少了配置的数量,并为web应用程序提供了更好的模块性。 Servlet 3.0是通过web模块部署描述符片段(或者简称web片段)来实现可插性的。
Web片段是框架JAR的META-INF目录中的web.xml文件的一部分。web片段提供了web应用的逻辑划分,而不必编辑特定框架组件的web部署描述符。
用于web片段的元素(标签)跟用于部署描述符的元素(标签)几乎完全一样,只是根元素(父标签)除外。Web片段的根元素应该为web-fragment,并且该文件应该名为web-fragment.xml。容器只会从WEB-INF\lib文件夹中的JAR文件中查找web-fragment.xml文件。 如果lib目录中的JAR文件含有任何web-fragment.xml文件,容器将加载所需的类,并进行处理。
恰如Servlet名称应该在给定web.xml文件中保持唯一性一样,web片段也应如此。此外,Servlet名称必须在整个web应用中保持唯一,包括web.xml连同其他一切web片段。
作为一个例子,以下web-fragment.xml将被放到框架的jars\META-INF目录中:
web-fragment.xml
<
web-fragment
line-height: normal; color: #0000ff; padding: 0
分享到:
评论