「SQLJ 疊代子宣告」頁面

請利用這個頁面來指定您要建立之 SQLJ 疊代子宣告子句的資訊。

疊代子用來從查詢的結果表格中擷取值。疊代子是疊代子類別的物件。SQLJ 檔案會為您指定的每一個疊代子宣告子句都產生一個疊代子類別。 疊代子宣告子句會在 SQLJ 檔案中宣告已定位的疊代子類別或已指名的疊代子類別。

名稱
所產生的疊代子類別要用的有效 Java™ ID。
修飾元
所產生類別的存取修飾元。 您可以選擇下列其中一個修飾元:public、protected、private 或 default。
static
將產生的類別宣告為 static
實作
sqlj.runtime.ForUpdate
實作 sqlj.runtime.ForUpdate 介面以使用已定位的 UPDATE 或 DELETE 作業。 以已定位的 UPDATE 及 DELETE 作業而言, 疊代子必須在一個程式檔中宣告,而在另一個程式檔中使用。

如果選取了這個選項, 就可以使用更新直欄選項。

sqlj.runtime.Scrollable
在您想要宣告可捲動的疊代子時實作 sqlj.runtime.Scrollable 介面。 可捲動的疊代子是可用來在查詢結果表格中前移、 後移或移至特定列的疊代子。

如果選取了這個選項,就可以使用感應度選項。

使用者介面
可實作的其他介面類別清單。 這份清單中的項目是以逗點區隔。
With
指定 SQLJ WITH 子句的屬性。
保持能力
指定疊代子是否在 COMMIT 指令發出之後保持它在表格中的位置。 您可以選擇:
true
疊代子保持其位置。
false
疊代子不保持其位置。
default
保持能力屬性保留其預設值,即 false。
感應度
指定在疊代子的基礎表格開啟之後, 對該表格所做的變更在疊代子中是否可見。 您可以選擇:
SENSITIVE
對基礎表格所做的變更可見。當選取了這個選項時, 就可以使用動態選項。
INSENSITIVE
對基礎表格所做的變更不可見。
default
感應度屬性保留其預設值,即 INSENSITIVE。
只有在選取了 sqlj.runtime.Scrollable 勾選框時, 才可以使用 SQLJ WITH 子句的這個屬性。
動態
針對在「感應度」選項設為 SENSITIVE 下定義的疊代子, 指定下列情況的狀態:
  • 當應用程式執行疊代子中的已定位 UPDATE 和 DELETE 陳述式時, 那些變更對疊代子有效。
  • 當應用程式執行在應用程式內、但在疊代子外的 INSERT、UPDATE 和 DELETE 陳述式時, 那些變更對疊代子有效。
您可以選擇:
true
兩種情況都為 true。
false
兩種情況都為 false。
default
動態屬性保留其預設值,即 false。
如果「動態」選項設為 true, 則資料來源必須支援動態可捲動游標。

只有在選取了 sqlj.runtime.Scrollable 勾選框時, 才可以使用「動態」選項。

更新直欄
對已定位的 UPDATE 陳述式使用疊代子時要修改的直欄名稱。 這份清單中的名稱是以逗點區隔。如果顯示選取直欄按鈕, 則您可以選取直欄而非輸入它們。

只有在選取了 sqlj.runtime.ForUpdate 勾選框時, 才可以使用 SQLJ WITH 子句的這個屬性。

直欄宣告
對 SQLJ 疊代子宣告的結果表格中的直欄定義直欄宣告。
在「插入 SQLJ 疊代子」精靈中, 您可以指定下列一個資訊集:
  • 結果表格中的直欄之資料類型, 其宣告已定位的疊代子。這份清單中的資料類型是以逗點區隔。已定位的疊代子宣告中的資料類型順序, 必須與結果表格中的直欄順序相同。
  • 結果表格中的直欄之資料類型-名稱對組, 其宣告已指名的疊代子。這份清單中的資料類型-名稱對組是以逗點區隔。 疊代子中的直欄名稱必須與結果表格中的直欄名稱相符(大小寫除外)。
在「插入 SQL 子句」精靈中, 您可以選擇下列一個選項:
已定位
結果表格中的直欄之資料類型。選取這個選項會建立已定位的疊代子直欄宣告。
已指名
結果表格中的直欄之名稱和資料類型。選取這個選項會建立已指名的疊代子直欄宣告。

上層主題: 將 SQLJ 疊代子宣告子句新增至 SQLJ 檔中

上層主題: 將 SQLJ 指派子句新增至 SQLJ 檔案中

相關工作
在 SQLJ 應用程式中執行已定位的 UPDATE 和 DELETE 作業
在 SQLJ 應用程式中使用可捲動的疊代子
在 SQLJ 應用程式中使用已指名的疊代子
相關參考
SQLJ iterator-declaration-clause
「選取現有的 SQL 陳述式」頁面
「變數」頁面
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.