sessionBeanID

La opción sessionBeanID del descriptor de construcción identifica el nombre de un elemento de sesión existente en el descriptor de despliegue J2EE. Las entradas del entorno se colocan en el elemento de sesión cuando el usuario actúa de la forma siguiente:
La opción sessionBeanID resulta de utilidad en el siguiente caso:
  1. El usuario genera una envoltura Java, junto con un bean de sesión EJB. En el descriptor de despliegue de proyecto EJB (archivo ejb-jar.xml), EGL crea un elemento de sesión, sin entradas de entorno.

    Tanto el bean de sesión EJB como el elemento de sesión se denominan de la forma siguiente:

      NombreprogramaBeanEJB

    Nombreprograma es el nombre del programa de tiempo de ejecución que recibe datos por medio del bean de sesión EJB. La primera letra del nombre es mayúscula, y las demás minúsculas.

    En este ejemplo, el nombre del programa es ProgramA, y el nombre del elemento de sesión y del bean de sesión EJB es ProgramaEJBBean.

  2. Después de generar el bean de sesión EJB, el usuario genera el programa Java propiamente dicho. Dado que la opción genProperties del descriptor de construcción está establecida en YES, EGL genera entradas de entorno J2EE en el descriptor de despliegue, en el elemento de sesión establecido en el paso 1.
  3. El usuario genera ProgramB, que es un programa Java utilizado como clase de ayuda para ProgramA. Los valores de system y genProject son los mismos que los utilizados en el paso 2; asimismo, debe generar entradas de entorno y establecer sessionBeanID en el nombre del elemento de sesión.

    La utilización de sessionBeanID hace que EGL coloque las entradas de entorno correspondientes al segundo programa en el elemento de sesión creado en el paso 2; específicamente, en el elemento de sesión ProgramaEJBBean.

En el componente del descriptor de despliegue que figura a continuación, EGL ha creado las entradas de entorno vgj.nls.code y vgj.nls.number.decimal durante el paso 2, cuando se generó ProgramA; pero la entrada vgj.jdbc.default.database sólo la utiliza ProgramB y se creó durante el paso 3:

<ejb-jar id="ejb-jar_ID">
  <display-name>EJBTest</display-name>
  <enterprise-beans>
    <session id="ProgramaEJBBean">
      <ejb-name>ProgramaEJBBean</ejb-name>
      <home>test.ProgramaEJBHome</home>
      <remote>test.ProgramaEJB</remote>
      <ejb-class>test.ProgramaEJBBean</ejb-class>
      <session-type>Stateful</session-type>
      <transaction-type>Container</transaction-type
      <env-entry>
       <env-entry-name>vgj.nls.code</env-entry-name>
       <env-entry-type>java.lang.String</env-entry-type>
       <env-entry-value>ENU</env-entry-value>
      </env-entry>
      <env-entry>
       <env-entry-name>vgj.nls.number.decimal</env-entry-name>
       <env-entry-type>java.lang.String</env-entry-type>
       <env-entry-value>.</env-entry-value>
      </env-entry>
      <env-entry>
       <env-entry-name>vgj.jdbc.default.database</env-entry-name>
       <env-entry-type>java.lang.String</env-entry-type>
       <env-entry-value>jdbc/Sample</env-entry-value>
      </env-entry>
   </session>
  </enterprise-beans>
</ejb-jar>                  

Un elemento de sesión debe estar ya en el descriptor de despliegue para poder añadir entradas de entorno. Dado que los elementos de sesión se crean durante la generación de la envoltura Java, es aconsejable generar la envoltura Java antes de generar los programas relacionados.

En los casos siguientes, se genera un programa en un proyecto EJB, pero las entradas de entorno se colocan en un archivo de entorno J2EE en lugar de en el descriptor de despliegue:

En los proyectos EJB, un nombre de entrada de entorno (como por ejemplo vgj.nls.code) sólo puede aparecer una vez para cada elemento de sesión. Si ya existe una entrada de entorno, EGL actualiza el tipo y el valor de la entrada en lugar de crear una nueva.

EGL nunca suprime una entrada de entorno de un descriptor de despliegue.

No hay ningún valor por omisión disponible para sessionBeanID.

Consulta relacionada
Opciones del descriptor de construcción

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.