JSP頁面查詢顯示常用模式 (附原始碼)

JSP頁面查詢顯示常用模式 title: JSP頁面查詢顯示常用模式

author: evan

email: evan_zhao@hotmail.com
    
背景：
1．    需要將資料庫查詢結果在JSP中以列表方式顯示
2．    在一個良好的J2EE模式中資料庫查詢一般用DAO實現（Data Access Object）， JSP僅用於顯示資料

問題：
    通過JDBC ResultSet可擷取查詢結果（存在於資料庫緩衝區內），但在Statement、Connection關閉後ResultSet即不可用。因此需要一種方式取出所有查詢結果並傳遞至JSP頁面。

解決方案一：
    使用Value Object。將每條記錄均封裝成JavaBean對象，把這些對象裝入Collection傳送給JSP顯示。這種方法的缺點是每一種查詢都需要定義一個java class，並且將記錄資料封裝成java對象時也需要很多額外的代碼。
範例程式碼：

1. 
   
2. //查詢資料代碼
3.   Connection conn = DBUtil.getConnection();
4.   PreparedStatement pst = null;
5.   ResultSet rs = null;
6.   try{
7.     String sql=“select emp_code, real_name from t_employee where organ_id=?”;
8.     pst = conn.preparedStatement(sql);
9.     pst.setString(1, “101”);
10.     ResultSet rs = pst.executeQuery();
11.     List list = new ArrayList();
12.     Employee emp;
13.     while (rs.next()){
14.       emp = new Employee();
15.       emp.setReakName(rs.getString(“real_name”));
16.       emp.setEmpCode(rs.getString(“emp_code”));
17.       …
18.       list.add(emp);
19.     }
20.     return list;
21.   }finally{
22.     DBUtil.close(rs, pst ,conn);
23.   }
24. 
    
25. 
    
26. //jsp顯示部分代碼
27. <%
28.   List empList = (List)request.getAttribute(“empList”);
29.   if (empList == null) empList = Collections.EMPTY_LIST;
30. %>
31. …
32. <table  cellspacing="0" width=”90%”>
33.     <tr>  <td>代碼</td> <td>姓名</td>  </tr>
34. <%
35.   Employee emp;
36.   for (int i=0; i< empList.size(); i++){
37.     emp = (Employee) empList.get(i);
38. %>
39.     <tr>  
40.       <td><%= emp.getEmpCode()%></td> 
41.       <td><%= emp.getRealName()%></td>  
42.     </tr>
43. <%
44.   }// end for
45. %>
46. </table>

解決方案二：
    遍曆ResultSet取出所有資料封裝進Collection。
具體做法：
1．    產生一個List對象(List list = new ArrayList() )。
2．    產生一個Map對象(Map map = new HashMap() )。使用Map封裝一行資料，key為各欄位名，value為對應的值。(map.put(“USER_NAME”), rs.getString(“USER_NAME”))
3．    將第2 步產生的Map對象裝入第1步的list對象中(list.add(map) )。
4．    重複2、3步直到ResultSet遍曆完畢
在DBUtil. resultSetToList(ResultSet rs)方法中實現了上述過程（所有列名均使用大寫），可參考使用。

範例程式碼：

1. 
   
2. //查詢資料部分代碼：
3.   …
4.   Connection conn = DBUtil.getConnection();
5.   PreparedStatement pst = null;
6.   ResultSet rs = null;
7.   try{
8.     String sql=“select emp_code, real_name from t_employee where organ_id=?”;
9.     pst = conn.preparedStatement(sql);
10.     pst.setString(1, “101”);
11.     rs = pst.executeQuery();
12.     List list = DBUtil. resultSetToList(ResultSet rs);
13.     return list;
14.   }finally{
15.     DBUtil.close(rs, pst ,conn);
16.   }
17. 
    
18. 
    
19. 
    
20. //JSP顯示部分代碼
21. <%
22.   List empList = (List)request.getAttribute(“empList”);
23.   if (empList == null) empList = Collections.EMPTY_LIST;
24. %>
25. …
26. <table  cellspacing="0" width=”90%”>
27.     <tr>  <td>代碼</td> <td>姓名</td>  </tr>
28. <%
29.   Map colMap;
30.   for (int i=0; i< empList.size(); i++){
31.     colMap = (Map) empList.get(i);
32. %>
33.   <tr>  
34.     <td><%=colMap.get(“EMP_CODE”)%></td> 
35.     <td><%=colMap.get(“REAL_NAME”)%></td>  
36.   </tr>
37. <%
38.   }// end for
39. %>
40. </table>

