Creación de código Java personalizado

El código personalizado utiliza referencias de la prueba como entrada y devuelve valores modificados a la prueba. Utilice la interfaz ICustomCode2 para crear código personalizado y la interfaz ITestExecutionServices para ampliar la ejecución de la prueba. Estas interfaces se encuentran en el paquete com.ibm.rational.test.lt.kernel.services.

Acerca de esta tarea

Nota: Cuando utilice la interfaz ITestExecutionServices en el código personalizado para informar de los resultados de las pruebas, los resultados del código personalizado se muestran en el registro de prueba. Si registra veredictos de puntos de verificación personalizados, éstos se reflejarán en el veredicto de planificación global.

Los valores de entrada del código personalizado se pueden encontrar en referencias o referencias de campo. Asimismo, puede transferir una serie de texto como un argumento a un código personalizado. Las referencias que se utilizan como una entrada para código personalizado deben incluirse en la misma prueba como el código personalizado. En la prueba, la referencia debe preceder al código que afecta. Verifique que la prueba contiene las referencias necesarias para las entradas personalizadas del código. Para obtener detalles sobre cómo crear referencias y referencias de campo, consulte el apartado Creación de una referencia o una referencia de campo.

Si el código personalizado utiliza archivos JAR externos, probablemente deba cambiar la vía de acceso de compilación de Java™: consulte la página Vía de acceso de la compilación de Java. En algunos casos, puede evitar cambiar la vía de acceso de la compilación manualmente ejecutando la prueba antes de añadirle el código personalizado. La primera vez que ejecute una prueba, las clases y bibliotecas necesarias para la compilación se añadirán a la vía de acceso de la compilación. Por ejemplo, puede importar clases TPTP (Plataforma de herramientas de prueba y rendimiento) necesarias para crear sucesos personalizados en el registro de prueba si la prueba a la que ha añadido el código personalizado se ha ejecutado anteriormente. No obstante, si la prueba nunca se ha ejecutado, se producirán errores de importación porque las clases no tendrán nombre en la vía de acceso de la compilación del proyecto hasta que la prueba se haya ejecutado.

Si el código utiliza recursos externos, por ejemplo, una base de datos SQL o un producto que gestiona relaciones de clientes, debe configurar el código personalizado para que funcione en todos los sistemas en los que se ejecuten las pruebas.

El código personalizado se guarda en la carpeta src del proyecto que contiene la prueba que llama al código. De manera predeterminada, el código personalizado se sitúa en una paquete denominado test en la carpeta src.

En el siguiente ejemplo aparece la vista estándar del navegador de dos clases de código personalizado. (El Navegador de pruebas no muestra los archivos de origen de Java).

Vista del Navegador con las clases ReplaceCC.java y VerifyUserID.java

Si añade las clases de código personalizado ReplaceCC.java y VerifyYUserID.java a la prueba y devuelven un valor a la prueba, Sustituir de mostrará estas dos clases.

El paquete test también contiene el código Java generado para pruebas del proyecto.

Puede poner código personalizado en un paquete diferente (por ejemplo, custom). Separe el código personalizado del código generado, en especial si utiliza un sistema de control de origen. Para obtener información sobre control de origen y código personalizado, consulte el apartado Cómo colocar activos de prueba bajo control de origen.

Procedimiento

Para añadir código personalizado:

  1. Abra la prueba y seleccione un elemento de prueba.
  2. Pulse Añadir o Insertar y seleccione Código personalizado. Añadir añade el código personalizado a la parte inferior del elemento de prueba seleccionado. Insertar añade el código personalizado sobre el elemento de prueba seleccionado.
    Nota: Después de añadir o insertar código personalizado, la vista Problemas muestra un error que indica que el nuevo elemento de código personalizado no tienen archivo Java. Este mensaje de error permanece hasta que pulse Ver código o Generar código, para recordare que el elemento de prueba del código personalizado ya no está asociado a código Java.
  3. Inspeccione el campo Nombre de clase y realice uno de los siguientes pasos:
    • Si el código para llamar ya existe, cambie el nombre de clase para que coincida con su nombre. Pulse Ver código para abrir el código en el editor de Java.
    • Si el código no existe, cambie el nombre de clase para describir el propósito del código. Pulse Generar código para generar una clase de plantilla para registrar resultados y abrirla en el editor Java. Si existe una clase con este nombre, se le advertirá que se sobrescribirá.
  4. En el campo Argumentos, pulse Añadir.
  5. En la ventana Código personalizado, seleccione todas las entradas que necesita el código. La ventana Código personalizado muestra todos los valores de la prueba que pueden utilizarse como entradas para el código (referencias o referencias de campo de la prueba que preceden al código).
  6. Pulse Aceptar. La ventana se cierra, las referencias seleccionadas se añaden al campo Argumentos.
  7. Opcional: Para añadir series de texto al código personalizado, pulse Texto y, a continuación, escriba la serie de texto que vaya a utilizar.
  8. En la prueba, después del código personalizado, busque un valor que el código devuelva a la prueba.
  9. Resalte el valor.
  10. Pulse con el botón derecho del ratón sobre el valor resaltado, pulse Sustituir y seleccione el nombre de clase del código personalizado. Aparecen las clases de código personalizado que ha añadido. Después de haber realizado la selección, el valor que se devuelve a la prueba queda resaltado en naranja y la tabla Usado por se actualiza con esta información.

Qué hacer a continuación

El código personalizado no se muestra en la vista del Navegador de pruebas. Para ver código personalizado, abra la vista Explorador de paquetes y utilice las herramientas de Java para identificar el código personalizado que ha añadido.

Comentarios