JSP&Servlet学习笔记（二）

一、Servlet

  JSP的本质就是Servlet，而Web容器会将JSP编译成对应的Servlet。自MVC规范出现后，Servlet的责任开始明确下来，仅仅作为控制器使用，不再需要生成页面标签，也不再作为视图层角色使用。

1.1 Servlet的开发

  Servlet是运行在服务器端的程序，用于处理及响应客户端的请求。Servlet是个特殊的Java类必须继承HttpServlet，每个Servlet可以响应客户端的请求。Servlet提供不同的方法用于响应客户端请求：

• doGet：用于响应客户端的GET请求
• doPost：用于响应客户端的POST请求
• doPut&doDelete：基本不用

  事实上，客户端的请求通常只有GET和POST两种，Servlet为了响应这两种请求，必须重写doGet()和doPost()两个方法。

  大部分时候，Servlet对于所有请求的响应都是完全一样的。此时，可以采用重写一个方法来替代上面的几个方法：只需重写service()方法即可响应客户端的所有请求。

另外，HttpServlet还包含两个方法：

• init(ServletConfig config)：创建Servlet实例时，调用该方法的初始化Servlet资源
• destroy()：销毁Servlet实例时，自动调用该方法的回收资源。

通常无须重写上面的两个方法，除非需要在初始化Servlet时，完成某些资源初始化的方法，才考虑冲洗init方法。如果需要在销毁Servlet之前，先完成某些资源的回收，比如关闭数据库连接等，才需要重写destroy方法。

注意：如果重写init()方法，则应该在重写该方法的第一行调用super.init(config)。

Servlet和JSP的区别在于：

• Servlet中没有内置对象，原来JSP的内置对象都必须有程序显示创建
• 对于静态的HTML标签，Servlet都必须使用页面输出流逐行输出

1.2 Servlet的配置

  编辑好的Servlet源文件并不能响应用户请求， 还必须将其编译成class文件，如果需要直接使用javac命令编译Servlet类，则必须将Servlet API接口和类添加到系统的CLASSPATH环境变量里。也就是将Tomcat安装目录下的servlet-api.jar和jsp-api.jar添加到CLASSPATH环境变量中，当然使用IDE这些都会自动完成了。

  为了让Servlet能响应用户请求，还必须将Servlet配置在Web应用中。配置Servlet时需要修改web.xml文件。

从Servlet3.0开始，配置Servlet有两种方式：

• 在Servlet类中使用@WebServlet注解进行配置
• 通过在web.xml文件中进行配置

开发Servlet类时使用了@WebServlet注解修饰该Servlet，其有如下常用的属性(全都是可选的)：

• name：指定该Servlet的名称
• urlPatterns / value：这两个属性的作用完全相同，都是指定该Servlet处理的URL
• asyncSupported：指定该Servlet是否支持异步操作模式
• display：指定该Servlet的显示名
• initParams：用于为该Servlet配置参数
• loadOnStartup：用于将该Servlet配置成load-on-startup的Servlet

如果打算使用注解来配置Servlet，有两点需要指出：

1. 不要在web.xml文件的根元素()中指定metadata-complete=“true”
2. 不要在web.xml文件中配置该Servlet

如果打算使用web.xml文件来配置Servlet，则需要配置如下两个部分：

• 配置Servlet的名字：对应web.xml文件中的元素
• 配置Servlet的URL：对应web.xml文件中的元素。这一步是可选的，但如果没有为是Servlet配置URL，则该Servlet不能响应用户请求

	
	firstServlet
	
	lee.FirstServlet



	
	firstServlet
	
	/aa

1.3 JSP/Servlet的声明周期

  JSP本质是Servlet，JSP页面将有Web容器编译成对应的Servlet，当Servlet容器中运行时，其实例的创建及销毁等都不是由程序员决定的，而是有Web容器进行控制的。

创建Servlet实例有两个时机：

• 客户端第一次请求某个Servlet时，系统创建该Servlet的实例：大部分的Servlet都是这种Servlet
• Web应用启动时立即创建Servlet实例，即load-on-startup Servlet

1.4 load-on-startup Servlet

  这总方式的Servlet在Web应用启动时立即创建Servlet实例，通常是用于某些后台服务的Servlet，或者需要拦截很多请求的Servlet；这种Servlet通常作为应用的基础Servlet使用，提供重要的后台服务。

