forward

La sentencia forward de EGL se utiliza principalmente para visualizar una página Web con información de variable pero puede acceder a un URL o puede invocar un servlet o un programa Java que se ejecuta en el servidor de aplicaciones Web.

La sentencia actúa del siguiente modo:
  1. Compromete recursos recuperables, cierra archivos y libera bloqueos
  2. Reenvía en control
  3. Finaliza el código que ejecuta la sentencia forward

El diagrama de sintaxis es el siguiente:


Diagrama de sintaxis de la sentencia forward, sin un registro de UI
argumento
Un elemento o registro que se pasa al código que se invoca. Los nombres de un argumento y su parámetro correspondiente deben ser los mismos en todos los casos. No pueden pasarse literales.

Si se invoca un PageHandler, los argumentos deben ser compatibles con los parámetros especificados para la función onPageLoad del PageHandler. La función (si existe) puede tener cualquier nombre válido y está referenciado en la propiedad OnPageLoadFunction del PageHandler. Si se invoca un programa, los argumentos deben ser compatibles con los parámetros del programa.

Los siguientes detalles pueden ser de interés, en función de cómo utilice la tecnología:
  • El argumento debe tener el mismo nombre que el parámetro correspondiente, ya que se utiliza como clave para almacenar y recuperar el valor del argumento en el servidor de aplicaciones Web.
  • En lugar de pasar el argumento, el invocante puede hacer lo siguiente antes de invocar la sentencia forward:
    • Coloca un valor en el bloque de petición invocando la función de sistema J2EELib.setRequestAttr; o
    • Coloca un valor en el bloque de sesión invocando la función de sistema J2EELib.setSessionAttr.
    En este caso, el receptor no recibe el valor como argumento, sino invocando la función de sistema adecuada:
    • J2EELib.getRequestAttr (para acceder a los datos del bloque de petición); o
    • J2EELib.getSessionAttr (para acceder a los datos del bloque de sesión).
  • Un elemento de carácter se pasa como objeto de tipo Java String.
  • Un registro se pasa como bean Java.
to label IDdestino
Especifica una etiqueta Java Server Faces (JSF), que identifica una correlación en un archivo de configuración basado en JSF de tiempo de ejecución. La correlación, a su vez, identifica el objeto que debe invocarse, ya sea un JSP (generalmente asociado con un PageHandler EGL), un programa EGL, un programa no EGL o un servlet. La palabra label es opcional e IDdestino es una serie entrecomillada.
to URLIDdestino
Especifica un URL y (si es necesario) una serie de valores utilizada por el PageHandler, el programa VGWebTransaction o el servlet.

Tareas relacionadas
Reenviar control entre pageHandlers y transacciones Web

Consulta relacionada
Invocaciones de función
getRequestAttr()
getSessionAttr()
transferName

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.