Anotaciones SIP 1.1

A partir de SIP 1.1, puede utilizar anotaciones en las aplicaciones de servlet SIP. Puede utilizar anotaciones para incluir datos directamente en una aplicación en lugar de utilizar el descriptor de despliegue.

Anotaciones disponibles en SIP 1.1

En SIP 1.1 están disponibles las anotaciones siguientes:
  • @SipApplication
  • @SipServlet
  • @SipListener
  • @SipApplicationKey
Consejo: Todavía puede optar por utilizar los descriptores de despliegue en lugar de las anotaciones. Los descriptores de despliegue sustituyen los valores descritos en las anotaciones.

Anotación @SipApplication

La anotación @SipApplication define la información de configuración común sobre una aplicación. Se trata de una anotación de nivel de paquete y debe estar en un archivo denominado package-info.java. Todos los servlets dentro del paquete pertenecen a la misma aplicación.
Importante: Sólo se puede registrar una aplicación SIP con el contenedor de cada archivo .war o .sar, independientemente de si se utiliza un descriptor de despliegue o anotaciones.

Tabla 1. Propiedades de @SipApplication y correlación con los elementos del descriptor de despliegue correspondiente
Propiedad de la anotación Elemento de descriptor de despliegue Descripción Valor de anotación predeterminado
name <app-name> Nombre de la aplicación SIP Campo requerido
displayName <display-name> Nombre visualizado de la aplicación Nombre de la aplicación
description <description> Describe la aplicación Serie vacía
smallicon <small-icon> Vía de acceso a la ubicación del icono pequeño Serie vacía
largeicon <large-icon> Vía de acceso a la ubicación del icono grande Serie vacía
distributable <destributable> Indica si la aplicación puede funcionar en un entorno distribuido False (booleano)
proxyTimeout <proxy-timeout> Tiempo de espera predeterminado para todas las operaciones de proxy Tres minutos, en segundos
sessionTimeout <session-timeout> Tiempo de espera predeterminado para todas las operaciones de sesión de aplicación Tres minutos, en minutos
mainServlet <main-servlet> Indica el servlet SIP que se ha diseñado como servlet principal Serie vacía

Anotación @SipServlet

La anotación @SipServlet indica que una clase es un servlet SIP.

Tabla 2. Propiedades de @SipServlet y correlación con los elementos del descriptor de despliegue correspondiente
Propiedad de la anotación Elemento de descriptor de despliegue Descripción Valor de anotación predeterminado
@SipServletServlet <servlet-class> Indica que la clase es un servlet SIP La anotación se declara en la clase.
name <servlet-name> Nombre del servlet Nombre abreviado de la clase anotada.
applicationName <app-name> Nombre de la aplicación Opcional; también se puede definir en el descriptor de despliegue o mediante @SipApplication
loadOnStartup <load-on-startup> Define el orden de inicio de la aplicación de servlet Un número negativo (hace que el contenedor elija cuándo iniciar este servlet)

Anotación @SipListener

La anotación @SipListener proporciona una alternativa al elemento de descriptor de despliegue <listener>.

La anotación @SipListener no tiene campos obligatorios, sino que acepta un nombre y descripción opcionales de la aplicación. La clase que se anota mediante @SipListener debe implementar al menos una interfaz de escucha.

Anotación @SipApplicationKey

La anotación @SipApplicationKey marca el método que asocia una solicitud de entrada y SipSession con una sesión SipApplicationSession específica. Esta anotación se utiliza con destinos de sesiones basados en claves.

Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: SIP_dd_mappingtoservlet.html