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
- 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
- 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 ]')
- 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'])
- 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.