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://172.20.3.31:3341;DatabaseName=LMSKYEXPRESS",
"dev07", "[email protected]#4E90$%%1F048C96BF;");
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專案，到時候再來分享。