My Company Directory 應用程式可顯示目錄中所有現行員工的記錄清單。 這些記錄顯示在含有姓氏、名字、電子郵件和員工 ID 等可排序直欄的 JTable (employeesTable) 中。 為了取得表格的記錄,必須將 employeesTable 連結至 Web 服務資料來源範例傳回的資料物件。
為了取得本端資料物件供 employeesTable 使用,您將利用視覺化編輯器,將資料來源新增至應用程式。 資料來源會連接至 Web 服務 Proxy 範例,且會探索您的應用程式能夠使用的服務方法。 之後,您將選擇從資料來源提供的 getLightEmployeeRecord 服務方法。 最後,您會將應用程式中的 employeesTable 連結至列資料物件 (lightEmployeeRecordRows) 中傳回的欄位。
您可以利用 Java 視覺化編輯器的內建連結程式類別,又快又容易地建立所有這些資料來源和資料物件。 當您將視覺化元件連結至資料 Factory 時,視覺化編輯器會提供一組產生在專案中的通用介面和類別。 依預設,連結程式類別會產生在名稱為 jve.generated 的套件中。 視覺化編輯器會將連結程式類別提供成一項通用實作,供您進一步自訂和加強來配合您的應用程式需求。 這個指導教學示範預設連結程式類別基本又簡單的用法所擁有的功能和彈性。
在這個指導教學中,您將在應用程式中使用 Web 服務資料來源、若干類型的資料物件,以及若干類型的連結程式。 將這些物件的實例新增至應用程式時,視覺化編輯器會將必要的類別新增至專案的 jve.generated 套件中, 您可以在此延伸、取代或改寫資料連結邏輯。Java 視覺化編輯器提供了連結物件的視覺化支援,它會在設計視圖的開放式區域中,顯示應用程式所用的資料物件、資料來源和連結程式。視覺化編輯器會在視覺化元件和資料物件及資料來源之間繪製線條來顯示任何所選物件的現行連結。
下圖是視覺化元件、連結程式、資料物件和資料來源如何互動的簡單概觀。 您在這個指導教學中建置的應用程式說明稍微複雜且較有創意的連結程式用法。 這個圖不一定能完全如實反映您在建置的應用程式範例中的連結程式、資料物件和資料來源。
在圖 1 中,每個視覺化元件都有它自己的連結程式會將它關聯於資料物件,如果是按鈕,則是關聯於資料來源。 文字欄位的連結程式會將該欄位連結到資料物件的特定內容。這個圖解中的列資料物件和資料物件,都會直接呼叫資料來源的服務來取得其資料。文字欄位的資料物件會利用表格中所選的列中的鍵值來作為呼叫 Service2 的引數,這個呼叫會傳回完整的記錄,其中可能包括表格中所選列的詳細資訊。之後,這個完整記錄又用來作為按鈕呼叫 Service3 時,按鈕動作連結程式的引數,Service3 可能是更新欄位中所輸入之值的方法。如果需要資料物件、資料連結程式和資料來源的詳細說明,請遵循先前所提供的鏈結。
如果要使用在伺服器中執行的 Web 服務,您的 Java 應用程式需要一個與它互動的 Java Proxy 或用戶端。 您可以利用「Web 服務用戶端」精靈和 WSDL 檔,在 Java 專案中產生一個 Java Proxy。 您的 MyDirectory 專案包括將用來產生這個 Proxy 的 EmployeeDirectory.wsdl 檔。 產生 Java Proxy 之後,您可以建立代表 Web 服務的資料來源,並開始連結視覺化元件。
如果要在專案中產生 Web 服務 Java Proxy,請執行下列動作:
由於 employeesTable 是您在這個應用程式中連結的第一個視覺化元件,因此,您必須建立一個資料來源來指向剛新增到專案中的 Web 服務 Proxy 範例。 當您在稍後的練習中連結其他視覺化元件時,您會重複使用這個資料來源。 在這個步驟中,您將新增 Web 服務資料來源和 lightEmployeeRecordRows 資料物件。