配置load-on-startup的Servlet有两种方式：

• 在web.xml文件中通过元素的子元素进行配置
• 通过@WebServlet注解的loadOnStartup属性指定

元素或loadOnStartUp属性都只接收一个整型值，这个整型值越小，Servlet就越优先实例化。

示例：

	
	timerServlet
	
	lee.TimerServlet
	
	1

1.5 访问Servlet的配置参数

  配置Servlet时，还可以增加额外的配置参数。通过使用配置参数，可以实现提供更好的可移植性，避免将参数以硬编码方式写在程序代码中。

为Servlet配置参数有两种方式：

• 通过@WebServlet的initParams属性来指定
• 通过在web.xml文件的元素中添加子元素来指定

示例：

@WebServlet(name = "testServlet", urlPatterns = { "/testServlet" }, initParams = {
		@WebInitParam(name = "driver", value = "com.mysql.jdbc.Driver"),
		@WebInitParam(name = "url", value = "jdbc:mysql://localhost:3306/javaee"),
		@WebInitParam(name = "user", value = "root"),
		@WebInitParam(name = "pass", value = "32147") })

访问Servlet配置参数通过ServletConfig独享完成，ServletConfig提供getInitParameter()来获取初始化参数，如下：

// 获取ServletConfig对象
ServletConfig config = getServletConfig();
// 通过ServletConfig对象获取配置参数：dirver
String driver = config.getInitParameter("driver");
// 通过ServletConfig对象获取配置参数：url
String url = config.getInitParameter("url");
// 通过ServletConfig对象获取配置参数：user
String user = config.getInitParameter("user");
// 通过ServletConfig对象获取配置参数：pass
String pass = config.getInitParameter("pass");

  ServletConfig获取配置参数的方法和ServletContext获取配置参数的方法完全一样，只是ServletConfig是获得当前Servlet的配置参数，而ServletContext是获取整个Web应用的配置参数。
在web.xml中为Servlet配置参数（与上面的功能相同）：

	
	testServlet
	
	lee.TestServlet
	
	
		driver
		com.mysql.jdbc.Driver
	
	
	
		url
		jdbc:mysql://localhost:3306/javaee
	
	
	
		user
		root
	
	
	
		pass
		32147
	

1.6 使用Servlet作为控制器

使用Servlet作为表现层有如下三个劣势：

1. 开发效率低，所有的HTML标签都需使用页面输出流完成
2. 不利于团队协作开发，美工人员无法参与Servlet界面的开发
3. 程序可维护性差，即使修改一个按钮的标题，都必须重新编辑Java代码，并重新编译

  在标准的MVC模式中，Servlet仅作为控制器使用。Java EE应用框架正式遵循MVC模式的，对于遵循MVC模式的Java EE应用而言，JSP仅作为表现层(View)技术，其作用有两点：

1. 负责收集用户请求参数
2. 将应用的处理结果、状态数据呈现给用户

  Servlet则仅充当控制器(Controller)角色，它的作用类似于调度员：所有用户请求都发送给Servlet，Servlet调用Model来处理用户请求，并调用JSP来呈现处理结果；或者Servlet直接调用JSP将应用的状态数据呈现给用户。

二、JSP2的自定义标签

JSP2规范简化了标签的开发，在JSP2中开发标签库只需要如下几个步骤：

1.  开发自定义标签处理类
2.  建立一个*.tld文件，每个*.tld文件对应一个标签库，每个标签库可包含多个标签
3. 在JSP文件中使用自定义标签

  标签库是非常重要的技术，通常来说，初学者、普通开发人员都不会编写自己的标签库，因为像MVC框架，如Struts2、SpringMVC、JSF等都提供了丰富的自定义标签。

2.1 开发自定义标签类

自定义标签类应该继承一个父类：javax.servlet.jsp.tagext.SimpleTagSupport，除此之外，JSP自定义标签类还有如下要求：

• 如果标签类包含属性，每个属性都有对应的getter和setter方法
• 重写doTag()方法，这个方法负责生成页面内容

