Mandato createWSNService
Utilice el mandato createWSNService para crear un nuevo servicio WS-Notification y los objetos asociados que forman la infraestructura de la configuración de WS-Notification.
Puede crear un nuevo servicio WS-Notification utilizando la herramienta wsadmin como se describe en este tema, o bien utilizando la consola administrativa como se describe en Creación de un nuevo servicio WS-Notification Versión 6.1 y Creación de un nuevo servicio WS-Notification Versión 7.0.
Si está creando un servicio WS-Notification Versión 6.1, primero asegúrese de que ha configurado correctamente un repositorio SDO como se describe en Instalación y configuración del repositorio de SDO. El repositorio SDO se utiliza para almacenar documentos WSDL durante la creación del servicio WS-Notification Versión 6.1. Si no configura el repositorio, se visualiza un mensaje de error al crear el servicio.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
- Si desea una lista de los mandatos de WS-Notification disponibles, además de una breve
descripción de cada mandato, escriba el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('WSNotificationCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Finalidad
Este mandato crea un nuevo servicio WS-Notification en un bus de integración de servicios. Si está creando un servicio WS-Notification Versión 6.1, el mandato también crea los tres servicios de entrada del bus de integración de servicios que representan los tres roles desempeñados por el intermediario y crea la asociación entre estos objetos y el nuevo servicio WS-Notification.
Objeto de destino
Un bus de integración de servicios existente (condicional, debe proporcionarse si no se ha proporcionado el parámetro bus).
Parámetros necesarios
- -name
- El nombre que se dará al nuevo servicio WS-Notification. El nombre forma parte del punto final en el que se expone el servicio (es decir, el URL utilizado para acceder a puntos de servicio de WS-Notification que se han definido bajo el servicio).
- Para servicios de la Versión 6.1 de WS-Notification, el nombre del servicio es exclusivo dentro de un bus. Para los servicios de WS-Notification versión 7.0, el nombre de servicio es exclusivo dentro de la célula, que coincide con el modelo de administración utilizado para los conjuntos de políticas y, por lo tanto, soporta la composición de servicios WS-Notification versión 7.0 con WS-ReliableMessaging.
Parámetros condicionales
- -bus
- El nombre del bus de integración de servicios que albergará el servicio WS-Notification. Puede ser un bus existente o bien el nombre de un bus nuevo que desea que el mandato cree automáticamente. Este parámetro sólo debería especificarse si no se proporciona ningún objeto de destino.
Parámetros opcionales
- -type
- El tipo de servicio WS-Notification que se crea. Los valores permitidos son V7.0 y V6.1 (el valor predeterminado).
- Versión 7.0: Utilice este tipo de servicio si desea componer un servicio de JAX-WS WS-Notification con las calidades de servicio (QoS) (QoS) web a través de conjuntos de política, o si desea aplicar los manejadores JAX-WS en el servicio WS-Notification. Éste es el tipo de servicio que se aconseja para nuevos despliegues. Esta opción WS-Notification ha quedado disponible en WebSphere Application Server desde Versión 7.0.
- Versión 6.1: Utilice este tipo de servicio si desea exponer un servicio JAX-RPC WS-Notification utilizando la misma tecnología que se proporcionan en WebSphere Application Server Versión 6.1, incluida la posibilidad de aplicar manejadores JAX-RPC al servicio. Esta opción WS-Notification ha quedado disponible en WebSphere Application Server desde Versión 6.1.
- Especifique solamente los siguientes parámetros opcionales si el tipo de servicio es Versión 6.1:
- -jaxrpcHandlerList
- -outboundSecurityConfigName
- -outboundSecurityRequestBindingName
- -outboundSecurityResponseBindingName
Nota: Para los servicios WS-Notification Versión 7.0, se proporcionan funciones equivalentes a los atributos de seguridad de salida de la Versión 6.1 mediante la configuración de conjuntos de políticas.Especifique solamente los siguientes parámetros opcionales si el tipo de servicio es Versión 7.0:- -jaxwsHandlerListName
- -queryWSDL
- -description
- -permitsDynamicTopicNamespace
Es decir, si este servicio permite crear espacios de nombres de tema dinámicos en el tiempo de ejecución. Para obtener más información, consulte Espacio de nombres de tema dinámico. Los valores permitidos son TRUE (el valor predeterminado) y FALSE
Utilice esta opción para controlar estrechamente los espacios de nombres de tema que se utilizan al conectarse a un servicio WS-Notification concreto (por ejemplo, para los requisitos de seguridad o auditoría). Si deselecciona esta opción, las aplicaciones conectadas al servicio WS-Notification y los temas de petición de un espacio de nombres de tema dinámico no se publicarán ni recibirán mensajes.
Todos los mensajes publicados en un espacio de nombres de tema dinámico se insertan con el valor predeterminado de fiabilidad de mensaje de fiable persistente. Si este valor no es aceptable, cree un espacio de nombres de tema permanentes y configure manualmente el atributo en el valor apropiado.
Nota: Los espacios de nombres de tema dinámicos utilizados en un servicio WS-Notification concreto están respaldados por un espacio de temas del bus de integración de servicios que se crea automáticamente al crear el espacio de nombres de tema. La sintaxis de los temas utilizados en este espacio de temas es interna a la implementación de servicios WS-Notification.- -dynamicTopicSpace
- Es decir, que el nombre del espacio del tema de bus utilizado para alojar el nombre del espacio de nombres adecuado y para alojar los espacios de nombres de temas dinámicos, si están permitidos. Si no se ha especificado, este valor es de forma predeterminada WSN_dinámico_este_nombre_servicio.
- -requiresRegistration
- Distintivo booleano. Los valores permitidos son TRUE y FALSE (el valor predeterminado).
- -jaxwsHandlerListName
- Una lista de manejadores define los manejadores que se aplican cuando se realizan invocaciones de servicio web de salida, por ejemplo la supervisión de notificaciones de sucesos de salida (en respuesta a una operación de suscripción) y el control de los editores basados en demanda (suscribir, pausa y reanudar). Para obtener más información sobre las listas de manejadores, consulte Configuración de manejadores JAX-WS.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
- -jaxrpcHandlerListName
- Para obtener más información sobre las listas de manejadores, consulte Trabajo con manejadores JAX-RPC y clientes.
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -outboundSecurityRequestBindingName
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -outboundSecurityResponseBindingName
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -outboundSecurityConfigName
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -queryWSDL
- Distintivo booleano. Indica si el servicio WS-Notification versión 7.0 consulta al WSDL de otros servicios web de WS-Notification cuando interactúa con ellos. Los valores permitidos son TRUE (el valor predeterminado) y FALSE.
- Si establece este parámetro en FALSE, mejorará el rendimiento evitando caras consultas de WSDL. Sin embargo, debe tener en cuenta las siguientes consideraciones cuando no está habilitada la consulta de WSDL:
- WS-Notification trata de descubrir información de enlace (que normalmente se descubre a través del WSDL) por otros medios. WS-Notification utiliza la versión de SOAP asociada al punto de servicio WS-Notification donde se realizaron suscripciones (mediante otros servicios web), o donde se crearon las suscripciones administradas (mediante un administrador).
- En algunas circunstancias, es posible que WS-Notification no pueda determinar la información de enlace. Esto puede producirse cuando se limpian suscripciones en las que se ha suprimido el punto de servicio asociado y la información de configuración ya no está disponible. En esas circunstancias, WS-Notification elige la que considera la "mejor opción" en la información de enlace para utilizarla para limpiar las suscripciones.
- Hay un caso en el que se utiliza información de enlace incorrecta. Es decir, cuando un suscriptor realiza una suscripción para utilizar un enlace SOAP concreto, en nombre de un NotificationConsumer que espera notificaciones a través de un enlace SOAP distinto.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
Ejemplos
newService = AdminTask.createWSNService(["-bus", "bus1", "-name",
"NewWSNService", "-type", "V6.1"] )
newService = AdminTask.createWSNService(["-bus", "bus1", "-name",
"NewWSNService", "-type", "V7.0"] )
newService = AdminTask.createWSNService(["-bus", "bus1", "-name",
"NewWSNService", "-type", "V7.0", "-jaxwsHandlerListName", "myHandlerList"] )
newService = AdminTask.createWSNService(["-bus", "bus1", "-name",
"NewWSNService", "-type", "V7.0", "-queryWSDL", "false"] )
- Utilizando Jython:
propName = ["name", "com.ibm.ws.sib.wsn.strictTopicChecking"] propValue = ["value", "TRUE"] propAttrs = [propName, propValue] AdminConfig.create("Property", newService, propAttrs)
- Utilizando Jacl:
set propName [list name "com.ibm.ws.sib.wsn.strictTopicChecking"] set propValue [list value "TRUE"] set propAttrs [list $propName $propValue] $AdminConfig create Property $newService $propAttrs