解決方案三：
    使用RowSet。
RowSet是JDBC2.0 中提供的介面,Oracle對該介面有相應實現，其中很有用的是oracle.jdbc.rowset.OracleCachedRowSet。  OracleCachedRowSet實現了ResultSet中的所有方法，但與ResultSet不同的是，OracleCachedRowSet 中的資料在Connection關閉後仍然有效。

oracle的rowset實現在http://otn.oracle.com/software/content.html的jdbc下載裡有，名稱是ocrs12.zip

範例程式碼：

1. //查詢資料部分代碼：
2.   import javax.sql.RowSet;
3.   import oracle.jdbc.rowset.OracleCachedRowSet;
4.   …
5.   Connection conn = DBUtil.getConnection();
6.   PreparedStatement pst = null;
7.   ResultSet rs = null;
8.   try{……
9.     String sql=“select emp_code, real_name from t_employee where organ_id=?”;
10.     pst = conn.preparedStatement(sql);
11.     pst.setString(1, “101”);
12.     rs = pst.executeQuery();
13.     OracleCachedRowSet ors = newOracleCachedRowSet();
14.     //將ResultSet中的資料封裝到RowSet中
15.     ors.populate(rs);
16.     return ors;
17.   }finally{
18.     DBUtil.close(rs, pst, conn);
19.   }
20. 
    
21. 
    
22. //JSP顯示部分代碼
23. <%
24.   javax.sql.RowSet empRS = (javax.sql.RowSet) request.getAttribute(“empRS”);
25. %>
26. …
27. <table  cellspacing="0" width=”90%”>
28.     <tr>  <td>代碼</td> <td>姓名</td>  </tr>
29. <%
30.   if (empRS != null) while (empRS.next() ) {
31. %>
32.   <tr>  
33.     <td><%= empRS.get(“EMP_CODE”)%></td> 
34.     <td><%= empRS.get(“REAL_NAME”)%></td>  
35.   </tr>
36. <%
37.   }// end while
38. %>
39. </table>

適用場合：
  方法一使用於定製的查詢操作
  方法二適用於多條查詢語句或需要對查詢結果進行處理的情況。
  方法三適合於單條查詢語句，適用於快速開發。

相關連結：
    如果需要分頁顯示請參考：JSP分頁技術實現
    如果查詢結果需要產生WORD或者EXCEL，請參考：使用jsp實現word、excel格式報表列印

附：DBUtil代碼：

1. import java.util.List;
2. import java.util.ArrayList;
3. import java.util.Map;
4. import java.util.HashMap;
5. import java.util.Properties;
6. import java.util.Collections;
7. 
   
8. import java.sql.Connection;
9. import java.sql.SQLException;
10. import java.sql.ResultSet;
11. import java.sql.ResultSetMetaData;
12. import java.sql.Statement;
13. import java.sql.PreparedStatement;
14. 
    
15. import javax.naming.Context;
16. import javax.naming.InitialContext;
17. import javax.naming.NamingException;
18. 
    
19. import javax.sql.DataSource;
20. 
    
