JSP极简入门开发笔记

1. JSP 简介

JSP 是简 Servlet 编写的一种技术, 它将 Java 代码和 HTML 语句混合在同一个文件中编写,
只对网页中的要动态产生的内容采用 Java 代码来编写，而对固定不变的静态内容采用普通静态 HTML 页面的方式编写。

Java Server Page: Java 服务器端网页. 在 HTML 页面中编写 Java 代码的页面.

1.1 如何实现一个jsp页面？

新建一个jsp格式的页面，在body节点内的<% %>内写对应的Java代码，即可编写Java代码

<% 
	Date date = new Date();
	System.out.print(date); 
%>

1.2 jsp的存放位置

JSP 可以放置在 WEB 应用程序中的除了 WEB-INF 及其子目录外的其他任何目录中,
JSP 页面的访问路径与普通 HTML 页面的访问路径形式也完全一样。

2. JSP运行原理

jsp和页面代码是如何融合的呢？可通过查看JSP在服务器中的位置来一探究竟。

实际上，每一个jsp页面会被生成一个对应的xxx_jsp.Java

JSP 本质上是一个 Servlet.

每个JSP 页面在第一次被访问时, JSP 引擎将它翻译成一个 Servlet 源程序, 接着再把这个 Servlet 源程序编译成 Servlet 的 class 类文件.
然后再由WEB容器（Servlet引擎）像调用普通Servlet程序一样的方式来装载和解释执行这个由JSP页面翻译成的Servlet程序。

3. JSP中的九个隐含对象

当我们在jsp页面<% %>标签下，添加Java代码时，对应的代码会被JSP引擎放置public void _jspService(HttpServletRequest request, HttpServletResponse response)方法之中。因此，使用使用 <% %> 编写的代码可以用到 request, response, pageContext, session，application, config, out, page 这 8 个隐含对象. <% %>标签的代码在java源码中的的对应位置如下：

public void _jspService(HttpServletRequest request, HttpServletResponse response)
        throws java.io.IOException, ServletException {PageContext pageContext = null;
HttpSession session = null;
ServletContext application = null;
ServletConfig config = null;
JspWriter out = null;
Object page = this;

//...

//使用  <% %> 编写的代码在此位置. 可以用到 request, response, pageContext, session
//application, config, out, page 这 8 个隐含对象. (实际上还可以使用一个叫 exception 的隐含对象)
                                                      
}

由于相当于直接在该方法内添加代码，所以这些隐含对象的使用不需要我们自己来声明。

①. request: HttpServletRequest 的一个对象.

②. response: HttpServletResponse 的一个对象(在 JSP 页面中几乎不会调用 response 的任何方法.)

③. pageContext: 页面的上下文, 是 PageContext 的一个对象. 可以从该对象中获取到其他 8 个隐含对象. 也可以从中获取到当前页面的其他信息.

④. session: 代表浏览器和服务器的一次会话, 是 HttpSession 的一个对象.

⑤. application: 代表当前 WEB 应用. 是 ServletContext 对象.

⑥. config: 当前 JSP 对应的 Servlet 的 ServletConfig 对象(几乎不使用). 若需要访问当前 JSP 配置的初始化参数, 需要通过映射的地址才可以.

• 映射 JSP代码如下:

<servlet>
  	<servlet-name>hellojsp</servlet-name>
  	<jsp-file>/hello.jsp</jsp-file>
  	<init-param>
  		<param-name>test</param-name>
  		<param-value>testValue</param-value>
  	</init-param>
  </servlet>

  <servlet-mapping>
  	<servlet-name>hellojsp</servlet-name>
	<url-pattern>/hellojsp</url-pattern>  	
  </servlet-mapping>

⑦. out: JspWriter 对象. 调用 out.println() 可以直接把字符串打印到浏览器上.

⑧. page: 指向当前 JSP 对应的 Servlet 对象的引用, 但为 Object 类型, 只能调用 Object 类的方法(几乎不使用)

⑨. exception: 在声明了 page 指令的 isErrorPage=“true” 时, 才可以使用.

<%@ page isErrorPage="true" %>

4. JSP基本语法

JSP页面中的静态HTML内容称 JSP模版元素。

