語言環境介面參考手冊

語言環境介面函數

Net.Data 將四種介面函數用在一種語言環境上： 您可提供這些函數的其中一個或數個函數。 其中有三種函數是選用性的，但是每一個語言環境都必須要有 dtw_execute() 介面函數。 如果 Net.Data 巨集參照沒有 dtw_execute() 介面函數的語言環境， Net.Data 將傳回錯誤訊息同時停止處理 Net.Data 巨集。

欲呼叫語言環境，您可在 Net.Data 巨集的 FUNCTION 區塊中參照它。 您必須以下列次序來呼叫語言環境介面函數：

1. dtw_initialize()
2. dtw_execute()
3. dtw_getNextRow()
4. dtw_cleanup()

dtw_execute() 是唯一您必須提供在語言環境中的函數。

當 Net.Data 呼叫一個使用語言環境的函數時，它會用下列步驟來呼叫該語言環境：

1. 如果 Net.Data 已定義給這個語言環境， 則 Net.Data 會呼叫 dtw_initialize()。 此函數會執行語言環境所要求的任何起始設定作業， 例如連接至資料庫，或是配置變數。

2. Net.Data 呼叫 dtw_execute() 以處理巨集 FUNCTION 區塊，該區塊含有語言環境必須處理的陳述式。

3. 在成功的回覆中，如果 dtw_execute() 指示應呼叫 dtw_getNextRow()， Net.Data 就會呼叫 dtw_getNextRow()。

4. 當 Net.Data 巨集處理程序完成時，如果已將 dtw_cleanup() 定義在語言環境， 而且之後有傳回 Web 伺服器的話，Net.Data 就會呼叫 dtw_cleanup()， 以清除環境 (例如，切斷與資料庫的連線，或釋放變數)。

下列各節將為您說明介面函數：

• dtw_initialize()

• dtw_execute()

• dtw_getNextRow()

• dtw_cleanup()