21. public class DBUtil{
22. 
    
23.     private static final String JDBC_DATA_SOURCE = "java:comp/env/jdbc/DataSource";
24. 
    
25.     /**
26.      enableLocalDebug: 是否在本地調試。<br>
27.      值為true時如果尋找資料來源失敗則使用DriverManager與資料庫建立串連；
28.      如果為false則只尋找資料來源建立資料庫連接。
29.      預設為false。<br>
30.      可通過系統屬性jdbc.enable_local_debug=true設定enableLocalDebug為true，啟用本地調試：<br>
31.      增加JVM parameter： -Djdbc.enable_local_debug=true
32.      */
33.     private static boolean enableLocalDebug = false;
34. 
    
35.     static{
36.         enableLocalDebug = Boolean.getBoolean ("jdbc.enable_local_debug");
37.     }
38. 
    
39. 
    
40.     private static Context ctx = null;
41.     private static javax.sql.DataSource ds = null;
42. 
    
43. 
    
44.     private static void initDataSource() throws Exception{
45.         // Put connection properties in to a hashtable.
46. 
    
47. 
    
48.         if (ctx == null) {
49.             ctx = new InitialContext();
50.         }
51.         if (ds == null) {
52.             ds = (javax.sql.DataSource) ctx.lookup(JDBC_DATA_SOURCE);
53.         }
54.     }        
55. 
    
56.     /**
57.      * 尋找應用伺服器資料來源，從資料來源中獲得資料庫連接。<br><br>
58.      * 在本地調試時如果尋找資料來源失敗並且enableLocalDebug==true
59.      * 則根據系統屬性使用java.sql.DriverManager建立串連。<br>
60.      * 本地調試時可配置的系統屬性如下：<br>
61.      * <p>
62.      *     #jdbc驅動程式名 <br>
63.      *     jdbc.driver=<i>oracle.jdbc.driver.OracleDriver</i> <br> <br>
64.      *     #資料庫連接串<br>
65.      *     jdbc.url=<i>jdbc:oracle:thin:@10.1.1.1:1521:ocrl</i> <br> <br>
66.      *     #資料庫使用者名稱<br>
67.      *     jdbc.username=<i>scott</i> <br> <br>
68.      *     #資料庫使用者密碼<br>
69.      *     jdbc.password=<i>tiger</i> <br>
70.      * </p>
71.      * 可通過JVM參數設定上述系統屬性：<br>
72.      * -Djdbc.driver=oracle.jdbc.driver.OracleDriver 
73.      *  -Djdbc.url=jdbc:oracle:thin:@10.1.1.1:1521:ocrl
74.      *  -Djdbc.username=scott -Djdbc.password=tiger
75.      * @return Connection
76.      * @throws NamingException 如果資料來源尋找失敗
77.      * @throws SQLException 如果建立資料庫連接失敗
78.      */
79.     public static Connection getConnection() throws  SQLException{
80.         try{
81.             initDataSource();
82.             return ds.getConnection();
83.         }catch(SQLException sqle){
84.             throw sqle;
85.         }catch(Exception ne){
86.             if (enableLocalDebug){
87.                 return getTestConn();
88.             }else{
89.                 throw new RuntimeException(ne.toString());
90.             }
91.         }
92.     }
93. 
    
94. 
    
95.     //通過DriverManager建立本地測試連接
96.     private static Connection getTestConn(){
97.       try {
98.           String driver = System.getProperty("jdbc.driver");
99.           System.out.println("jdbc.driver="+driver);
100. 
     
101.           String url = System.getProperty("jdbc.url");
102.           System.out.println("jdbc.url="+url);
103. 
     
104.           String userName = System.getProperty("jdbc.username");
105.           System.out.println("jdbc.username="+userName);
106. 
     
107.           String password = System.getProperty("jdbc.password");
108.           System.out.println("jdbc.password="+password);
109. 
     
110.           Class.forName(driver).newInstance();
111.           return java.sql.DriverManager.getConnection(url, userName, password);
112.       }
113.       catch (Exception ex) {
114.         ex.printStackTrace();
115.         throw new RuntimeException(ex.getMessage());
116.       }
117.     }
118. 
     
119.     /**
120.      * 將查詢結果封裝成List。<br>
121.      * List中元素類型為封裝一行資料的Map，Map key為欄位名（大寫），value為相應欄位值
122.      * @param rs ResultSet
123.      * @return List
124.      * @throws java.sql.SQLException
125.      */
126.     public static List resultSetToList(ResultSet rs) throws java.sql.SQLException{
127.         if (rs==null) return Collections.EMPTY_LIST;
128. 
     
129.         ResultSetMetaData md = rs.getMetaData();
130.         int columnCount = md.getColumnCount();
131. 
     
132.         List list = new ArrayList();
133.         Map rowData;
134.         while (rs.next()){
135.             rowData = new HashMap(columnCount);
136.             for (int i=1; i<=columnCount; i++){
137.                 rowData.put(md.getColumnName(i),rs.getObject(i));
138.             }
139.             list.add(rowData);
140.         }
141.         return list;
142.     }
143. 
     
144.     /**
145.      * 關閉ResultSet、Statement和Connection
146.      * @param rs ResultSet to be closed
147.      * @param stmt Statement or PreparedStatement  to be closed
148.      * @param conn Connection  to be closed
149.      */
150.     public static void close(ResultSet rs, Statement stmt, Connection conn){
151.             if (rs != null) try{
152.                 rs.close();
153.             }catch(java.sql.SQLException ex){
154.                 ex.printStackTrace();
155.             }
156.             if (stmt != null) try{
157.                  stmt.close();
158.             }catch(java.sql.SQLException ex){
159.                 ex.printStackTrace();
160.             }
161.             if (conn != null) try{
162.                 conn.close();
163.             }catch(java.sql.SQLException ex){
164.                 ex.printStackTrace();
165.             }
166.     }
167. 
     
168. }// end of DBUti