Cómo trabajar con archivos de propiedades de fragmento de URL de punto final de servicios web

Puede utilizar archivos de propiedades para gestionar o cambiar fragmentos de URL de punto final o servicios web a los que se acceda a través de HTTP, SOAP y Java™ Message Service (JMS), o directamente como enterprise beans. Los fragmentos de URL se utilizan para formar las direcciones de punto final de servicios web completas incluidas en los archivos Web Services Description Language (WSDL) publicados.

Antes de empezar

Los fragmentos de URL de punto final son metadatos opcionales para aplicaciones de servicios web. Puede utilizar la consola administrativa o los archivos de propiedades para configurar y gestionar fragmentos de URL. Para poder consultar fragmentos de URL, debe establecer, en primer lugar, los fragmentos de URL mediante la consola administrativa o el mandato applyConfigProperties. Tras establecer inicialmente los fragmentos de URL con la consola administrativa o los archivos de propiedades, ahora puede modificar el fragmento de URL de punto final de servicios web con los archivos de propiedades o la consola administrativa.

Para obtener información sobre cómo utilizar la consola administrativa para establecer los fragmentos de URL, consulte la información sobre la configuración de URL de punto final para enlaces HTTP o sobre la configuración de URL de punto final para enlaces JMS.

Acerca de esta tarea

La versión 8.0 y posterior admite el uso de archivos de propiedades para gestionar fragmentos de URL de punto final para los servicios web a los que se accede mediante HTTP, SOAP y Java Message Service (JMS) o directamente como enterprise beans.

Puede especificar una parte del URL de punto final que debe utilizarse en cada módulo de servicio web. La parte que especifique se utiliza para crear el URL de punto final real cuando se publica un archivo WSDL. En un archivo WSDL publicado, el URL que define la dirección del punto final de destino se encuentra en el atributo de ubicación del elemento soap:address del puerto. Esta tarea se aplica a los servicios Web JAX-WS (Java API for XML-Based Web Services) y JAX-RPC (Java API for XML-based RPC).

Las propiedades de fragmento de URL de punto final de servicios web son extensiones del archivo de propiedades de aplicación. Cuando se utiliza el mandato extractConfigProperties para obtener un archivo de propiedades para una aplicación, también se obtienen los fragmentos de URL de punto final, junto con otras propiedades de aplicación. Utilice los mandatos applyConfigProperties, validateConfigProperties y deleteConfigProperties, como se describe en el procedimiento para actualizar, validar y suprimir fragmentos de URL de punto final en una aplicación de servicios web.

Procedimiento

  1. Extraiga el archivo de propiedades.
    Por ejemplo, para extraer las propiedades de la aplicación, sampleApplication, utilice el mandato extractConfigProperties.
    AdminTask.extractConfigProperties(['-propertiesFileName', 'myProperties.props', '-configData', 
    'Deployment=sampleApplication' ])
    Si antes ha configurado fragmentos de URL de punto final de servicios web, el sistema extrae los archivos de propiedades y el resultado contiene una sección para fragmentos de URL de punto final, como se muestra en el ejemplo siguiente:
    #
    # 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. Cree una instancia nueva del archivo de propiedades.
    Si modifica las propiedades de fragmentos de URL existentes o crea propiedades nuevas, utilice el mandato siguiente para aplicar propiedades de fragmento de URL. Este mandato crea o actualiza el archivo de metadatos correspondiente en la aplicación especificada. En este ejemplo, el parámetro -reportFileName opcional se utiliza para especificar que se genere un informe a partir del mandato.
    AdminTask.applyConfigProperties('[-propertiesFileName myProperties.props -reportFileName report.txt ]')
  3. Valide el archivo de propiedades.
    El mandato validateConfigProperties valida los nombres y los valores de propiedad del archivo de propiedades. Si todos los nombres y valores son válidos, el resultado del mandato es true. De lo contrario, el mandato devuelve un valor false; por ejemplo:
    AdminTask.validateConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName',
    'report.txt']) 
  4. Suprima el archivo de propiedades.

    Cuando se invoca un mandato deleteConfigProperties, el mandato suprime todas las propiedades que se especifiquen en el archivo de propiedades. Si va a empezar con un archivo de propiedades extraído previamente, elimine todas las secciones dentro del archivo de propiedades, salvo las secciones a las que desee aplicar el mandato deleteConfigProperties. Por ejemplo, si desea suprimir una correlación de prefijo de URL, elimine todas las secciones del archivo de propiedades extraído excepto la sección URLPrefix map y posiblemente la sección de variables de entorno, si va a utilizar variables.

    El mandato deleteConfigProperties suprime las propiedades especificadas en el archivo de propiedades; por ejemplo:
    AdminTask.deleteConfigProperties(['-propertiesFileName', 'myProperties.props', '-reportFileName', 'report.txt']) 

    El archivo myProperties.txt siguiente es un ejemplo de archivo de propiedades que puede utilizar para realizar una supresión de la correlación de prefijo de URL http para el módulo TestApp.jar:

    #
    # 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

Resultados

Puede utilizar archivos de propiedades de servicios web para consultar, configurar y gestionar fragmentos de URL de punto final de servicios web para distintos protocolos.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_wbs_endptURL_prop
File name: txml_wbs_endptURL_prop.html