Web service 首选项

在开发 Web service 或客户机之前,可以通过设置大量首选项来优化用于 Web service 开发的工作台。

要设置任何 Web service 首选项,请遵循下列步骤:
  1. 单击窗口 > 首选项来打开“首选项”笔记本。
  2. 展开 Web serviceWeb 和 XML,并单击需要设置的首选项类别。
  3. 选择在创建 Web service 时需要设置为缺省值的复选框。
  4. 单击确定以应用更改并关闭“首选项”笔记本。
如果需要有关任何选项的更多信息,则选择该选项并按 F1 键。

Web service 工具使您能够定义下列首选项:

Axis 发射器
此页面使您可以设置在创建或使用 Axis Web service 时使用的下列首选项。
WSDL2Java
  • 为所有元素生成代码:缺省情况下,WSDL2Java 只为 WSDL 文件中的那些被引用的元素生成代码。有关引用如何工作的其他信息,请参阅 Axis 参考指南:http://ws.apache.org/axis/java/reference.html
  • 为元数据发出单独的 Helper 类:如果选择此选项,则 WSDL2Java 将创建包含元数据而不是将元数据包括在框架中的单独 helper 类。
  • 对于已包装的 XML 数组类型,首选构建 Bean 而不是直线数组:缺省行为是将此 XML 构造映射到 Java 字符串数组(String[]):
    <element name="array">
     <complexType>
      <sequence>
       <element name="item" type="xs:string"/>
      </sequence>
     </complexType>
    </element>
    如果宁愿为这些类型的模式生成特定 JavaBean 类(ArrayOfString),则请选择此选项。
  • 将作用域添加至 deploy.wsdd:这指示如何部署服务器实现。应用程序将该实现类的一个实例用于所有请求。请求会为每个请求创建该实现类的一个新实例。会话会为每个会话创建该实现类的一个新实例。
  • 超时(以秒计):缺省值为 45。请使用 -1 来禁用超时。
Java2WSDL
  • 在继承的类中查找允许的方法:如果指定了此选项,则 Java2WSDL 解析器将观察扩展的类,以确定要导出到 WSDL 文件中的方法列表。
  • 在生成代码之前,分析服务类以确定是否与 JAX-RPC 一致:如果选择了此项,则工具将检查 Java 服务类及其值类型,以确定它是否满足 JAX-RPC 规范的重要要求。
选择弹出对话框
“对话框”首选项使您能够确定在运行弹出操作时需要看到哪些对话框。如果您通过选择 Web service 向导第一个页面上的“不再显示此对话框”而禁用了任何对话框,则可以通过清除您已选择要隐藏的对话框旁边的复选框来撤销更改。
概要文件一致性和验证
“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 service 向导移至下一步之前是否验证该向导使用的 WSDL 文件以及是否必须完成 WSDL 验证。
项目拓扑
“项目拓扑”首选项允许您:
  • 选择在生成 Web service 客户机时 Web service 向导将创建的缺省客户机项目类型。还可以在向导中设置将列示客户机项目类型的顺序。注意,此选择仅仅是一个缺省值,可以在向导中选择一种备用项目类型。
  • 选择是想在相同 EAR 项目中还是在不同 EAR 项目中生成 Web service 和 Web service 客户机。将服务和客户机生成到不同 EAR 项目中与这两者存在于单个 EAR 项目中相比,发生冲突的机会要少,但是将使用较多系统资源。
资源管理
“资源管理”首选项使您能够确定在创建 Web service 时需要使用的文件和文件夹创建及覆盖缺省值。
  • 覆盖文件而不发出警告:选择此项将使向导可以覆盖工作空间中的任何现有文件而不发出提示。如果未选择它,则每次需要覆盖文件时都将提示您。
  • 必要时创建文件夹:选择此向导会使向导能够创建任何必需的文件夹。
  • 检出文件而不发出警告:选择此项以检出文件,而不出现请求确认的警告消息。
  • 合并生成的框架文件:缺省情况下,此复选框被禁用。如果此复选框已启用,则当同名的框架文件已存在于工作空间中时,新生成的框架文件将与现有框架文件合并。启用此项以保留现有框架文件中已修改的代码。

    请注意,当此首选项已启用时,如果更改接口的返回类型,则产生的框架文件将有返回新接口中定义的类型的方法,但是方法主体将来自原始框架文件(它将返回另一类型)。这将导致必须手工更正的编译错误。

方案缺省值
“方案缺省值”首选项使您能够设置下列在创建 Web service 时需要使用的方案缺省值:
  • 缺省情况下,需要选择的 Web service 和客户机的类型。
  • Web service 生命周期中需要在向导中完成的那些阶段。
  • 缺省情况下,您是否需要启动 Web service 资源管理器,以便可以将 Web service 发布至 UDDI 注册中心。
  • 您是否需要通过 TCP/IP 监视器来路由 Web service SOAP 流量,以便可以监视 SOAP 信息包,并且可以选择测试它们以了解 WS-I 一致性。
注意,所有这些缺省值都可以在向导中被覆盖。
服务器和运行时
选择您在缺省情况下需要在 Web service 向导中选择的服务器、Web service 运行时环境和 J2EE 版本。注意,所有这些缺省值都可以在向导中被覆盖。
测试工具缺省值
可以选择是否想让向导自动启动测试工具,并且可以选择测试工具的首选类型
WSDL 文件
当在 WSDL 编辑器中创建 WSDL 文件时,可以设置缺省目标名称空间。如果您选择不更改缺省值,则 WSDL 文件将把 http://tempuri.org 作为它的目标名称空间。