Web 服務喜好設定

在開始開發 Web 服務或用戶端之前,您可以設定各種不同的喜好設定, 將用來開發 Web 服務的工作台最佳化。

如果要設定任一個 Web 服務喜好設定,請遵循下列步驟:
  1. 按一下視窗 > 喜好設定,開啟「喜好設定」記事本。
  2. 展開 Web 服務Web 和 XML,再按一下您要設定的喜好設定種類
  3. 選取當建立 Web 服務時您想要設定以作為預設值的勾選框。
  4. 按一下確定以套用變更,再關閉「喜好設定」筆記本。
如果您需要任一選項的詳細資訊,請選取選項,然後按 F1

Web 服務可讓您定義下列喜好設定:

Axis 發射程式
這個頁面可讓您設定在建立或耗用 Axis Web 服務時, 所使用的下列喜好設定。
WSDL2Java
  • 產生所有元素的程式碼:根據預設值,WSDL2Java 只會在 WSDL 檔中產生被參考到的那些元素的程式碼。如果需要關於如何參照工作的其他資訊, 請參閱 Axis 參考手冊:http://ws.apache.org/axis/java/reference.html
  • 針對中繼資料發出個別的 Helper 類別:如果您選取這個選項, WSDL2Java 會建立含有中繼資料的個別 Helper 類別, 而非將它納入 Skeleton 中。
  • 偏好將 Bean 建置到覆蓋 XML 陣列類型的直接陣列中: 預設行為是將以下 XML 區塊:
    <element name="array">
     <complexType>
      <sequence>
       <element name="item" type="xs:string"/>
      </sequence>
     </complexType>
    </element>
    對映至 Java String 陣列 (String[])。如果您希望產生這些類型之綱目的特定 JavaBean 類別 (ArrayOfString), 請選取這個選項。
  • 新增範圍至 deploy.wsdd:這會指出如何部署伺服器實作。 應用程式會對所有要求都使用一個實作類別實例。 要求會為每一個要求都建立一個新的實作類別實例。階段作業會為每一個階段作業都建立一個新的實作類別實例。
  • 逾時值(秒):預設值為 45。使用 -1 可停用逾時值。
Java2WSDL
  • 在繼承的類別中尋找允許的方法:如果指定這個選項, Java2WSDL 剖析器會深入查看延伸類別,以決定要匯入 WSDL 檔的方法清單。
  • 產生程式碼之前先分析服務類別是否符合 JAX-RPC: 如果選取,工具會檢查 Java 服務類別和其值類型, 以判斷其是否符合 JAX-RPC 規格的重要需求。
蹦現對話框選項
「對話框」喜好設定可讓您決定在執行蹦現動作時,您要看到的對話框。如果您在 Web 服務精靈的第一頁選取了「不再顯示這個對話框」來關閉所有對話框, 您可以清除您選擇要隱藏之對話框旁的勾選框,來還原您的變更。
規範標準和驗證
「WS-I 標準」喜好設定可讓您選取 WS-I Simple SOAP Binding Profile (SSBP) 和 WS-I Attachement Profile (AP) 的標準層次。附註:當不符合 WS-I 標準列在「作業」視圖中時,如果您變更符合 WS-I 標準的層次, 「作業」視圖就無法自動更新。必須先重新驗證工作區,才能夠從「作業」視圖中移除警告。如需 WS-I 的相關資訊,請參閱:http://www.ws-i.org/
在驗證喜好設定中,您可以選擇是否驗證 Web 服務精靈所用的 WSDL 檔案,以及在精靈進入下一步之前是否必須完成 WSDL 驗證。
專案拓蹼
您可以利用「專案拓蹼」喜好設定來執行下列動作:
  • 選取在產生 Web 服務用戶端時,Web 服務精靈要建立的預設用戶端專案類型。您也可以設定用戶端專案類型在精靈中的列出次序。請注意,這個選項只是預設值,在精靈中仍可以選取替代的專案類型。
  • 選擇您要在相同 EAR 專案或不同 EAR 專案中產生 Web 服務和 Web 服務用戶端。 在不同 EAR 專案中產生服務和用戶端,可以減少兩者同時存在於單一 EAR 專案時所可能發生的衝突,但會使用較多系統資源。
資源管理
「資源管理」喜好設定可讓您決定當建立 Web 服務時您所要使用之建立和改寫檔案與資料夾的預設值。
  • 改寫檔案而不警告:選取這個選項會允許精靈改寫工作區中的任何現有檔案, 而不會加以提示。如果未選取,每次需要改寫檔案時,系統都會加以提示。
  • 必要時建立資料夾:選取這個選項會使精靈建立任何必要的資料夾。
  • 移出檔案而不警告:選擇移出檔案時不顯示警告訊息來要求確認。
  • 合併產生的 Skeleton 檔:依預設,這個勾選框會停用。如果啟用這個勾選框,當同名的 Skeleton 檔已存在於工作區中時, 新產生的 Skeleton 檔會與現有的 Skeleton 檔合併。啟用這個選項可保留現有 Skeleton 檔中已修改的程式碼。

    請注意,當您啟用這個喜好設定時, 如果您變更介面的傳回類型,產生的 Skeleton 檔中有一個方法會傳回新介面所定義的類型, 但可能含有來自原始 Skeleton 檔的方法主體(其會傳回不同的類型)。這會導致編譯錯誤, 您必須手動加以更正。

實務預設值
「實務預設值」喜好設定可讓您設定當建立 Web 服務時所要使用的下列實務預設值:
  • 依預設,您要選取哪一種類型的 Web 服務和用戶端。
  • 您要在精靈中完成哪些階段的 Web 服務生命週期。
  • 依預設是否要啟動 Web 服務瀏覽器,使您能夠將 Web 服務發佈至 UDDI 登錄。
  • 是否要透過 TCP/IP 監視器遞送 Web 服務 SOAP 資料傳輸, 使您能夠監視 SOAP 封包,並選擇性地測試其是否符合 WS-I 標準。
請注意,這些所有預設值都可以在精靈中改寫。
伺服器和執行時期
選取您要在 Web 服務精靈中預設選取的伺服器、Web 服務執行時期環境以及 J2EE 版本。請注意,這些所有預設值都可以在精靈中改寫。
測試機能預設值
可以選取是否要讓精靈自動啟動測試機能, 且您可選取偏好的測試機能類型。
WSDL 檔
在 WSDL 編輯器中建立 WSDL 檔時,您可以設定預設目標名稱空間。如果您未選取要變更預設值, 則 WSDL 檔會以 http://tempuri.org 作為其目標名稱空間。