< Anterior | Siguiente >

Lección 1.3: Crear un método Java

En la lección 1.3 se describe la creación de un método Java.

Antes de empezar, debe completar la Lección 1.2: configurar el proyecto Web y la interfaz e implementaciones Java. En esta lección realizará las siguientes tareas:
  1. Primero creará un método Java: Ahora vamos a crear un método Java que utilizará el importador COBOL para correlacionar los tipos de datos entre el fuente COBOL y los datos del método Java.
  2. Abra la vista Fragmentos de código pulsando Ventana > Mostrar vista > Fragmentos de código. En la vista Fragmentos de código, pulse J2C.
  3. Pulse con el botón derecho del ratón en Añadir método Java a bean Java J2C y seleccione Insertar.
  4. En la página Método Java pulse Añadir.
  5. En el campo de nombre Método Java, teclee getCustomerInfo para el nombre de la operación. Pulse Siguiente.
  6. A continuación creará la correlación de datos de parámetro de entrada: en este paso importará el archivo taderc25.cbl (COBOL) necesario para crear la aplicación. El archivo taderc25.cbl está ubicado en <dir_instal>\IBM\SDP70Shared\plugins\com.ibm.j2c.cheatsheet.content_7.0.0\Samples\CICS\taderc25, donde <dir_instal> es el directorio en el que se ha instalado este producto. El archivo COBOL contiene el programa que se ejecuta en el servidor CICS. Tiene la definición de la estructura que se pasa al servidor CICS a través del área de comunicaciones (COMMAREA). Esta estructura representa los registros de cliente que se devuelven de la aplicación CICS. Antes de poder trabajar con un archivo, debe importarlo del sistema de archivos al entorno de trabajo. En el campo Especificar el tipo de entrada/salida de la página Método Java, pulse Nuevo.
  7. En la página Importar datos, asegúrese de que el campo Elegir correlación es COBOL_TO_JAVA. Pulse Examinar junto al archivo COBOL
  8. Busque el archivo taderc25.cbl en el sistema de archivos y pulse Abrir.
  9. Pulse Siguiente.
  10. En la página Importador COBOL, seleccione una estructura de datos de comunicación:
    1. Seleccione Win32 para Nombre de plataforma.
    2. Seleccione ISO-8859-1 para Página de códigos.
    3. Pulse Consultar.
    4. Seleccione ICOMMAREA para Estructuras de datos.
  11. Pulse Siguiente.
  12. En la página Guardar propiedades:
    1. Seleccione Valor predeterminado para Estilo de generación.
    2. Pulse Examinar para elegir el proyecto Web Taderc25Sample.
    3. En el campo Nombre de paquete, teclee sample.cics.data
    4. En el campo Nombre de clase, el valor por omisión es ICOMMAREA; sustitúyalo por InputComm.
  13. Pulse Terminar.
  14. A continuación creará las distintas salidas posibles para el parámetro de salida: en el campo Especificar el tipo de entrada/salida de la página Método Java, pulse Nuevo junto al área Tipo de salida.
  15. En la página Importar datos, asegúrese de que el campo Elegir correlación es COBOL_MPO_TO_JAVA.
  16. Pulse Nuevo junto al área de las múltiples salidas posibles.
  17. Pulse Examinar junto al campo Nombre de archivo cobol y busque el archivo taderc25.cbl. Pulse Abrir.
  18. Pulse Siguiente.
  19. En la página Importador COBOL, seleccione una estructura de datos de comunicación:
    1. Seleccione Win32 para Nombre de plataforma.
    2. Seleccione ISO-8859-1 para Página de códigos.
    3. Pulse Consultar.
    4. Seleccione PREFCUST, REGCUST y BADCUST para Estructuras de datos.
  20. Pulse Terminar. En la página Especificar propiedades de configuración de importación de datos, figurarán los tres tipos de datos.
  21. Pulse Siguiente.
  22. A continuación especificará las propiedades de guardado: En la página Guardar propiedades verá valores por omisión para cada uno de los registros de tipo personalizado. Asegúrese de que Taderc25Sample aparece en el campo Nombre de proyecto. Pulse Examinar y elija el proyecto Web Taderc25Sample.
    1. En la página Especificar propiedades de guardado, resalte Propiedades de guardado de MPO COBOL a Java.
      • Teclee sample.cics.data en el campo Nombre de paquete
      • Teclee OutputComm en el campo Nombre de clase.
      • Puede seleccionar Sobrescribir clase existente .
    2. Expanda Propiedades de guardado de COBOL MPO a Java. Deben aparecer los tres elementos de enlace de datos.
    3. Resalte Propiedades de guardado de COBOL a Java para "PREFCUST" en el archivo taderc25.cbl
      • Para Estilo de generación, seleccione Predeterminado.
      • Teclee sample.cics.data en el campo Nombre de paquete
      • Teclee PrefCust en el campo Nombre de clase.
      • Puede seleccionar Sobrescribir clase existente .
    4. Resalte Propiedades de guardado de COBOL a para "REGCUST" en el archivo taderc25.cbl.
      • Teclee sample.cics.data en el campo Nombre de paquete
      • Teclee RegCust en el campo Nombre de clase.
      • Puede seleccionar Sobrescribir clase existente .
    5. Resalte Propiedades de guardado de COBOL a Java para "BADCUST" en el archivo taderc25.cbl.
      • Teclee sample.cics.data en el campo Nombre de paquete
      • Teclee BadCust en el campo Nombre de clase.
      • Puede seleccionar Sobrescribir clase existente .
  23. Pulse Terminar. Expanda OutputComm, y verá que contiene PrefCust, RegCust y BadCust en el campo Tipo de salida.
  24. En la página Método Java, pulse Finalizar.
  25. En la página Métodos Java:
    1. Teclee TADERC25 (el id de programa COBOL) en el campo functionName.
    2. Seleccione Mostrar valores avanzados.
    3. Seleccione SYNC_SEND_RECEIVE(1) en el campo interactionVerb.
    4. Teclee -1 en el campo replyLength.
  26. Pulse Terminar.
  27. Ahora añadirá el código de patrón de reconocimiento para generar el archivo de correlación de datos de salida Java: Dado que la salida que proviene del programa puede ser de cualquiera de los tipos de datos, el único modo de identificarla consiste en tener algunos patrones predefinidos en la corriente de datos. El método de identificación comprueba el patrón de reconocimiento.

    código add doclet para reconocimiento de patrón

    1. Para añadir el patrón de reconocimiento de PrefCust:
      • Abra el archivo PrefCust.java en un editor Java.
      • Navegue al método getPcustcode(). La mejor forma de hacer esto consiste en abrir la vista Esquema y desplazarse hasta encontrar el método deseado.
      • En el área de comentarios del método, añada el código @type-descriptor.recognition-desc pattern="PREC" o utilice la asistencia de contenido pulsando Ctrl-Espacio, recorra la lista hasta encontrar el código y especifique "PREC" como patrón.
      • Guarde los cambios y se regenerará el código de PrefCust.java.
      • Desplácese hasta el método de identificación para asegurarse de que el cambio se ha efectuado:
        /**
        	 * @generated
        	 
        	 */
        	public boolean match(Object obj) {
        		if (obj == null)
        			return (false);
        		if (obj.getClass().isArray()) {
        			byte[] currBytes = buffer_;
        			try {
        				byte[] objByteArray = (byte[]) obj;
        				buffer_ = objByteArray;
        				if (!("PREC".equals(getPcustcode().toString())))
        					return (false);
        			} catch (ClassCastException exc) {
        				return (false);
        			} finally {
        				buffer_ = currBytes;
        			}
        		} else
        			return (false);
        		return (true);
        	}

    2. Para añadir el patrón de reconocimiento de RegCust:
      • Abra el archivo RegCust.java en un editor Java.
      • Navegue al método getRcustcode(). De nuevo, la mejor forma de hacer esto consiste en abrir la vista Esquema y desplazarse hasta encontrar el método deseado.
      • En el área de comentarios del método, añada el código @type-descriptor.recognition-desc pattern="REGC" o utilice la asistencia de contenido pulsando Ctrl-Espacio, recorra la lista hasta encontrar el código y especifique "REGC" como patrón.
      • Guarde los cambios y se regenerará el código de RegCust.java.
      • Desplácese hasta el método de identificación para asegurarse de que el cambio se ha efectuado:
        /**
        	 * @generated
        	 
        	 */
        	public boolean match(Object obj) {
        		if (obj == null)
        			return (false);
        		if (obj.getClass().isArray()) {
        			byte[] currBytes = buffer_;
        			try {
        				byte[] objByteArray = (byte[]) obj;
        				buffer_ = objByteArray;
        				if (!("REGC".equals(getRcustcode().toString())))
        					return (false);
        			} catch (ClassCastException exc) {
        				return (false);
        			} finally {
        				buffer_ = currBytes;
        			}
        		} else
        			return (false);
        		return (true);
        	}
    3. Para añadir el patrón de reconocimiento de BadCust:
      • Abra el archivo BadCust.java en un editor Java.
      • Navegue al método getBcustcode(). De nuevo, la mejor forma de hacer esto consiste en abrir la vista Esquema y desplazarse hasta encontrar el método deseado.
      • En el área de comentarios del método, añada el código @type-descriptor.recognition-desc pattern="BADC" o utilice la asistencia de contenido pulsando Ctrl-Espacio, recorra la lista hasta encontrar el código y especifique "BADC" como patrón.
      • Guarde los cambios y se regenerará el código de BadCust.java.
      • Desplácese hasta el método de identificación para asegurarse de que el cambio se ha efectuado:
        /**
        	 * @generated
        	 
        	 */
        	public boolean match(Object obj) {
        		if (obj == null)
        			return (false);
        		if (obj.getClass().isArray()) {
        			byte[] currBytes = buffer_;
        			try {
        				byte[] objByteArray = (byte[]) obj;
        				buffer_ = objByteArray;
        				if (!("BADC".equals(getBcustcode().toString())))
        					return (false);
        			} catch (ClassCastException exc) {
        				return (false);
        			} finally {
        				buffer_ = currBytes;
        			}
        		} else
        			return (false);
        		return (true);
        	}