处理 Web Service 端点 URL 片段属性文件

可以使用属性文件来管理或更改 Web Service 的端点 URL 片段,这些片段通过 HTTP、SOAP 和 Java™ 消息服务 (JMS) 访问或作为企业 Bean 直接访问。URL 片段用于形成发布的 Web Service 描述语言 (WSDL) 文件中包含的完整 Web Service 端点地址。

开始之前

端点 URL 片段是 Web Service 应用程序的可选元数据。可以使用管理控制台或属性文件来配置和管理 URL 片段。必须先使用管理控制台或 applyConfigProperties 命令设置 URL 片段,然后才能查询 URL 片段。在使用管理控制台或属性文件对 URL 片段进行初始设置之后,现在可以使用属性文件或管理控制台修改 Web Service 端点 URL 片段。

要了解如何使用管理控制台来设置 URL 片段,请参阅有关配置 HTTP 绑定或 JMS 绑定的端点 URL 信息的信息。

关于此任务

V8.0 和更高版本支持使用属性文件来管理 Web Service 的端点 URL 片段,这些片段通过 HTTP、SOAP 和 Java 消息服务 (JMS) 访问或作为企业 Bean 直接访问。

您可以指定每个 Web Service 模块中要使用的端点 URL 的一部分。您指定的部分用于在发布 WSDL 文件时创建实际的端点 URL。在发布的 WSDL 文件中,可以在端口 soap:address 元素的位置属性中找到定义目标端点地址的 URL。此页面适用于 Java API for XML-Based Web Services (JAX-WS) 和 Java API for XML-based RPC (JAX-RPC) Web Service。

Web Service 端点 URL 片段属性是对应用程序属性文件的扩展。使用 extractConfigProperties 命令获取应用程序的属性文件时,您还会获取端点 URL 片段以及其他应用程序属性。使用 applyConfigProperties、validateConfigProperties 和 deleteConfigProperties 命令(过程中描述了这些命令)来更新、验证和删除 Web Service 应用程序中的端点 URL 片段。

过程

  1. 抽取属性文件。
    例如,要抽取应用程序 sampleApplication 的属性,请使用 extractConfigProperties 命令。
    AdminTask.extractConfigProperties(['-propertiesFileName', 'myProperties.props', '-configData', 
    'Deployment=sampleApplication' ])
    如果您先前配置了 Web Service 端点 URL 片段,那么系统将抽取属性文件,并且结果将包含端点 URL 片段的一部分,如以下示例所示:
    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Properties
    http=http://myhostname:80
    module=TestApp.jar
  2. 创建属性文件的新实例。
    如果您修改现有 URL 片段属性或创建新属性,请使用以下命令来应用 URL 片段属性:此命令创建或更新指定应用程序中的相应元数据文件。在此示例中,使用了可选 -reportFileName 参数来指定要从该命令生成报告。
    AdminTask.applyConfigProperties('[-propertiesFileName myProperties.props -reportFileName report.txt ]')
  3. 验证属性文件。
    validateConfigProperties 命令验证属性文件中的属性名和值。如果所有名称和值都有效,那么命令结果为 true。否则,命令返回 false 值;例如:
    AdminTask.validateConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName', 
    'report.txt']) 
  4. 删除属性文件。

    调用 deleteConfigProperties 命令时,该命令将删除属性文件中指定的所有属性。如果您要从先前抽取的属性文件着手,请移除该属性文件中除了要应用 deleteConfigProperties 命令的段之外的所有其他段。例如,如果要删除 URL 前缀映射,请从抽取的属性文件中删除除了 URLPrefix 映射段之外的所有其他段,如果要使用变量,那么可能还要保留环境变量段。

    deleteConfigProperties 命令删除属性文件中指定的属性;例如:
    AdminTask.deleteConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
     'report.txt']) 

    以下 myProperties.txt 文件是属性文件的一个示例,可以使用它来删除 TestApp.jar 模块的 http URL 前缀映射:

    #
    # CWSAD0103I: URLPrefixMap Section: module=TestApp.jar
    #
    ResourceType=Application
    ImplementingResourceType=Application
    ResourceId=Cell=!{cellName}:Deployment=!{applicationName}
    ExtensionId=ApplicationWebServicesExtension
    #
    
    #
    #Properties
    http=http://myhostname:80
    module=TestApp.jar
    
    #
    #
    EnvironmentVariablesSection
    #
    #
    #Environment Variables
    applicationName=TestApp
    cellName=XYZNode01Cell
    serverName=server1
    nodeName=XYZNode01

结果

可以使用 Web Service 属性文件来查询、配置和管理不同协议的 Web Service 端点 URL 片段。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wbs_endptURL_prop
文件名:txml_wbs_endptURL_prop.html