**JSP表达式（expression）**提供了将一个 java 变量或表达式的计算结果输出到客户端的简化方式，
它将要输出的变量或表达式直接封装在<%= 和 %>之中，直接打印到浏览器上。

// 普通的表达式
<% 
	Date date = new Date();
	out.print(date);
%>
// JSP表达式，直接将变量打印在<%= 和 %>之中，最终会显示在浏览器页面之中。
<%= date %>

**JSP脚本片断（scriptlet）**是指嵌套在<% 和 %>之中的一条或多条Java程序代码。
多个脚本片断中的代码可以相互访问.

JSP 声明: JSP 声明将 Java 代码封装在<%！和 %>之中，它里面的代码将被插入进 Servle t的 _jspService 方法的外面. (在 JSP 页面中几乎从不这样使用)

JSP注释的格式：<%-- JSP 注释 --%>

• 区别: JSP 注释可以阻止 Java 代码的执行.

5. JSP指令

JSP指令（directive）是为JSP引擎而设计的，它们并不直接产生任何可见输出，而只是告诉引擎如何处理JSP页面中的其余部分。JSP指令的基本语法格式：

举例：
<%@ 指令 属性名="值" %
<%@ page contentType="text/html;charset=gb2312"%>
注意：属性名部分是大小写敏感的

在目前的JSP 2.0中，定义了page、include和taglib这三种指令，每种指令中又都定义了一些各自的属性。如果要在一个JSP页面中设置同一条指令的多个属性，可以使用多条指令语句单独设置每个属性，也可以使用同一条指令语句设置该指令的多个属性。

第一种方式：

<%@ page contentType="text/html;charset=gb2312"%>
<%@ page import="java.util.Date"%>

第二种方式：
<%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>

5.1 page指令

page指令用于定义JSP页面的各种属性，无论page指令出现在JSP页面中的什么地方，它作用的都是整个JSP页面，为了保持程序的可读性和遵循良好的编程习惯，page指令最好是放在整个JSP页面的起始位置。

JSP 2.0规范中定义的page指令的完整语法：

<%@ page 
	[ language="java" ] 
	[ extends="package.class" ] 
	[ import="{package.class | package.*}, ..." ] 
	[ session="true | false" ] 
	[ buffer="none | 8kb | sizekb" ] 
	[ autoFlush="true | false" ] 
	[ isThreadSafe="true | false" ] 
	[ info="text" ] 
	[ errorPage="relative_url" ] 
	[ isErrorPage="true | false" ] 
	[ contentType="mimeType [ ;charset=characterSet ]" | "text/html;charset=ISO-8859-1" ] 
	[ pageEncoding="characterSet | ISO-8859-1" ] 
	[ isELIgnored="true | false" ]
%>

page 指令常用的属性:

①. import 属性: 指定当前 JSP 页面对应的 Servlet 需要导入的类.
<%@page import="java.text.DateFormat"%>

②. session 属性: 取值为 true 或 false, 指定当前页面的 session 隐藏变量是否可用, 也可以说访问当前页面时是否一定要生成 HttpSession对象.
<%@ page session="false" %>

③. errorPage 和 isErrorPage:
errorPage 指定若当前页面出现错误的实际响应页面是什么。 其中 / 表示的是当前 WEB 应用的根目录.
<%@ page errorPage="/error.jsp" %>

在响应 error.jsp 时, JSP 引擎使用的是请求转发的方式.

isErrorPage 指定当前页面是否为错误处理页面, 可以说明当前页面是否可以使用 exception 隐藏变量.

需要注意的是: 若指定 isErrorPage=“true”, 并使用 exception 的方法了, 一般不建议能够直接访问该页面，而是将该文件放置在web-inf文件夹下，通过请求转发的方式来访问。

如何使客户不能直接访问某一个页面呢 ? 

对于 Tomcat 服务器而言, WEB-INF 下的文件是不能通过在浏览器中直接输入地址的方式来访问的. 但通过请求的转发方式可以访问!
还可以在 web.xml 文件中配置错误页面: 
<error-page>
    <!-- 指定出错的代码: 404 没有指定的资源, 500 内部错误. -->
	  	<error-code>404</error-code>
	  	<!-- 指定响应页面的位置 -->
	  	<location>/WEB-INF/error.jsp</location>
