從 JavaBeans for JAX-RPC 應用程式開發服務端點介面

如果您是從 JavaBeans 實作開發 JAX-RPC Web 服務,則必須開發服務端點介面。

開始之前

您需要設定 Web 服務的開發環境,並存取現有的 Java™ Bean Web 應用程式保存檔 (WAR)。 請參閱設定開發環境以取得 Web 服務資訊。

關於這項作業

這項作業是從 Java Bean 開發 JAX-RPC Web 服務的必要步驟。

服務端點介面定義特定 Java API for XML-Based RPC (JAX-RPC) Web 服務的方法。 JavaBeans 實作必須所實作的方法,其簽章與服務端點介面上的方法相同。 對於要使用哪些類型作為服務端點介面方法的參數和結果,會有一些限制。 JAX-RPC 規格中記載這些限制。

您也可以使用組合工具來建立服務端點介面。

遵循下列動作來開發 JavaBeans 實作的服務端點介面:

程序

  1. 建立 Java 介面,其中包含要包含在服務端點介面中的方法。
    如果您從現有的 Java 介面開始,請移除任何不符合 JAX-RPC 規格的方法。
  2. 編譯介面。

    javac 指令中使用服務端點介面類別的名稱,以讓類別進行編譯。

    [Windows]使用 javac 指令。

    [Linux][AIX][HP-UX][Solaris]在 AIX 或 Linux®之類的作業系統上,請參閱開發小型應用程式用戶端程式碼資訊。

結果

您已開發服務端點介面,可用來開發 Web 服務。

範例

下列範例描述 AddressBook 介面:
package addr;
public interface AddressBook {
    /**
     * Retrieve an entry from the AddressBook.
     * 
     *@param name the name of the entry to look up.
     *@return the AddressBook entry matching name or null if none.
     *@throws java.rmi.RemoteException if communications failure.
     */
    public addr.Address getAddressFromName(java.lang.String name);
}
使用 AddressBook 介面來建立服務端點介面:
  1. 建立 AddressBook.java 介面的副本,並將它命名為 AddressBook_SEI.java。 使用此副本作為服務端點介面的範本。
  2. 編譯介面。

下一步

繼續收集開發 Web 服務所需的構件,包括「Web 服務說明語言 (WSDL)」檔案。 您需要開發 WSDL 檔,因為它是 Web 服務的引擎。 如果沒有 WSDL 檔,則沒有 Web 服務。 請參閱開發 WSDL 檔,以取得 JAX-RPC 應用程式資訊。