4.3 使用 Java 介面來自定檔案處理程序

Java 介面可讓您使用自己撰寫的 Java 類別自定檔案處理程序。 這些介面為 InputSorter、InputSource、PreProcessor 和 PostProcessor。

需要 Java 程式設計才能如此提高驅動程式的效能。 若要實作此功能,請完成下列程序:

4.3.1 建立新的 Java 類別

JavaDoc 和範例類別內含在驅動程式中,可協助您實作此新功能。 您可在 platform \dirxml\drivers\delimitedtext\extensions 內找到這些檔案。

4.3.2 建立 Java .jar 檔案

在實作類別檔案後,請使用 jar 工具建立 Java 的 .jar 檔案 (Java 歸檔)。 .jar 檔案必須內含您所建立的類別。 將 .jar 檔案放入 novell/nds/lib 目錄中。 依據您所使用的平台不同,使用的路徑也可能不同,不過它應該位於與 DelimitedTextShim.jarDelimitedTextUtil.jar 相同的位置。

4.3.3 設定驅動程式以使用新類別

在將新的 .jar 檔案放置到正確位置之後,請修改驅動程式的內容,設定驅動程式以使用新的類別。

  1. 在 iManager 中,選取「Identity Manager」>「Identity Manager 概觀」。

  2. 在其驅動程式集中找出驅動程式。

  3. 按一下驅動程式圖示,以開啟「Identity Manager 驅動程式概觀」頁面。

  4. 再次按一下驅動程式圖示,以開啟「修改物件」頁面。

  5. 在下拉式功能表中選取「驅動程式組態」。

  6. 捲動至「驅動程式參數」,然後按一下「編輯 XML」。

  7. 找出檔案的 <publisher-options> 區段。

    此檔案會定義出現在「驅動程式組態」頁面之「驅動程式參數」區段中的參數和值。

    對於在「發行者」通道上運作的每個您所建立的類別,要在 <publisher-options> 區段中輸入額外的選項。 在更新此檔案後,您將會在介面中看到新的選項。

  8. 對於您在「發行者」通道上建立的每個新類別,要新增一個與介面類型對應的項目。 請使用下表做為指南:

    介面

    新項目

    InputSorter

    <input-sorter display-name="InputSorter Class">com.acme.MyNewClass</input-sorter>

    <input-sorter-params display-name="InputSorter init string">MY CONFIG PARAMS</input-sorter-params>

    InputSource

    <input-source display-name="InputSource Class">com.acme.MyNewClass</input-source>

    <input-source-params display-name="InputSource init string">MY CONFIG PARAMS</input-source-params>

    PreProcessor

    <pre-processor display-name="PreProcessor Class">com.acme.MyNewClass</pre-processor>

    <pre-processor-params display-name="PreProcessor init string">MY CONFIG PARAMS</pre-processor-params>

    1. 以您定義的類別名稱與完整套件識別符取代 com.acme.MyNewClass

    2. 以任何要傳遞至類別之 init 方法的資訊取代 MY CONFIG PARAMS

      類別的 init 方法接著會負責剖析內含在此字串內的資訊。 如果您的類別不需要將組態字串傳遞至 init 方法,可以結束整個元素,如此將傳遞空字串給 init 方法。

  9. 若您建立了一個「PostProcessor」規則,請找出檔案的 <subscriber-options> 區段,並新增下列資訊:

    <post-processor display-name="PostProcessor Class">com.acme.MyNewClass</post-processor> <post-processor-params display-name="PostProcessor init string">MY CONFIG PARAMS</post-processor-params> 
    
    1. 以您定義的類別名稱與完整套件資訊取代 com.acme.MyNewClass

    2. 以任何要傳遞至類別之 init 方法的資訊取代 MY CONFIG PARAMS

      類別的 init 方法接著會負責剖析內含在此字串內的資訊。 如果您的類別不需要將組態字串傳遞至 init 方法,可以結束整個元素,如此將傳遞空字串給 init 方法。

  10. 按一下「確定」。