Editar elementos Java

En esta sección se editan elementos Java en el entorno de trabajo.

Utilizar la vista Esquema

  1. Para abrir el archivo junit.samples.VectorTest.java en el editor Java, efectúe una doble pulsación sobre el archivo en la vista Explorador de paquetes.

  2. Observe el resaltado de sintaxis. Los ejemplos de componentes de código fuente Java que se visualizan de forma distinta incluyen:

    • Comentarios normales
    • Comentarios Javadoc
    • Palabras clave
    • Series
    Resaltado de sintaxis
  3. Observe la vista Esquema. Muestra un esquema del archivo Java que incluye la declaración de paquete, las declaraciones de importación, los campos, tipos y métodos. La vista esquema también indica si un elemento Java es estático, abstracto, final, etc. La vista Esquema también muestra si un método se ha alterado temporalmente a partir de una clase base (overridden) o si implementa un método desde una interfaz (implements).

    Vista Esquema
  4. Conmute los botones Ocultar campos, Ocultar miembros estáticos y Ocultar miembros no públicos de la barra de herramientas de la vista Esquema para filtrar la pantalla de la vista.

    Barra de herramientas de la vista Esquema
  5. Conmute el botón Ordenar de la vista Esquema para ordenar los elementos Java por orden alfabético en lugar de en el orden en el que aparecen en el archivo Java.

  6. Puede editar código fuente visualizando la totalidad del archivo Java o puede restringir la vista a un sólo elemento Java. Pulse el botón Mostrar sólo código fuente del elemento seleccionado de la barra de herramientas.

    A continuación, en la vista Esquema, seleccione cualquier elemento y observe que sólo el elemento seleccionado se muestra en el editor Java.

    Botón Mostrar sólo elemento seleccionado de la barra de herramientas
  7. Pulse de nuevo el botón Mostrar sólo código fuente del elemento seleccionado para ver de nuevo la totalidad del archivo Java.

    En la vista Esquema, seleccione varios elementos y observe que de nuevo se visualizan en una vista de archivo completo en el editor. La selección de la vista Esquema está ahora indicada con un indicador de rango en la regla vertical del borde izquierdo del editor java.

    Indicador de rango

Añadir métodos y utilizar la asistencia de código

  1. Asegúrese de que el botón Ordenar alfabéticamente de la barra de herramientas de la vista Esquema está desactivado.

  2. Empiece a añadir un método escribiendo lo siguiente al final del archivo VectorTest.java (pero antes de los corchetes de cierre del tipo) en el editor Java:

    public void testSizeIsThree() {

    En cuanto teclea el nombre del método en el área del editor, el método nuevo aparece en la parte inferior de la vista Esquema.

    Método nuevo en la vista Esquema
  3. Pulse el botón Guardar.

    La unidad de compilación se compila automáticamente y los errores aparecen en la vista Explorador de paquetes, en la vista Tareas y en la regla vertical. En la vista Explorador de paquetes, los errores se propagan en sentido ascendente hasta el proyecto de la unidad de compilación que contiene el error.

    Propagación de errores en el Explorador de paquetes
  4. Complete el método nuevo escribiendo lo siguiente:

        assertTrue(fFull.size() == 3);
    }
  5. Guarde el archivo.

    Observe que los indicadores de error desaparecen.

Suprimir y sustituir un método del historial local

