JAVA WEB快速入门之从编写一个JSP WEB网站了解JSP WEB网站的基本结构、调试、部署
接上篇《JAVA WEB快速入门之环境搭建》，在完成了环境搭建后（JDK、Tomcat、IDE），现在是万事具备，就差写代码了，今天就来从编写一个JSP WEB网站了解JSP WEB网站的基本结构、调试、部署，至于为什么要先写JSP WEB，而不是直接上SSM(Spring、SpringMVC、Mybatis)，原因很简单，先得了解基础，再由浅入深，这是我的学习方法，如果一开始就写MVC，那么顶多也是照葫芦画瓢，很难深入，因为不知道原理，就无法扩展与灵活运用。好了废话不多说，开始本文的主题。
一、使用eclipse初始化一个JSP WEB项目(即：动态WEB项目)，步骤如下：
如上图示注意选择TOMCAT版本
如上图示勾选生成web.xml，当然如果不勾选也行，但后续如果有需要用到配置的地方就需要再单独添加，故这里我选择一并生成。
最后点击finish按钮即可生成WEB项目
WEB项目的结构如下图示，每个部份都有说明，该图引用自网络
如上步骤也可参考更详细的教程：http://www.runoob.com/jsp/eclipse-jsp.html
二、编写一个登录静态页面（login.html），注意静态页面（html）、动态页面(jsp)均应在WebContent目录下创建
后面采取默认即可，最后创建好空的login.html，然后写如下示例代码：
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>login</title> </head> <body> <form action="/demo2/servlet/login" method="post"> <div> <label for="userid">UserID:</label> <input type="text" name="uid" /> </div> <div> <label for="pwd">Password:</label> <input type="password" name="pwd" /> </div> <div> <button type="submit">Enter</button> </div> </form> </body> </html>
三、编写服务端处理逻辑类（LoginServlet），该类必需继承自HttpServlet，并按需重写相关的请求方法，例如此处是：doGet（处理GET请求）、doPost（处理POST请求）
自定义的Servlet类统一放在src目录下，按照JAVA 标准以包、类层级呈现
如上图示，包名一般是域名的反写，大家可能看到下面还有一个创建package-info.java的勾选项，具体用法可参考：PACKAGE-INFO.JAVA 作用及用法详解
创建好LoginServlet类后，编写如下代码：（主要是doPost，用于处理登录请求）
package cn.zuowenjun.java;
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;
import javax.servlet.http.HttpSession;
/**
* Servlet implementation class LoginServlet
*/
@WebServlet(name="LoginServlet",urlPatterns= {"/servlet/login"})
public class LoginServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
/**
* @see HttpServlet#HttpServlet()
*/
public LoginServlet() {
super();
// TODO Auto-generated constructor stub
}
/**
* @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse
* response)
*/
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// TODO Auto-generated method stub
response.getWriter().append("Served at: ").append(request.getContextPath());
}
/**
* @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
* response)
*/
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// TODO Auto-generated method stub
String uid = request.getParameter("uid");
String pwd = request.getParameter("pwd");
if (uid.isEmpty() || pwd.isEmpty()) {
response.getWriter().append("the UserID and Passwrod cannot be empty!");
return;
}
if(uid.equals("admin") && pwd.equals("java.web")) {
HttpSession session= request.getSession();
session.setAttribute("loginid", uid);
String indexUrl= request.getContextPath()+"/jsp/index.jsp";
response.sendRedirect(indexUrl);
return;
}
else {
response.getWriter().append("the UserID or Passwrod is wrong!");
}
}
}
servlet部署（映射）有两种方式，一种是在web.xml中使用如下配置：
<servlet>
<servlet-name>LoginServlet</servlet-name>
<servlet-class>cn.zuowenjun.java.LoginServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>LoginServlet</servlet-name>
<url-pattern>/servlet/login</url-pattern>
</servlet-mapping>
另一种方式是使用注解，在servlet类名上方使用@WebServlet注解，在里面设置参数，如下：
@WebServlet(name="LoginServlet",urlPatterns= {"/servlet/login"})
public class LoginServlet extends HttpServlet {
... ...
}
这样登录页面的前后端交互写完了，如果登录成功则跳转至index.jsp页面，否则直接输出错误信息，下面就写index.jsp（动态页面）：
四、编写index.jsp（动态页面），我这里将所有jsp页面统一放在jsp目录中，以区分静态页面与动态页面，创建jsp页面的方法与创建静态页面方法基本相同，只是创建类型选择jsp File即可，在此不再重复介绍。
创建好空的index.jsp页面后，编写从SQL SERVER DB中获取表数据并显示在页面上的逻辑（即：查询数据），代码如下：
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@page import="java.sql.Connection"%>
<%@page import="java.sql.DriverManager"%>
<%@page import="java.sql.ResultSet"%>
<%@page import="java.sql.SQLException"%>
<%@page import="java.sql.Statement"%>
<%!/*从SQL SERVER中获取测试数据*/
private ResultSet getTestData(String sql) {
try {
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
Connection sqlConn = DriverManager.getConnection(
"jdbc:sqlserver://xxxxxxx;DatabaseName=testDB", "dbuser", "password");
Statement statement = sqlConn.createStatement();
ResultSet set = statement.executeQuery(sql);
return set;
} catch (Exception ex) {
ex.printStackTrace();
return null;
}
}%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Index页面</title>
<style type="text/css">
table{border:solid 2px black;border-collapse:collapse;}
table th{color:blue;background-color:orange;border:solid 1px gray;padding:3px;}
table td{border:solid 1px gray;padding:3px;}
</style>
</head>
<body>
<%
ResultSet pageData=getTestData("select top 100 sys_guid,FormId,EventId,MaxElapsedTime,SlowTotalCount,LastSlowRequestTime,DisabedRequest from TS_ConfigLimitRequest");
int colCount=pageData.getMetaData().getColumnCount();
%>
<table>
<tr>
<%for(int i=1;i<=colCount;i++) { %>
<th><%=pageData.getMetaData().getColumnName(i) %></th>
<%} %>
<th>操作</th>
</tr>
<%while (pageData.next()){ %>
<tr>
<%for(int i=1;i<=colCount;i++) { %>
<td><%=pageData.getString(i) %></td>
<%} %>
<td><a href="edit.jsp?sysguid=<%=pageData.getString("sys_guid")%>" target="_blank">编辑</a></td>
</tr>
<%} %>
</table>
</body>
</html>
JSP生命周期及相关学习教程，可参考：http://www.runoob.com/jsp/jsp-life-cycle.html
如上代码，涉及第一个重点：引用第三方JAR包（如：SQL SERVER JDBC），如何引用步骤如下：
1.先下载所需的JAR包（如这里我需要SQL SERVER JDBC的JAR包，下载地址：https://docs.microsoft.com/zh-cn/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-2017）
2.下载后将JAR包复制到WebContent\WEB-INF\lib目录下，然后选中JAR包右键，选择buid path-->configure buid path，如下图示：
3.然后如下图所示在Libaraies下选择WebContent\WEB-INF\lib目录下的mssql-jdbc-7.0.0.jre8.jar包，最后点击应用即可。
可以从项目的依赖类库中看到刚添加的JAR包，如下图示：
涉及第二个重点：使用原生JDBC操作数据库，由于这块涉及的内容比较多，故我这里借别人的图来展示一下JDBC的完整结构，代码中也只是用到了最基本的查询：
五、编写edit.jsp页面，用于可修改记录或删除记录（即：增、删、改），同样参照index.jsp的创建步骤
创建好edit.jsp空页面后，编写如下代码：
<%@ page language="java" contentType="text/html; charset=UTF-8"
import="java.sql.*" pageEncoding="UTF-8"%>
<%
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
%>
<%! //全局定义区
/*从SQL SERVER中获取测试数据*/
private Connection getConnection() throws SQLException {
Connection sqlConn = DriverManager.getConnection("jdbc:sqlserver://serverIP;DatabaseName=testDB",
"user", "password");
return sqlConn;
}
private ResultSet getItemData(String sql, String sysguid) {
try {
Connection sqlConn = getConnection();
PreparedStatement stmt = sqlConn.prepareStatement(sql);
stmt.setString(1, sysguid);
ResultSet set = stmt.executeQuery();
return set;
} catch (Exception ex) {
ex.printStackTrace();
return null;
}
}
/*执行SQL,使用事务*/
private String executeSql(String sql, String[] params) {
Connection sqlConn = null;
try {
sqlConn = getConnection();
sqlConn.setAutoCommit(false);
PreparedStatement stmt = sqlConn.prepareStatement(sql);
for (int i = 0; i < params.length; i++) {
stmt.setObject(i + 1, params[i]);//参数是从1开始
}
stmt.execute();
sqlConn.commit();
return "执行成功！";
} catch (SQLException sqlEx) {
if (sqlConn != null) {
try{
sqlConn.rollback();
}catch(SQLException sqlExtrn){
return "执行失败，且回滚事务失败，原因：" + sqlExtrn.getMessage();
}
}
return "执行失败，原因：" + sqlEx.getMessage();
} catch (Exception ex) {
return "执行失败，原因：" + ex.getMessage();
}
}
/*是否FORM请求回调*/
private Boolean isPostBack(HttpServletRequest request) {
String postValue = request.getParameter("__formpost");
if ("POST".equals(postValue)) {
return true;
} else {
return false;
}
}%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>edit页面</title>
</head>
<body>
<%
String execResult = "";
if (isPostBack(request)) {
String sysguid = request.getParameter("sysguid");
String doAction = request.getParameter("doAction");
String formId = request.getParameter("FormId");
String eventId = request.getParameter("EventId");
String maxElapsedTime = request.getParameter("MaxElapsedTime");
String slowTotalCount = request.getParameter("SlowTotalCount");
String lastSlowRequestTime = request.getParameter("LastSlowRequestTime");
String disabedRequest = request.getParameter("DisabedRequest");
String sql=null;
if("Save".equals(doAction)){
sql = "update TS_ConfigLimitRequest set FormId=?,EventId=?,MaxElapsedTime=?,SlowTotalCount=?,LastSlowRequestTime=?,DisabedRequest=? where sys_guid=?";
execResult = executeSql(sql, new String[] { formId, eventId, maxElapsedTime, slowTotalCount,
lastSlowRequestTime, disabedRequest, sysguid });
}else if("Delete".equals(doAction)) {
sql="delete from TS_ConfigLimitRequest where sys_guid=?";
execResult = executeSql(sql, new String[] { sysguid });
}
}
String sysguid = request.getParameter("sysguid");
ResultSet itemSet = getItemData(
"select sys_guid,FormId,EventId,MaxElapsedTime,SlowTotalCount,LastSlowRequestTime,DisabedRequest from TS_ConfigLimitRequest where sys_guid=?",
sysguid);
if (!itemSet.next()) {
out.println("不存在该条记录！");
return;
}
%>
<form method="post">
<table>
<tr>
<td>FormId:</td>
<td><input type="text" name="FormId"
value="<%=itemSet.getString("FormId")%>" /></td>
</tr>
<tr>
<td>EventId:</td>
<td><input type="text" name="EventId"
value="<%=itemSet.getString("EventId")%>" /></td>
</tr>
<tr>
<td>MaxElapsedTime:</td>
<td><input type="text" name="MaxElapsedTime"
value="<%=itemSet.getString("MaxElapsedTime")%>" /></td>
</tr>
<tr>
<td>SlowTotalCount:</td>
<td><input type="text" name="SlowTotalCount"
value="<%=itemSet.getString("SlowTotalCount")%>" /></td>
</tr>
<tr>
<td>LastSlowRequestTime:</td>
<td><input type="text" name="LastSlowRequestTime"
value="<%=itemSet.getString("LastSlowRequestTime")%>" /></td>
</tr>
<tr>
<td>DisabedRequest:</td>
<td><select name="DisabedRequest">
<option value=""
<%if ("".equals(itemSet.getString("DisabedRequest"))) {%>
selected <%}%>>-空-</option>
<option value="true"
<%if ("true".equals(itemSet.getString("DisabedRequest"))) {%>
selected <%}%>>true</option>
<option value="false"
<%if ("false".equals(itemSet.getString("DisabedRequest"))) {%>
selected <%}%>>false</option>
</select></td>
</tr>
</table>
<input type="hidden" name="sysguid" value="<%=sysguid%>">
<button id="btnSave" type="submit" name="doAction" value="Save">Save</button>
<button id="btnSave" type="submit" name="doAction" value="Delete">Delete</button>
<input type="hidden" name="__formpost" value="POST">
</form>
<p
style="color:<%if (!execResult.isEmpty() && execResult.startsWith("保存失败")) {%>red<%} else {%>green<%}%>">
<%=execResult%>
</p>
</body>
</html>
如上代码主要涉及JDBC执行SQL语句，同时还特意使用了参数占位符以避免SQL注入，使用了事务以便可以演示事务的提交与回滚操作，具体的代码原理因篇幅有限就不介绍请参照相关文档。
六、编写一个登录验证过滤器：LoginValidationFilter，以实现对某些目录下页面进行登录限制（如：本文示例的是jsp目录），过滤器必需实现Filter接口，过滤器的主要逻辑写在doFilter中，代码如下：
（过滤器相关知识：http://www.runoob.com/jsp/jsp-writing-filters.html）
package cn.zuowenjun.java;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.*;
/**
* Servlet Filter implementation class LoginValidationFilter
*/
@WebFilter(filterName="LoginValidationFilter",urlPatterns="/jsp/*")
public class LoginValidationFilter implements Filter {
/**
* Default constructor.
*/
public LoginValidationFilter() {
// TODO Auto-generated constructor stub
}
/**
* @see Filter#destroy()
*/
public void destroy() {
// TODO Auto-generated method stub
}
/**
* @see Filter#doFilter(ServletRequest, ServletResponse, FilterChain)
*/
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest req = (HttpServletRequest) request;
HttpServletResponse res = (HttpServletResponse) response;
res.setCharacterEncoding("utf-8");
res.setHeader("Pragma", "No-cache");// 禁止缓存
res.setHeader("Cache-Control", "no-cache");
res.setHeader("Expires", "0");
PrintWriter out = res.getWriter();
HttpSession session = req.getSession();
if (session.getAttribute("loginid") != null) {
chain.doFilter(request, response);
} else {
String indexUrl = req.getContextPath() + "/login.html";
out.println("<script>alert('您没有登录登录，请先登录！need ReLogin!');this.location.href='" + indexUrl + "'; </script>");
}
}
/**
* @see Filter#init(FilterConfig)
*/
public void init(FilterConfig fConfig) throws ServletException {
// TODO Auto-generated method stub
}
}
Filter部署（映射）有两种方式，同servlet部署类假，一种是在web.xml中使用如下配置：
<filter>
<filter-name>LoginValidationFilter</filter-name>
<filter-class>cn.zuowenjun.java.LoginValidationFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>LoginValidationFilter</filter-name>
<url-pattern>/jsp/*</url-pattern>
</filter-mapping>
另一种方式就是使用@WebFilter注解，配置如下：
@WebFilter(filterName="LoginValidationFilter",urlPatterns="/jsp/*")
public class LoginValidationFilter implements Filter {
...
}
如此一个简单的JSP WEB示例网站代码就写完了，包含：登录、验证登录、查看数据、编辑数据，下面贴出运行效果，注意由于是DEMO，故没有严格按照编码规范及UI用户体验，只是为了演示结果：
当然还有一种类型没有介绍，那就是监听器：Listener，主要是用来监听 ServletContext, HttpSession, HttpServletRequest 这三个对象中的属性变更信息事件的监听器，可参考：https://www.cnblogs.com/xdp-gacl/p/3969249.html,我们可以使用ServletRequestListener的requestInitialized、requestDestroyed方法来写一个简单的记录当前demo网站的在线用户人数，实现比较简单，在此就不再展开介绍了。
七、打包部署到WEB服务器（Tomcat）
1.打包WAR包：直接参考这篇文章即可：https://www.cnblogs.com/yjq520/p/7323934.html，本身也简单就是导出时选择WAR包类型即可，在此就不介绍了。
2.部署到TOMCAT：只需将打包好的WAR包复制到tomcat的webapps目录下即可，在第一次运行时tomcat会自动解包并生成一个目录，本DEMO的示例发布到TOMCAT的效果：
最后就直接在浏览器中访问URL即可：localhost:8080/demo2/xxxx;
附加2个编码小技巧：
1.创建一个JSP文件，默认字符编码并不是UTF-8，故需要手动调整一下设置，如下图所示：
2.在eclipse中运行调试JSP网站，如果本地安装了TOMCAT且后台一直运行着默认实例，那么可能调试时会报端口被占用，如果被占用了，就需要修改一下项目下的端口，方法如下图所示：
注意server.xml中有好几种Connector配置，一般我们只需改protocal="HTTP"的即可，因为我们是运行WEB项目,
另外大家也看到后面还有一个redirectPort配置项，这个的作用是：当用户用http请求某个资源URL，而该资源本身又被设置了必须要https方式访问，此时Tomcat会自动重定向到这个redirectPort设置的https端口。
最后小结：
1.JSP WEB项目中页面类一般包含：HTML、JSP、Servlet，其中：HTML、JSP文件是可以直接编辑HTML，而Servlet一般只是用于服务端请求的逻辑处理，并没有提供直接的HTML，若需响应成HTML，得自己使用JAVA代码来动态拼出HTML，原则上不建议在Servlet类中拼大量的HTML，完全可以采用JSP来代替。JSP可以HTML与JAVA语言混合，大家也看我上面的DEMO代码，有些地方我用HTML静态页面，而有些我又使用JSP动态页面。如果对比ASP.NET项目，那么JSP文件类似ASP.NET中的ASPX文件，而Servlet类似于ASHX
2.Listener：用于监听捕获WEB应用、上下文、会话的改变，并根据每种事件处理相关逻辑，Filter：用于拦截每一个请求，并在拦截中处理相关逻辑（如：身份验证、记日志等），这些类似于ASP.NET项目中的IIS管道事件、global全局事件；
3.大家有没有发现，JSP WEB，要么前后分离（HTML纯前端、Servlet纯后端），要么就是混合（JSP，包含HTML+Servlet），那有没有一种后端控制前端，后端与前端无需对应，但又能各自变化呢？答案是可以的，这就是下一篇我要介绍的SSM框架，在此只是引入为什么需要MVC模式；
4.以前使用VS+ASP.NET，发现微软的很多东西都是开箱即用，无需过多配置就能快速上手，而eclipse+JSP WEB需要各种配置，最主要是eclipse的编码体验确实与VS相差太远。后续考虑会学习基于IDEA或VS CODE IDE来写JAVA WEB项目，到时候再来分享。
