Interfaz TaskNameManager

TaskNameManager es la interfaz de programa para la función de perfilado de aplicaciones. Dado que en raras ocasiones puede que sea necesario establecer mediante programación el nombre de tarea actual, la interfaz TaskNameManager permite alterar temporalmente la tarea actual asociada con la hebra de ejecución y restablecer la tarea actual con la tarea original.

El perfilado de aplicaciones le permite identificar unidades de trabajo determinadas en el entorno de ejecución de WebSphere Application Server. Durante el tiempo de ejecución se puede adaptar el soporte a los requisitos exactos de dicha unidad de trabajo. El Intento de acceso es actualmente el único componente de tiempo de ejecución que utiliza la funcionalidad de perfilado de aplicaciones. Por ejemplo, puede configurar una transacción de modo que cargue un bean de entidad que esté fuertemente bloqueado para actualizaciones y configurar otra transacción para que cargue el mismo bean de entidad sin bloqueos.

El perfilado de aplicaciones presenta dos conceptos para poder realizar esta función: tareas y perfiles.

Una tarea es un nombre configurable de una unidad de trabajo. En este caso unidad de trabajo significa una transacción o una sesión de actividad.

Un perfile es simplemente una correlación de una tarea con un conjunto de políticas de intento de acceso configuradas en beans de entidad. Cuando al invocar un bean (ya sea de un método finder, un getter de CMR (Container Managed Relationship) o una consulta dinámica) sea necesario recuperar datos desde el sistema de fondo, se utiliza la tarea de la unidad de trabajo activa asociada con la solicitud para determinar los requisitos exactos de la transacción. Se carga el mismo bean y éste se comporta de forma diferente en el contexto de la correlación de tarea a perfil. Cada perfil proporciona al desarrollador la oportunidad de volver a configurar el intento de acceso de la aplicación.

Excepto para aplicaciones J2EE 1.3 que se ejecutan en un servidor donde se ha seleccionado el atributo Modalidad de compatibilidad 5.x, esta interfaz no puede utilizarse dentro de Enterprise JavaBeans que se configuran para transacciones gestionadas por contenedor o sesiones de actividad gestionadas por contenedor porque las unidades de trabajo sólo pueden asociarse con una tarea en el mismo momento en que se inicia la unidad de trabajo. La llamada para establecer el nombre de la tarea debe por lo tanto iniciarse antes de que se inicie la unidad de trabajo. Las unidades de trabajo no pueden nombrarse después de haberse iniciado. Las llamadas en esta interfaz durante la ejecución de una unidad de trabajo gestionada por contenedor se ignoran.

La interfaz TaskNameManager está disponible para todos los componentes J2EE que utilizan la búsqueda JNDI (Java Naming and Directory Interface) siguiente:

java:comp/websphere/AppProfile/TaskNameManager
package com.ibm.websphere.appprofile; 

/** 
* TaskNameManager es la interfaz de programa para la 
* función de perfilado de aplicaciones. Utilizando esta interfaz, 
* los programadores pueden establecer el nombre de la tarea actual 
* en la hebra de ejecución. El nombre de la tarea se debe haber 
* configurado en los descriptores de despliegue como una referencia 
* a tarea asociada con una tarea. El ámbito del nombre del 
* conjunto de tareas es la duración de la invocación del 
* método en los componentes EJB y Web y la duración 
* del proceso de cliente, o hasta que se invoque el 
* método resetTaskName(). 
*/ 
public interface TaskNameManager { 

/** 
* Establecer el nombre de tarea actual de la hebra en el parámetro 
* especificado. El nombre de la tarea debe estar configurado como 
* una referencia a tarea con una tarea correspondiente o se generará 
* la excepción IllegalTaskName. 
*/ 
public void setTaskName(String taskName) throws IllegalTaskNameException; 

/** 
* Establece el nombre de la tarea en el valor en que se ha
* establecido, o al que se ha importado, al principio de la 
* invocación del método (para componentes EJB y web) o proceso
* (para clientes J2EE). 
*/ 
public void resetTaskName(); 

} 

Icon that indicates the type of topic Reference topic



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