En esta sección se utilizará la característica de historial local para conmutar a una versión guardada anteriormente de un elemento Java individual.

  1. Suprima el método que acaba de crear seleccionándolo en la vista Esquema y pulsando Suprimir en el menú de contexto.

  2. Añada una versión nueva del método escribiendo lo siguiente al final del archivo VectorTest.java en el editor Java:

    public void testSizeIsThree() {
        fFull.add(0, new Integer(0));
        fFull.remove(new Integer(3));
        assertTrue(fFull.size() == 3);
    }

    Guarde el archivo.

  3. En la vista Esquema, seleccione el método testSizeIsThree() y, en el menú de contexto, seleccione Sustituir por historial local.

  4. En el diálogo Sustituir elemento Java por historial local, la lista Historial local muestra los distintos estados guardados de ese elemento. El panel Comparar fuente Java muestra los detalles de las diferencias entre el recurso de historial seleccionado y el recurso existente en el entorno de trabajo.

    Sustituir por historial local
  5. En el panel Historial local, seleccione la versión que ha suprimido y pulse el botón Sustituir.

    En el editor Java, el método se sustituye por la versión de historial seleccionada.

  6. Guarde el archivo.

Utilizar la asistencia de contenido

  1. Abra el archivo junit.samples.VectorTest.java en el editor Java.

  2. Diríjase al método testSizeIsThree() seleccionándolo en la vista Esquema.

  3. Añada las siguientes líneas al final del método:

    Vector v = new Vector();
    for (int i=0; i<3; i++)
        v.addElement(new Object());
    assert
  4. Con el cursor en la parte final de la palabra assert, pulse Control+Espacio para activar la asistencia de código.

    Aparecerá la ventana de la asistencia de código con una lista de propuestas. Desplácese por la lista para ver las opciones disponibles.

    Asistencia de contenido
  5. Con la ventana de la asistencia de contenido todavía activa, teclee la letra "t" después de assert (sin espacios intercalados). La lista se reduce y sólo muestra las entradas que empiezan por 'assert'.

    Seleccione y después deje flotar el cursor sobre varios elementos de la lista para ver la ayuda Javadoc disponible para cada elemento.

    Asistencia de contenido filtrada
  6. Seleccione assertTrue(boolean) en la lista y pulse Intro.

    Se inserta el código para el método assertTrue(boolean).

  7. Complete la línea de la siguiente forma:

    assertTrue(v.size() == fFull.size());
  8. Guarde el archivo.

