sib: sintaxis de URL
El URL de sib: tiene la sintaxis siguiente:
sib:/[destination|path]?propiedad_1=valor_1&propiedad_2=valor_2&...
donde:- Los corchetes ("[ ]") indican que un parámetro es opcional.
- El tipo de transporte es sib:, seguido de /destination para especificar el tipo de destino o /path para especificar una ruta de direccionamiento de reenvío, seguido de una "serie de consulta" que contiene una o más propiedades. Las propiedades permitidas se describen en las secciones siguientes de este tema.
Propiedades obligatorias
Las propiedades siguientes son necesarias. Se utilizan para especificar el destino de la solicitud.
Nota: Todos los nombres de destino deben estar totalmente calificados.
Es
decir, deben incluir el nombre del bus de integración de servicios y también el
nombre del destino. Utilice la sintaxis bus:destino.
Si un nombre de bus o de destino contiene dos puntos o una coma, encierre el nombre entre comillas dobles (""). Si contiene comillas, repita las comillas.
- destinationName
- El nombre del destino.
- vía de acceso
- La ruta de direccionamiento de reenvío, con el formato de una secuencia de nombres de destino separados por comas.
- replyDestinationName
- El nombre del destino que se va a utilizar para la respuesta.
- inboundService
- El nombre del servicio de entrada que identifica la asociación específica que utiliza la aplicación solicitante. Puede omitir este valor si el destino es un destino de servicio con una configuración de servicio de salida asociada, debido a que en este caso el solicitante se está asociando al servicio de salida a través del destino de servicio.
- timeout
- El período de tiempo que el solicitante espera una respuesta. El valor predeterminado es de 60 segundos. Un valor de cero indica un tiempo ilimitado.
Propiedades relacionadas con las tecnologías de la integración de servicios
Las siguientes propiedades son opcionales. Si no especifica un valor para una propiedad, entonces se utiliza el valor predeterminado. Para obtener más información relacionada con los valores permitidos para estas propiedades, consulte la información de la API generada para la interfaz SIMessage.
- reliability
- La fiabilidad del mensaje de solicitud.
- timeToLive
- El período de tiempo (en milisegundos) antes de que se produzca un tiempo de espera excedido para la solicitud. Un valor de cero indica que la solicitud nunca tendrá un tiempo de espera excedido.Nota: La propiedad timeout (consulte las propiedades necesarias) es el período de demora tras el cual la aplicación solicitante bloqueará la hebra de la aplicación que espera una respuesta a una operación de solicitud y respuesta. Las propiedades opcionales Tiempo de duración y replyTimeToLive indican durante cuánto tiempo los motores de mensajería deben procesar los mensajes de solicitud y respuesta. Esto no incluye el tiempo de proceso durante la implementación del servicio. Por lo tanto, se suele establecer el período de tiempo de espera en la suma de los tiempos de duración de solicitud y respuesta más una cantidad para el tiempo de proceso del servidor.
- priority
- La prioridad del mensaje de solicitud.
- user
- El ID de usuario necesario para acceder al destino de la solicitud.
- password
- La contraseña necesaria para acceder al destino de la solicitud.
- replyReliability
- La fiabilidad del mensaje de respuesta.
- replyTimeToLive
- El período de tiempo (en milisegundos) antes de que se produzca un tiempo de espera excedido para la respuesta. Un valor de cero indica que la respuesta nunca tendrá un tiempo de espera excedido.
- replyPriority
- La prioridad del mensaje de respuesta.
Otras propiedades
También puede incluir las propiedades definidas por el usuario en el URL. El nombre de estas propiedades debe tener el prefijo user.. Por
ejemplo:
sib:/destination?destinationName=myBus:myDestination & reliability=assured & user.customData=XYZ
Una vez enviada la solicitud, el propio URL está disponible en las propiedades del mensaje, denominadas inbound.url.