public class HelloWorldTag extends SimpleTagSupport {
	// 重写doTag()方法，该方法为标签生成页面内容
	public void doTag() throws JspException, IOException {
		// 获取页面输出流，并输出字符串
		getJspContext().getOut().write("Hello World " + new java.util.Date());
	}
}

2.2 建立TLD文件

  TLD是Tag Library Definition的缩写，即标签库定义，文件的后缀是tld，每个TLD文件对应一个标签库，一个标签库中可包含多个标签。TLD文件也称为标签库定义文件。标签库定义文件的根元素是taglib，他可以包含多个tag子元素，每个tag子元素都定义了一个标签。通常可以到Web容器下复制一个标签库定义文件，在其基础上进行修改即可。例如Tomcat中，在webapps\examples\WEB-INF\jsp2路径下包含了一个示例文件。
  我们可以将tld文件复制到Web应用的WEB-INF路径下（可以是任意子路径下）。

注意：Tomcat 8 所带的示例的TLD文件的根元素所采用的的是标签库2.0规范。

标签库2.0根元素：

标签库2.1根元素：

taglib下有如下三个子元素：

• tlib-version：指定该标签库实现的版本，这是一个作为标识的内部版本号，对程序没有太大的作用
• short-name：该标签库的默认短名，该名称通常也没有太大的用处
• uri：这个属性非常重要，它指定该标签库的URI，相当于指定该标签库的唯一标识。JSP页面中使用标签库时就是根据该URI属性来定位标签库的

taglib元素下可以包含多个tag元素，每个tag元素定义一个标签，tag元素下允许出现如下常用子元素：

• name：该标签的名称，这个子元素很重要，JSP页面中就是根据该名称来使用此标签的
• tag-class：指定标签的处理类
• body-content：这个子元素也很重要，它指定标签体内容。其值可以为：
  • tagdependent：指定标签处理类自己负责处理标签体
  • empty：指定该标签只能作用空标签使用
  • scriptless：指定该标签的标签体可以是静态HTML元素、表达式语言，但不允许出现JSP脚步
  • JSP：指定该标签的标签体可以使用JSP脚本

注：JSP2规范中body-content元素的值不可以是JSP。

注：标签库文件放在Web应用的WEB-INF路径或任意子路径下，Java Web规范会自动加载该文件，则该文件定义的标签库也将生效。

2.3 使用标签库

在JSP页面中确定指定的标签需要两点：

1. 标签库URI：确定使用哪个标签库
2. 标签名：确定使用哪个标签

使用标签库分成以下两个步骤：

1. 导入标签库：使用taglib编译指令导入标签库，就是将标签库和指定前缀关联起来
2. 使用标签：在JSP页面中使用标签

2.3.1 导入标签库

导入时的语法格式如下：

<%@ taglib uri="tagLibUri" prefix="tagPrefix"%>

其中uri属性指定标签库的URI，这个URI可以确定一个标签库，这个URI就是TLD文件中定义的uri属性对应。而prefix属性指定标签库前缀，即所有使用该前缀的标签将由此标签库处理。

2.3.2 使用标签库

使用标签的语法格式如下：

如果该标签没有标签体，则可以使用如下语法格式：

注：tagprefix其实就是上面定义的prefix属性所定义的值。

示例：

标签库类定义在上面，在tld中定义如下：

	1.0
	mytaglib
	
	http://www.crazyit.org/mytaglib

	
	
		
		helloWorld
		
		lee.HelloWorldTag
		
		empty
	

JSP中导入标签库：

<%@ taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"%>

JSP中使用标签：

2.4 带属性的标签

  前面的简单标签既没有属性，也没有标签体，用法和功能比较简单。需要注意的是带属性标签必须为每个属性提供对应的setter和getter方法，而带属性标签的配置方法与简单标签也略有差别。示例如下：

自定义带属性的标签类：

public class QueryTag extends SimpleTagSupport {
	// 定义成员变量来代表标签的属性
	private String driver;
	private String url;
	private String user;
	private String pass;
	private String sql;

	// 执行数据库访问的对象
	private Connection conn = null;
	private Statement stmt = null;
	private ResultSet rs = null;
	private ResultSetMetaData rsmd = null;
	
	//省略各成员变量的setter和getter方法
	...