</error-page>
<error-page>
  	<!-- 指定异常的类型 -->
  	<exception-type>java.lang.ArithmeticException</exception-type>
  	<location>/WEB-INF/error.jsp</location>
</error-page>

④. contentType: 指定当前 JSP 页面的响应类型. 实际调用的是 response.setContentType(“text/html; charset=UTF-8”);
通常情况下, 对于 JSP 页面而言其取值均为 text/html; charset=UTF-8. charset 指定返回的页面的字符编码是什么. 通常取值为 UTF-8。

JSP引擎会根据page指令的contentType属性生成相应的调用ServletResponse.setContentType方法的语句。page指令的contentType属性还具有说明JSP源文件的字符编码的作用。

⑤. pageEncoding: 指定当前 JSP 页面的字符编码. 通常情况下该值和 contentType 中的 charset 一致.

⑥. isELIgnored: 指定当前 JSP 页面是否可以使用 EL 表达式. 通常取值为 false.

基于page指令的jsp的示例如下：

<%@page import="java.text.DateFormat"%>
<%@ page language="java" contentType="text/html; charset=UTF-8" %>
<%@ page pageEncoding="UTF-8" import="java.util.Date" %>
<%@ page session="false" isELIgnored="false" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>Insert title here</title>
	</head>
	<body>
	</body>
</html>

5.2 include指令

• include 指令

include指令用于通知JSP引擎在翻译当前JSP页面时将其他文件中的内容合并进当前JSP页面转换成的Servlet源文件中，这种在源文件级别进行引入的方式称之为静态引入，当前JSP页面与静态引入的页面紧密结合为一个Servlet。

<%@ include file="b.jsp" %>

file属性的设置值必须使用相对路径。如果以 / 开头，表示相对于当前WEB应用程序的根目录（注意不是站点根目录），否则，表示相对于当前文件。

5.3 jsp:incluce 标签

jsp:include标签用于把另外一个资源的输出内容插入进当前JSP页面的输出内容之中，这种在JSP页面执行时的引入方式称之为动态引入。

<jsp:include page="b.jsp"></jsp:include>

动态引入: 并不是像 include 指令生成一个 Servlet 源文件, 而是生成两个 Servlet 源文件, 然后通过一个方法的方式把目标页面包含进来.

5.4 jsp:forward 标签

<jsp:forward page="/include/b.jsp"></jsp:forward>

相当于.

<% 
	request.getRequestDispatcher("/include/b.jsp").forward(request, response);
%>

2). 但使用 jsp:forward 可以使用 jsp:param 子标签向 b.jsp 传入一些参数. 同样 jsp:include 也可以使用 jsp:param 子标签.

<jsp:forward page="/include/b.jsp">
	<jsp:param value="abcd" name="username"/>
</jsp:forward>

OR

<jsp:include page="/include/b.jsp">
	<jsp:param value="abcd" name="username"/>
</jsp:include>

在 b.jsp 页面可以通过 request.getParameter(“username”) 获取到传入的请求参数.

6. JSP中的中文乱码问题

6.1 JSP 页面上显示中文

需要实现中文不乱码，只需要保证jsp页面中的三个一致：

①contentType=“text/html; charset=UTF-8”,

②pageEncoding=“UTF-8”

③保证浏览器的显示的字符编码

保证 contentType=“text/html; charset=UTF-8”, pageEncoding=“UTF-8” charset 和 pageEncoding 的编码一致, 且都支持中文. 通常建议取值为UTF-8。还需保证浏览器的显示的字符编码也和请求的 JSP 页面的编码一致。

6.2 获取中文参数值

对于 POST 请求: 只要在获取请求信息之前(在调用 request.getParameter 或者是 request.getReader 等),
调用 request.setCharacterEncoding(“UTF-8”) 即可.

对于 GET 请求: ，将参数放置于url之后进行传输，这种方式下，参数在传输过程中默认的编码为ISO-8859-1.

所以前面POST方式的处理方式对于 GET 无效.

可以通过修改 Tomcat 的 server.xml 文件的方式.为 Connector 节点添加 useBodyEncodingForURI=“true” 属性即可.

<Connector connectionTimeout="20000" port="8989" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>

或者在GET请求之前，使request.setCharacterEncoding(“utf-8”)来设置。