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專案,到時候再來分享。