	public void doTag() throws JspException, IOException {
		try {
			// 注册驱动
			Class.forName(driver);
			// 获取数据库连接
			conn = DriverManager.getConnection(url, user, pass);
			// 创建Statement对象
			stmt = conn.createStatement();
			// 执行查询
			rs = stmt.executeQuery(sql);
			rsmd = rs.getMetaData();
			// 获取列数目
			int columnCount = rsmd.getColumnCount();
			// 获取页面输出流
			Writer out = getJspContext().getOut();
			// 在页面输出表格
			out.write("");
			// 遍历结果集
			while (rs.next()) {
				out.write("");
				// 逐列输出查询到的数据
				for (int i = 1; i <= columnCount; i++) {
					out.write("");
				}
				out.write("");
			}
		} catch (ClassNotFoundException cnfe) {
			cnfe.printStackTrace();
			throw new JspException("自定义标签错误" + cnfe.getMessage());
		} catch (SQLException ex) {
			ex.printStackTrace();
			throw new JspException("自定义标签错误" + ex.getMessage());
		} finally {
			// 关闭结果集
			try {
				if (rs != null)
					rs.close();
				if (stmt != null)
					stmt.close();
				if (conn != null)
					conn.close();
			} catch (SQLException sqle) {
				sqle.printStackTrace();
			}
		}
	}
}
  该标签类包含了5个属性，而为标签处理类定义成员变量即可代表标签的属性，而且程序需要为这5个属性提供setter()和getter()方法。该标签输出的内容依然由doTag()方法决定，该方法会根据SQL语句查询数据库，并将查询结果显示在当前页面中。
  对于有属性的标签，需要在tld中为元素增加子元素，每个定义一个标签属性。 子元素通常还需要指定如下几个子元素：
 
   
name：设置属性名，子元素的值是字符串内容
 
   
required：设置该属性是否为必须属性，该子元素的值时true或false
 
   
fragment：设置该属性是否支持JSP脚本、表达式等动态内容，子元素的值true或false
 
  
为了配置上面的QueryTag标签，需要在tld文件中增加如下配置片段：

	
	query
	
	lee.QueryTag
	
	empty
	
	
		driver 
		true
		true
	
	
	
		url 
		true
		true
	
	
	
		user 
		true
		true
	
	
	
		pass 
		true
		true
	
	
	
		sql 
		true
		true
	
配置完毕后，就可在页面中使用标签了，先导入标签库，然后使用标签，代码如下：
<%@ taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"%>

......
2.5 带标签体的标签（重点）
  带标签体的标签，可以在标签内嵌入其他内容（包括静态的HTML内容和动态的JSP内容），通常用于完成一些逻辑运算。示例如下：
标签处理类：
public class IteratorTag extends SimpleTagSupport {
	// 标签属性，用于指定需要被迭代的集合
	private String collection;
	// 标签属性，指定迭代集合元素，为集合元素指定的名称
	private String item;

	// 省略get与set...
	// 省略get与set...
	// 标签的处理方法，标签处理类只需要重写doTag()方法
	public void doTag() throws JspException, IOException {
		// 从page scope中获取名为collection的集合
		Collection itemList = (Collection) getJspContext().getAttribute(collection);
		// 遍历集合
		for (Object s : itemList) {
			// 将集合的元素设置到page范围内
			getJspContext().setAttribute(item, s);
			// 输出标签体
			getJspBody().invoke(null);
		}
	}

	// 标签的处理方法，标签处理类只需要重写doTag()方法
	public void doTag() throws JspException, IOException {
		// 从page scope中获取名为collection的集合
		Collection itemList = (Collection) getJspContext().getAttribute(collection);
		// 遍历集合
		for (Object s : itemList) {
			// 将集合的元素设置到page范围内
			getJspContext().setAttribute(item, s);
			// 输出标签体
			getJspBody().invoke(null);
		}
	}
}
  该标签处理类的doTag()方法首先从page范围内获取了指定名称的Collection对象，然后遍历Collection对象的元素，每次遍历都调用getJspBody()方法，该方法返回该标签所包含的标签体：JSPFragment对象，执行该对象的invoke()方法，即可输出标签体内容。该标签的作用是：遍历指定集合，每遍历一个集合元素，技术处标签体一次。
  因为该标签的标签体不为空，配置该标签时指定body-content为scriptless，该标签的配置代码如下：

	
	iterator
	
	lee.IteratorTag
	
	scriptless
	
	
		collection 
		true
		true
	
	
	
		item 
		true
		true
	
  上面的配置指定该标签的标签体可以是静态HTML内容，也可以是表达式语言，但不允许出现JSP脚本。下面是测试代码：(导入代码省略)

	