Utilizar plantillas

  1. Abra el archivo junit.samples.VectorTest.java en el editor Java.

  2. Empiece a añadir un método nuevo tecleando lo siguiente:

    public void testValues() {
        Integer[] expected= new Integer[3];
        for
  3. Con el cursor situado al final de for, pulse Control+Espacio para habilitar la asistencia de contenido.

    Asistencia de contenido para la línea for
  4. Elija la entrada for - iterate over array.

    La plantilla se inserta en el editor e i queda resaltado. El nombre de la matriz local se averigua automáticamente.

    Plantilla de for insertada
  5. Pulse Intro para confirmar la plantilla.

  6. Complete el bucle de for hasta:

    public void testValues() {
        Integer[] expected= new Integer[3];
        for (int i= 0; i < expected.length; i++) {
            expected[i]= i + 1;
        }
        
        Integer[] actual= to
  7. Con el cursor situado al final de to, pulse Control+Espacio para habilitar la asistencia de contenido. Elija toarray - convertir colección a matriz.

    Plantilla de for insertada

    La plantilla se inserta en el editor y type queda resaltado y seleccionado.

    Plantilla de for insertada
  8. Altere temporalmente la selección escribiendo Integer. El tipo del constructor de matriz cambia sincrónicamente.

  9. Escriba Tab para resaltar y seleccionar collection y altere temporalmente la selección escribiendo fFull.

    Plantilla de for insertada
  10. Pulse Intro para confirmar la plantilla.

  11. Añada las siguientes líneas de código para completar el método:

            assertEquals(expected.length, actual.length);
            for (int i= 0; i < actual.length; i++)
                assertEquals(expected[i], actual[i]);
        }
  12. Guarde el archivo.

Organizar importaciones

  1. Abra el archivo junit.samples.VectorTest.java en el editor Java.

  2. Suprima las declaraciones de importación seleccionándolas en la vista Esquema y pulsando Suprimir en el menú de contexto.

    Menú de contexto de la vista Esquema
  3. En el menú de contexto del editor, seleccione Organizar importaciones.

    Las sentencias de importación necesarias se añaden al principio del código, bajo la declaración de paquete.

    Organizar importaciones

    Como alternativa, puede llamarse directamente a Organizar importaciones desde el menú de contexto de las declaraciones de importación en la vista Esquema.

    Nota: puede especificar el orden de las declaraciones de importación en Preferencias (Ventana > Preferencias > Java > Organizar importaciones).

  4. Guarde el archivo.

Extraer un método

En esta sección se mejora el código del constructor de junit.framework.TestSuite. Para que el propósito del código sea más claro, extraerá el código que recoge casos de prueba de clases base en un método nuevo llamado collectTestMethods.

  1. En el archivo junit.framework.TestSuite.java, seleccione el rango de código siguiente:

    Class superClass= theClass;
    Vector names= new Vector();
    while (Test.class.isAssignableFrom(superClass)) {
        Method[] methods= superClass.getDeclaredMethods();
        for (int i= 0; i < methods.length; i++) {
            addTestMethod(methods[i], names, constructor);
        }
        superClass= superClass.getSuperclass();
    }

    Seleccione el rango de código mediante la función Expandir selección en:

    1. Desplácese al constructor TestSuite(Class).
    2. Coloque el cursor justo antes de while.
    3. Pulse Alt+Mayús+Flecha arriba.
    4. Pulse Alt+Mayús+Flecha izquierda dos veces.
  2. En el menú de contexto de la selección del editor, seleccione Propagación > Extraer método.

    Extraer método en el menú de contexto
  3. En el campo Nombre de método, teclee collectInheritedTests, a continuación pulse Siguiente.

    Página 1 del asistente Extraer método
  4. La página de vista previa de propagación visualiza los cambios que se realizarán.

    Pulsar Finalizar para extraer el método.

    Página 2 del asistente Extraer método
  5. Vaya al método extraído seleccionándolo en la vista Esquema.

    Método extraído

Utilizar Abrir declaración y Abrir en jerarquía de tipos

  1. Abra el archivo junit.samples.money.MoneyTest.java en el editor Java.

  2. En la primera línea de la declaración de clase MoneyTest, seleccione la especificación de superclase TestCase y,

    • seleccione Navegar > Abrir declaración en la barra de menús o
    • pulse F3.

    Nota: este mandato también funciona con métodos y campos.

    Menú Abrir declaración

    La superclase TestCase se abre en el área del editor y también está representada en la vista Esquema.

    Declaración abierta
  3. Pulse la pestaña del editor TestCase.java para convertirlo en el editor activo. Asegúrese de que la declaración de clase sigue estando seleccionada y:

    • en la barra de menús, seleccione Navegar > Abrir jerarquía de tipos, o
    • pulse F4.
    Menú Abrir jerarquía de tipos
  4. La vista Jerarquía se abre con la clase TestCase visualizada.

    Vista Jerarquía de tipos

    Nota: también puede abrir editores sobre los tipos y los métodos en la vista Jerarquía.

Conceptos relacionados

Vistas Java
Editor Java
Soporte de propagación
Plantillas

Tareas relacionadas

Utilizar el editor Java
Mostrar y ocultar elementos
Mostrar elementos simples o archivos Java completos
Ordenar elementos en vistas Java
Utilizar el historial local
Utilizar la asistencia de contenido
Utilizar plantillas
Gestionar sentencias de importación
Propagación
Propagación con vista previa
Utilizar la vista Jerarquía
Abrir una jerarquía de tipos en un elemento Java
Abrir una jerarquía de tipos en la selección de texto actual
Abrir un editor para un elemento seleccionado

Consulta relacionada

Vista Esquema Java
Asistencia de contenido Java
Preferencias de plantillas
Preferencias de Organizar importaciones
Preferencias del editor Java
Errores de extracción de métodos
Vista Jerarquía de tipos