Java Servlet是与平台无关的服务器端组件,运行于Servlet容器中(如Tomcat),Servlet容器负责Servlet和客户端的通信以及调用Servlet的方法,Servlet和客户端的通信采用“请求/响应”的模式。Servlet可完成以下功能:
1、创建并返回基于客户请求的动态HTML页面。
2、创建可以嵌入到现有HTML页面中的HTML片段。
3、与其它服务器资源(如数据库或基于Java的应用程序)进行通信。
4、接收多个客户端的输入,并将结果广播到多个客户端上,例如,Servlet可以实现支持多个参与者的游戏服务器。
5、根据客户请求采用特定的MIME(Multipurpose Internet Mail Extensions)类型对数据过滤,例如进行图像格式转换。
Servlet的框架由两个包组成:javax.servlet和javax.servlet.http。在javax.servlet包中定义了所有Servlet类必须实现或扩展的通用接口和类。在javax.servlet.http包中定义了采用HTTP协议通信的HttpServlet类。
Servlet框架的核心是javax.servlet.Servlet接口,所有的Servlet类都必须实现这个接口。Servlet接口定义的方法如下:
1、init方法,负责初始化Servlet对象。
2、service方法,负责响应客户端的请求。
3、destroy方法,当Servlet对象退出生命周期时,负责释放占用的资源。
4、getServletConfig方法,获得ServletConfig接口,可以得到Servlet的相关参数。
5、getServletInfo方法,获得Servlet的相关信息。
在javax.servlet包中,GenericServlet类实现了Servlet接口,在javax.servlet.http包中,HttpServlet类扩展了GenericServlet
类。当用户开发自己的Servlet时,必须扩展以上两个类中的一个,如果扩展自GenericServlet类,则必须自己实现service方法,
如果扩展自HttpServlet类,则不需要自己实现service方法,因为HttpServlet类已经实现了该方法。
GenericServlet类的service方法是一个抽象方法,只有两个参数:ServletRequest和ServletResponse。HttpServlet类的service方法也只有两个参数:HttpServletRequest和HttpServletResponse。HttpSevletRequest接口和HttpResponse接口分别扩展自ServletRequest和ServletResponse接口,都提供了与特定协议HTTP相关的数据。
ServletRequest接口的方法如下:
getAttribute 获得属性值
getContentType 获得客户请求数据的MIME类型。
getInputStream 获得可以读取客户请求数据的输入流。
getParameter 获得参数值
getRemoteAddr 获得客户端的IP
getRemoteHost 获得客户端的主机名
getRemotePort 获得客户端的端口
setAttribute 设置属性值。
ServletResponse接口的方法如下:
getOutputStream 获得可以向客户羰发送二进制数据的输出流对象ServletOutputStream
getWriter 获得可以向客户端发送字符数据的PrintWriter对象
getCharacterEncoding 获得Servlet发送的响应数据的字符编码
getContentType 返回Servlet发送的响应数据的MIME类型
setCharacterEncoding 设置Servlet发送的响应数据的字符编码。
setContentType 设置Servlet发送的响应数据的MIME类型。
Servlet的init方法有如下两种形式:
public void init(ServletConfig config) throws ServletException
public void init() throws ServletException
在Servlet的初始化分阶段,Servlet容器会为Servlet创建一个ServletConfig对象,用来存放Servlet的初始化配置信息,如Servlet的初始参数。如果Servlet覆盖了带参数的init方法,则必须在函数体内先调用super.init(config); 以确保config参数引用了ServletConfig对象。如果Servlet覆盖了没有带参数的init方法,则不需要调用super.init(); 方法,可以通过调用getServletConfig()方法来获得ServletConfig对象。
Servlet容器会为Web应用创建一个唯一的全局的ServletContext对象,可以把它看成是一个Web应用的服务器端组件的共享内存。它有如下方法:
etAttribute(String name,Object obj) 将一个对象与一个属性名绑定,并存放到
ServletContext中
getAttribute(String name) 获得指定名称的属性值。
removeAttribute(String name) 删除指定名称的属性。
getAttributeNames() 返回所有属性名的一个Enumeration对象。
getInitParameter(String name) 获得指定名称的参数值,该参数是Web应用的初始化参数.
getInitParameterNames() 返回Web应用的所有初始化参数的名称的Enumeration对象.
getMimeType(String file) 返回文件的MIME类型.
getRealPath(String path) 返回网络路径path对应的文件系统路径.
getServerInfo() 返回Servlet容器的名称和版本
注意: 一般在HptpServlet的子类中,将doPost方法的实现合并到doGet方法中,也就是在doPost方法中简单地调用doGet方法.因为一般情况下对于Get和Post请求,它们都是一样的处理.
编译了Servlet后,将它打包成jar放到WEB-INF/lib目录下,或将Servlet的class文件放到WEB-INF/classes/目录下,再在WEB-INF/web.xml配置文件中配置这些servlet,就可以在Web应用中访问servlet了,配置如下:
<servlet>
<servlet-name>my_servlet</servlet-name>
<servlet-class>com.mycompany.ServletClass1</servlet-class>
< init-param> <!--定义servlet的初始化参数, 可以有多个init-param参数-->
< param-name>iParam< /param-name>
< param-value>2< /param-value>
< /init-param>
< load-on-startup>2< /load-on-startup> <!--定义servlet的加载顺序-->
</servlet>
<servlet-mapping>
<servlet-name>my_servlet</servlet-name>
<url-pattern>*.hello</url-pattern>
</servlet-mapping>
Session相关
在Servlet API中定义了javax.servlet.http.HttpSession接口,Servlet容器必须实现这一个接口。当一个Session开始时,Servlet容器将创建一个HttpSession对象,在HttpSession对象中可以存放客户状态的信息。Servlet容器为HttpSession对象分配一个唯一的标识符,叫做Session ID,Servlet容器把Session ID作为Cookie保存在客户的浏览器中,每次客户发出HTTP请求时,Servlet容器可以从HttpRequest对象中读取Session ID,然后根据Session ID找到相应的HttpSession对象,从而获得客户的状态信息。HttpSession接口有如下方法:
getId() 返回Session ID
invalidate() 使当前的Session失效,Servlet容器会释放HttpSession对象占用的资源。
setAttribute(String name,Object obj) 将一对name/value属性保存到HttpSession对象中。
getAttribute(String name) 返回名字为name的属性值。
getAttributeNames() 返回HttpSession对象中所有的属性名。
isNew() 判断这个Session是不是新创建的。
setMaxInactiveInterval() 设定Session可以处于不活动状态的最大时间(以秒为单位), 超过这个时间,Session就会自动失效,如果设置为负数,则不 限制Session的不活动状态时间。
getMaxInactiveInterval() 返回Session可以处于不活动状态的最大时间。
当客户第一次访问Web应用中支持Session的某个页面时,就会开始一个新的Session,接下来,当客户浏览这个Web应用的其它页面时,始终处于同一个Session中。以下情况之一,Session就会失效:
1、客户端关闭浏览器。
2、Session过期,即客户在指定的最大时间内没有与Web服务器交互。
3、服务器端调用了HttpSession的invalidate()方法。
如果客户端浏览器不支持或禁用Cookie,则Servlet容器无法从客户端浏览器中取得作为Cookie的Session ID,也就无法跟踪客户的状态,因此客户端的每次请求支持Session的JSP页面时,Servlet容器都会创建一个新的HttpSession对象。对于这种情况,需要通过HttpServletResponse的encodeURL()方法重写客户请求的URL,它把Session ID添加到URL信息中,也就是说,对于支持Session的JSP页面中的所有连接URL,都要调用encodeURL()方法来重写这些URL,例如:
对于<a href=”login.jsp”/>应该改为<a href=”<%=response.encodeURL(“login.jsp”)%>”/>
这样,即使客户禁用Cookie,也能使用Session来跟踪客户的状态信息了。
Session的持久化:
Session的持久化就是将HttpSession对象从内存中转移到文件系统或数据库中,这样做的好处是:减少系统资源的占用,如果Servlet容器突然关闭或重启,或Web应用重启,这些持久化了的HttpSession对象可以再重新加载进来,对于客户端,还是使用同一个Session。
Session的持久化是由Session Manager来管理的,Tomcat提供了两个实现类:
l org.apache.catalina.session.StandarManager
l org.apache.catalina.session.PersistentManager
1、StandarManager是默认的Session Manager。它的实现机制是:当Tomcat服务器关闭或重启,或Web应用被重新加载时,会将内存中所有的HttpSession对象保存到文件系统中,默认的文件路径是:%CATALINA_HOME%\work\Catalina\<applicaton-name>\SESSIONS.ser
重启Tomcat后,Tomcat服务器把SESSIONS.ser中的持久化HttpSession对象加载到内存中。
2、PersistentManager能够把HttpSession对象保存到Session Store中,它提供了比较StandarManager更灵活的管理功能,具有容错能力,控制内存中HttpSession对象的数目等。
Tomcat实现Session Store的接口为org.apache.catalina.session.Store,目前提供了两个实现这一接口的类:org.apache.catalina.session.FileStore和org.apache.catalina.session.JDBCStore。FileStore会将HttpSession对象保存到文件系统中;而JDBCStore则将HttpSession对象保存到数据库表中。
下面给出这两个类的配置:
配置FileStore:
在server.xml中,在Web应用的<Context>元素加入<Manager>元素,例如:
<Context path=”/helloapp” docBase=”helloapp” debug=”0” reloadable=”true”>
<Manager className=”org.apache.catalina.session.PersistentManager”>
debug=0;
saveOnRestart=”true”
maxActiveSessions=”-1”
minIdleSwap=”-1”
maxIdleSwap=”-1”
maxIdleBackup=”-1”
<Store className=”org.apache.catalina.session.FileStore” directory=”mydir”/>
</Manager>
</Context>
属性 |
作用 |
className |
指定Session Manager的实现类名,或Session Store的实现类名 |
debug |
设定Session Manager采用的跟踪级别,取值0到99,越小越跟踪信息越少,发布产品时,应该设置为0,以提高性能。 |
saveOnRestart |
如果为true,则当Tomcat关闭时,所有的有效HttpSession对象都保存到Session Store中;当Tomcat重启时,加载这些HttpSession对象。 |
maxActiveSessions |
设置处于活动状态的Session的最大数目,如果超过这一数目,Tomcat把一些超过的Sessin对象保存到Session Store中。-1表示不限制。 |
minIdleSwap |
Session处于不活动状态的最小时间,单位为秒,超过这一时间,Tomcat有可能把这个Session对象移到Session Store中。 |
maxIdleSwap |
Session处于不活动状态的最大时间,超过这一时间,Tomcat就一定会将这个Session对象移到Session Store中。 |
maxIdleBackup |
Session处于不活动状态的最大时间,超过这一时间,Tomcat就就会将这个Session对象拷贝到Session Store中进行备份。 |
directory |
指定Session Store在哪个文件系统目录下存放持久化的Session对象的信息,文件名是Session ID.session。 |
配置JDBCStore:
在server.xml中,在Web应用的<Context>元素加入<Manager>元素,例如:
<Context path=”/helloapp” docBase=”helloapp” debug=”0” reloadable=”true”>
<Manager className=”org.apache.catalina.session.PersistentManager”>
debug=0;
saveOnRestart=”true”
maxActiveSessions=”-1”
minIdleSwap=”-1”
maxIdleSwap=”-1”
maxIdleBackup=”-1”
<Store className=”org.apache.catalina.session.JDBCStore”
driverName=”com.mysql.jdbc.Driver”
connectionURL=”jdbc:mysql://localhost:3306/demo?user=root password=1234”
sessionTable=”tomcat_sessions”
sessionIdCol=”session_id”
sessionDataCol=”session_data”
sessionValidCol=”session_valid”
sessionMaxInactiveCol=”max_inactive”
sessionLastAccessedCol=”last_access”
sessionAppCol=”app_name”
checkInterval=”60”
debug=”0”
/>
</Manager>
</Context>
说明:上面的元素属性的含义与FileStore的相同,上面的配置假设在MySQL服务器上的demo数据库的tomcat_sessions表中存放持久化Session对象的信息,这个表的结构如下:
CREATE TABLE tomcat_sessions(
session_id VARCHAR(10) NOT NULL PRIMARY KEY,
session_data MEDIUMBLOB,
session_valid CHAR(1) NOT NULL,
max_inactive INT NOT NULL,
last_access BIGINT NOT NULL,
app_name VARCHR(255),
KEY kapp_name(app_name)
);
Filter相关
Servlet过滤器是在Java Servlet规范2.3中定义的,它能够对Servlet容器的请求和响应对象进行检查和修改,它在Servlet被调用之前检查Request对象,修改Request Header和Request内容;在Servlet被调用之后检查Response对象,修改Response Header和Response内容。Servlet过滤器负责过滤的Web组件可以是Servlet、JSP或HTML文件,具有以下特点:
l Servlet过滤器可能检查和修改ServletRequest和ServletResponse对象
l 可以指定Servlet过滤器和特定的URL关联,只有当客户请求访问此URL时,才会触发该过滤器工作
l 多个Servlet过滤器可以被串联起来,形成管道效应,协同修改请求和响应对象
l 所有支持Java Servlet规范2.3的Servlet容器,都支持Servlet过滤器
所有的Servlet过滤器类都必须实现javax.servlet.Filter接口。该接口定义了以下3个方法:
l init(FilterConfig) 这是Servlet过滤器的初始化方法,Servlet容器创建Servlet过滤器实例后就会调用这个方法。在这个方法中可以通过FilterConfig来读取web.xml文件中Servlet过滤器的初始化参数。
l doFilter(ServletRequest, ServletResponse, FilterChain) 这是完成实际的过滤操作的方法,当客户请求访问与过滤器关联的URL时,Servlet容器先调用该方法。FilterChain参数用来访问后续的过滤器的doFilter()方法。
l destroy() Servlet容器在销毁过滤器实例前调用该方法,在这个方法中,可以释放过滤器占用的资源。
下面是一个过滤器的例子,它可以拒绝列在黑名单上的客户访问留言簿,而且能将服务器响应客户请求所花的时间写入日志:
//WEB-INF/classes/NoteFilter.class
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class NoteFilter implements Filter{
private FilterConfig config=null;
private String blackList=null;
public void init(FilterConfig config)throws ServletException{
this.config=config;
blackList=config.getInitParameter(“blacklist”);
}
public void destroy(){
config=null;
}
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException{
String userName=((HttpServletRequest)request).getParameter(“user_name”);
if(userName!=null)
userName=new String(userName.getBytes(“ISO-8859-1”),”GB2312”);
if(userName!=null && userName.indexOf(blackList)!=-1){
PrintWriter out=response.getWriter();
out.print(“<html><body>”);
out.print(“<h1>对不起,”+userName+”,你没有权限留言</h1>”);
out.print(“</body></html>”);
out.flush();
return;
}
long before=System.currentTimeMillis();
config.getServletContext().log(“NoteFilter:before call chain.doFilter()”);
chan.doFilter(request, response);
config.getServletContext().log(“NoteFilter:after call chain.doFilter()”);
logn after=System.currentTimeMillis();
String name=””;
if(request instanceof HttpServletRequest)
name=((HttpServletRequest)request).getRequestURL();
config.getServletContext().log(“NoteFilter:”+name+”:”+(after-before)+”ms”);
}
}
发布Servlet过滤器,必须在web.xml文件中加入<filter>和<filter-mapping>元素,如下:
<filter>
<filter-name>NoteFilter</filter>
<filter-class>NoteFilter</filter-class>
<init-param>
<param-name>blackList</param-name>
<param-value>捣蛋鬼</param-value>
</init-param>
<filter>
<filter-mapping>
<filter-name>NoteFilter</filter-name>
<url-pattern>/note</url-pattern>
</filter-mapping>
多个过滤器可以串连起来协同工作,Servlet容器将根据它们在web.xml中定义的先后顺序,依次调用它们的doFilter()方法。而这些过滤之间的关系不需要任何配置。
Listener的作用类似于load-on-startup的Servlet,在Web应用启动时被加载,在Web应用关闭时被销毁,Listener用来作为Web应用的后台服务,比load-on-startup的Servlet更早被加载到Servlet容器中。自定义的Listener类必须实现ServletContextListener接口,并实现该接口的两个方法:contextInitialized(ServletContextEvent)和contextDestroyed(ServletContextEvent),例如:
public class GetConnListener implements ServletContextListener{
public void contextInitialized(ServletContextEvent sce){
try{
ServletContext application=sce.getServletContext();
String driver=application.getInitParameter("driver");
String url=application.getInitParameter("url");
String user=application.getInitParameter("user");
String password=application.getInitParameter("password");
Class.forName(driver);
Connection conn=DriverManager.getConnection(url, user, password);
application.setAttribute("conn", conn);
}catch(Exception e){
System.out.println("Listener中获取数据库连接出现异常:"+e.getMessage());
}
}
public void contextDestroyed(ServletContextEvent sce){
ServletContext application=sce.getServletContext();
Connection conn=(Connection)application.getAtrribute("conn");
if(conn!=null){
try{
conn.close();
conn=null;
}catch(Exception e){}
}
}
}
Listener配置:
<listener>
<listener-class>lee.GetConnListener</listener-class>
</listener>
自定义JSP标签库
实现自定义标签的处理类
JSP容器编译JSP网页时,遇到自定义标签,就会调用这个标签的处理类。标签处理类必须扩展自javax.servlet.jsp.TagSupport类或javax.servlet.jsp.BodyTagSupport类。
1、TagSupport类的主要方法如下:
l doStartTag JSP容器遇到自定义标签的起始标志时调用该方法。
l doEndTag JSP容器遇到自定义标签的结束标志时调用该方法。
l setValue(String k, Object v) 在标签处理类中设置key/value。
l getValue(String k) 在标签处理类中获得key对应的value。
l removeValue(String k) 在标签处理类中删除key/value。
l setPageContext(PageContext pc) 设置PageContext对象,由JSP容器在调用doStartTag或doEndTag方法之前调用。
l setParent(Tag t) 设置该标签的上层标签的处理类,由JSP容器在调用doStartTag或 doEndTag方法之前调用。
l getParent() 返回该标签的上层标签的处理类。
2、TagSupport类有两个重要属性:
l parent 该标签的上层标签的处理类。
l pageContext Web应用中的javax.servlet.jsp.PageContext对象,提供了保存和访问Web应用的共享数据方法:setAttribute(String name, Object value, int scope)和getAttribute(String name, int scope)。其中scope参数用来指定属性存在的范围,可选值有:PageContext.PAGE_SCOPE、PageContext.REQUEST_SCOPE、PageContext.SESSION_SCOPE和PageContext.APPLICATION_SCOPE。
注意:在TagSupport的构造函数中不能访问pageContext成员,因为此时JSP容器还没有调用setPageContext 方法对pageContext进行初始化。
3、处理标签的方法:
当JSP容器遇到自定义标签的起始标志时,就会调用该标签处理类的doStartTag()方法。doStartTag()方法返回一个整数值,用来决定程序的后续流程,有两个可选值:Tag.SKIP_BODY和Tag.EVAL_BODY_INCLUDE。Tag.SKIP_BODY表示标签之间的内容被忽略,例如:
<prefix:mytag>
Hello World!
</prefix:mytag>
如果这个标签的处理类的doStartTag()方法返回Tag.SKIP_BODY,则Hello World!字符串不会显示在网页上。Tag.EVAL_BODY_INCLUDE表示标签之间的内容会被处理。
当JSP容器遇到自定义标签的结束标志时,就会调用该标签处理类的doEndTag()方法。doEndTag()方法也返回一个整数值,表示程序的后续流程,也是有两个可选值:Tag.SKIP_PAGE和Tag.EVAL_PAGE。Tag.SKIP_PAGE表示立刻停止执行JSP页面,该标签的结束标志之后的所有页面内容全部会初忽略,任何已有的输出内容立刻返回到客户的浏览器上;Tag.EVAL_PAGE表示按正常的流程继续执行JSP页面的内容。
4、自定义标签的属性
例如:<prefix:mytag attribute1=”value1”>…</prefix:mytag>
那么在标签处理类中必须将这个属性作为类的成员变量,并且必须提供相应的getter和setter方法,例如:
private int attribute1;
public void setAttribute1(int value){ attribute1=value;}
public int getAttribute1(){return attribute1;}
以下是一个自定义标签<message>的处理类的例子:
// WEB-INF/classess/mypack/MessageTag.class
package mypack;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspTagException;
import javax.servlet.jsp.TagSupport;
import javax.servlet.http.HttpSession;
import java.util.Properties;
import java.io.*;
public class MessageTag extends TagSupport{
private String key=null;
public MessageTag(){}
public void setKey(String key){
this.key=key;
}
public String getKey(){
return key;
}
public int doEndTag() throws JspException{
try{
pageContext.getOut.print(key);
}catch(Exception e){
throw new JspTagException(e.getMessage());
}
return SkIP_BODY;
}
public void release(){
super.release();
}
}
创建标签库描述文件(Tag Library Descriptor, TLD)
TLD文件中的元素可分为3类:
l <taglib>元素用来设置标签库的相关信息,它有如下属性:
tlibversion 指定标签库的版本
jspversion 指定JSP的版本
shortname 指定标签库默认的前缀名(prefix)
uri 设置标签库的唯一访问标示符
info 标签库的说明信息
l <tag>元素用来定义一个标签,它的属性如下:
name 标签的名字
tagclass 标签的处理类
bodycontent 标签主体(body)的内容
info 标签的说明信息
说明:bodycontent属性有3个可选值:empty、JSP和tagdependent。empty表示标签没有主体,JSP表示标签的主体中可以加入JSP代码,tagdependent表示标签的主体的内容由标签的处理类自己去处理。
l <attribute>元素用来定义标签的属性,它有如下属性:
name 属性名
required 该属性是否必须,默认是false
rtexprvalue 该属性的值是否可能通过”<%=…%>”的方式获得,当设置为true时,该属性就可以采用如下的方式设置值:<% int num=1;%> <prefix:mytag attribute1=”<%=num%>”/>
以下是一个标签库描述文件的例子:
<!--WEB-INF/mytag.tld-->
<?xml version=”1.0” encoding=”ISO-8859-1”?>
<!DOCTYPE taglib PUBLIC “-//Sun Microsystems,Inc.//DTD JSP TagLibrary 1.1//EN”
“http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd”>
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>mytaglib</shortname>
<uri>/mytaglib</uri>
<tag>
<name>message</name>
<tagclass>mypack.MessageTag</tagclass>
<bodycontent>empty</bodycontent>
<info>produce message by key</info>
<attribute>
<name>key</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
在web.xml文件中加入标签库的定义
<taglib>
<!--标签库的唯一标示符,与标签库描述文件中的<uri>元素的内容相同,在JSP页面中,也要通过这个定义来使用标签库-->
<taglib-uri>/mytaglib</taglib-uri>
<!--指定标签库描述文件所在的位置-->
<taglib-location>/WEB-INF/mytaglib.tld</taglib-location>
</taglib>
在JSP页面中使用自定义的标签
例如:
<%@ taglib uri=”/mytaglib” prefix=”mm”%>
<html>
<body>
<mm:message key=”hello world!”/>
</body>
</html>