带标签体的标签-迭代器标签
	

	<%
		//创建一个List对象
		List a = new ArrayList();
		a.add("疯狂Java");
		a.add("www.crazyit.org");
		a.add("www.fkit.org");
		//将List对象放入page范围内
		pageContext.setAttribute("a", a);
	%>
	
");
					out.write(rs.getString(i));
					out.write("
 
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
  

			

		
		

				
${pageScope.item}
			
		
	

测试结果如下：

  从输出结果看，使用iterator标签遍历集合元素比使用JSP脚本遍历集合元素要优雅得多，这就是自定义标签的魅力。实际上JSTL标签库提供了一套功能强大的标签，如果有现成的轮子就没必要再造轮子了。

  可能你有所疑惑，这个JSP页面自己先把多个字符串添加到ArrayList，然后再使用这个iterator标签进行迭代输出，好像没有意义。实际上这个标签的用处非常大，在严格的MVC规范下，JSP页面只负责显示数据——而数据通常由控制器(Servlet)放入request范围内，而JSP页面就通过iterator标签迭代出输出request范围内的数据。

2.6 以页面片段作为属性的标签（暂不理解）

  JSP2规范的自定义标签还允许直接将一段“页面片段”作为属性，这种方式给自定义标签提供了更大的灵活性。以“页面片段”为属性的标签与与普通标签区别并不大，只有两个简单的改变：

1.  标签处理类中定义类型为JSPFragment的属性，该属性代表了“页面片段”
2. 使用标签库，通过动作指令为标签的属性指定值

定义一个标签处理类，示例：

public class FragmentTag extends SimpleTagSupport {
	private JspFragment fragment;
	//省略fragment的setter和getter方法
	@Override
	public void doTag() throws JspException, IOException {
		JspWriter out = getJspContext().getOut();
		out.println("
");
		out.println("
下面是动态传入的JSP片段
");
		// 调用、输出“页面片段”
		fragment.invoke(null);
		out.println("

  上面的程序中定义了fragment成员变量，该成员变量代表了使用该标签时的“页面片段”，配置该标签与配置普通标签并无任何区别，增加如下配置片段即可。

	
	fragment
	
	lee.FragmentTag
	
	empty
	
	
		fragment
		true
		true
	

  这个自定义标签并没有任何特别之处，就是一个普通的带属性标签，该标签的标签体为空。由于该标签需要一个fragment属性，该属性的类型为JspFragment，因此使用该标签时需要使用动作指令来设置属性值，如下所示：

<%@ taglib uri="http://www.crazyit.org/mytaglib" prefix="mytag"%>
.....

	
<%-- 使用jsp:attribute标签传入fragment参数（该注释不能放在fragment内） -->
	<%-- 下面是动态的JSP页面片段 --%>
	





	
	<%-- 下面是动态的JSP页面片段 --%>
	${pageContext.request.remoteAddr}

注意：由于程序指定了fragment标签的标签体为empty，因此程序中fragment开始标签和fragment结束标签之间只能使用子元素，不允许出现其他内容，甚至连注释都不允许。

2.7 动态属性的标签(终点)

  前面的标签的属性个数是确定的，绝大部分情况下这种带属性的标签能处理得很好，但在某些特殊情况下，需要传入自定义标签的属性个数是不确定的，属性名也不确定，这就需要借助于动态属性的标签了。

动态属性标签比普通标签多了两个额外需求：

1.  标签处理类还需要实现DynamicAttributes接口
2.  配置标签时通过子元素指定该标签支持动态属性

动态属性标签的处理类，示例：

public class DynaAttributesTag extends SimpleTagSupport implements DynamicAttributes {
	// 保存每个属性名的集合
	private ArrayList keys = new ArrayList();
	// 保存每个属性值的集合
	private ArrayList