將關聯式記錄資料新增至 Faces JSP 頁面中

如果要在網頁上使用動態資料,您需要定義資料來源。關聯式記錄是您可以使用的動態資料來源之一。利用關聯式記錄作為資料來源,使用者可以在網頁上建立、讀取、更新或刪除記錄。

如果要利用「資料」抽屜將關聯式記錄新增至網頁中,請執行下列動作:
  1. 在選用區中開啟「資料」抽屜。
  2. 將選用區中的關聯式記錄拖曳至 Faces JSP 頁面。 這時會開啟「新增關聯式記錄」精靈。
  3. 指定要在頁面內參照記錄的名稱。
  4. 如果您已在專案的其他地方定義關聯式記錄, 並且想要使用該記錄的資料,請勾選重複使用現有的記錄或記錄清單中的 Meta 資料定義,並按一下瀏覽來搜尋輸入檔案。
  5. 如果要將資料控制項自動新增至頁面,請勾選新增輸入/輸出控制項,以在網頁中顯示記錄。如果您沒有勾選這一項,關聯式記錄會新增至頁面程式碼檔和「頁面資料」視圖中, 但資料元件不會新增至 Faces JSP 檔中。如果稍後要新增控制項,只要將記錄拖曳至頁面即可。 (請注意,將關聯式記錄新增至頁面的另一替代方式是使用「頁面資料」視圖而非「資料」抽屜。 首先,您要透過「頁面資料」視圖建立關聯式記錄,然後將記錄拖曳至網頁。)
  6. 在「建立控制項」區段中,當您將記錄拖曳至頁面時,請選取下列一個控制項:
    • 顯示現有的預記錄(唯讀): 預設元件通常是「輸出文字」元件,不過要視內容的執行時期類型而定。資料記錄已起始設定為包含現有的記錄中的資料。
    • 更新現有的記錄:預設元件是輸入欄位元件。 資料記錄已起始設定為包含現有的記錄中的資料。
    • 建立新記錄:預設元件是輸入欄位元件。 資料記錄已起始設定為空白記錄。 記錄顯示為資料庫中的新列。
  7. 下一步 這時會開啟「記錄內容」畫面。
  8. 指定連線名稱,或按一下新建來建立新的連線。
    1. 如果您按一下新建,就會開啟「新連線」畫面。
    2. 按一下建立新 DB 連線。這時會開啟「新建資料庫連線」精靈。如果需要使用這個精靈建立新資料庫連線的相關資訊,請參閱說明主題「利用精靈連接資料庫」。
  9. 從資料來源中選取您要使用的表格。
  10. 下一步 這時會開啟「直欄選項和其他作業」畫面。
  11. 在「直欄選項和其他作業」畫面上:
    1. 選取要併入關聯式記錄的直欄(欄位)。
    2. 如果要進一步修正記錄,您可以按一下下列其中一個作業或進階作業:
      • 修改主鍵:會開啟「編輯主鍵」對話框,並列出可用的直欄和主鍵直欄。 請使用箭頭來變更主鍵直欄。
      • 次序結果:會開啟「次序」對話框並列出可用的直欄。 選取要排列次序的直欄並選擇如何組織它們(升冪或降冪)。
      • 過濾結果:這時會開啟「過濾」對話框。按一下「新增 (+)」按鈕以開啟「條件」對話框。 您可以在這裡過濾記錄,只讓符合特定條件的那些記錄顯示出來。
      • 透過關係新增另一個資料庫表格:這時會開啟「建立關係」精靈,您可以從現行資料庫建立現有的關係, 或建立新關係。
      • 自動產生金鑰:這時會開啟「產生金鑰」對話框。勾選使用自動產生金鑰, 然後選擇表格和您要用於自動產生金鑰的兩個直欄。
      • 設定並行控制項:這時會開啟「並行」對話框。選擇衝突直欄 [這裡需要更多說明]
    3. 下一步。 這時會開啟「配置資料控制項」畫面
  12. 在「配置資料控制項」畫面上:
    1. 選取您要顯示的欄位、變更顯示在欄位旁的標籤, 以及選取要使用的控制項類型。根據您選擇要顯示、更新或建立記錄而定,控制項類型可包括「輸出欄位」、「輸出格式化文字」、「組合框」、「輸入欄位」、「輸入文字區域」和其他等等。 使用上移鍵和下移鍵來變更欄位的次序。
    2. 如果您想要建立其他選項,請按一下選項。 這時會開啟「選項」對話框。
    3. 在「選項」對話框的「標籤」標籤上,您可以對齊標籤,使每一個標籤置中對齊,或靠左或靠右對齊。 您也可以選擇在每一個標籤之後附加一個冒號,並將每一個標籤的第一個字母大寫。
    4. 在「進階」標籤上,您可以在深度旁邊輸入深度層次。 深度層次設定在「頁面資料」視圖中顯示的資料層次數目。 如果您選擇深度 3,則「頁面資料」視圖會顯示含有三個資料層次的關聯式記錄清單(或其他資料來源)。 勾選使用預設深度,以變更使用者的預設深度層次。勾選只建立資料控制項,只在頁面上建立資料控制項。 如果未勾選這個選項,則會建立資料控制項和其他相關的控制項。 比方說,如果您要建立「輸入文字」元件,且您勾選只建立資料控制項, 則只會在頁面上建立該元件。 不過,如果您沒有勾選這個選項,則會建立「輸入文字」元件和「顯示錯誤」元件、「標籤」元件, 也許還有送出按鈕。勾選在程式碼中併入 <label> 標示來建立 <label> 標示,以增加標籤協助工具。
    5. 如果您選擇要更新記錄,「按鈕」標籤也會顯示在「選項」對話框上。 在「按鈕」標籤上,您可以選擇要包括送出按鈕 (來送出任何更新項目)和刪除按鈕(來刪除記錄)。
    6. 如果您選擇要建立記錄,「按鈕」標籤會顯示在「選項」對話框上。 在「按鈕」標籤上,您可以選擇要包括送出按鈕(來送出新建的記錄)。
  13. 按一下完成 這時會根據您選取的項目,開啟包含列和其他元件的 HTML 表格。 比方說,如果您選擇要更新現有的記錄,就會顯示一個輸入文字元件, 它可能包括用來執行更新記錄和刪除記錄動作的送出刪除按鈕。
請注意,新 UI 元件的資訊已填入其「內容」視圖中。

當您建立資料記錄時,會設定預設過濾條件來決定要顯示的記錄。 過濾條件會尋找主鍵直欄符合參數值的記錄(該參數名稱符合主鍵直欄名稱)。 這樣就可以很容易地設定更新或詳細資料頁面。當您鏈結到這個頁面時,應該使用這個參數來傳遞主鍵直欄的值給它。 否則,網頁只會顯示它讀取到的第一筆記錄的值。 您可以配置資料記錄來變更過濾條件。

除了新增關聯式記錄之外,您也可以新增關聯式記錄清單至網頁中。

如果要進一步瞭解關於資料表和關聯式記錄清單以及關於自動產生索引鍵, 請進行下列指導教學:

利用 JavaServer Faces 在網頁中顯示動態資訊
相關概念
Faces 元件
Faces 元件的資料存取
資料表元件
相關工作
使用 Faces 元件 - 概觀
建立關聯式資料庫的連線
利用精靈連接資料庫
將關聯式記錄清單新增至 Faces JSP 檔中
將 JavaBean 新增至 Faces JSP 檔中
在 Faces JSP 檔中建立 Web 服務
將資料表新增至 Faces JSP 檔中
相關參考
Faces 元件參照
Faces 屬性參照
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.