Creando una biblioteca de clase java

1. Seleccione Archivo > Nuevo proyecto (Ctrl-Mayúscula-N). Debajo de Categorías, seleccione Java. Debajo de proyectos, seleccione Biblioteca de clases Java y haga clic en Siguiente.
2. Debajo de Nombre del proyecto, escriba MiBiblioteca. Cambie el valor de Ubicación del Proyecto a cualquier directorio de su computador. A partir de ahora, nos referiremos a este directorio como proyectos_NetBeans.

   Nota: La ruta especificada arriba debería aparecer en el campo Carpeta del Proyecto del asistente: /proyectos_NetBeans/MyLib/

3. Dejar el checkbox 'Usar carpeta para almacenar bibliotecas' sin seleccionar. (Esta opción no está disponible en la versión NetBeans IDE 6.0.)
4. Clic en Terminar. El proyecto MiBiblioteca se abre tanto en la ventana de proyectos como en la ventana de archivos.

Creando una aplicación Java

1. Seleccione Archivo > Nuevo proyecto. Debajo de Categorías, seleccione Java. Debajo de Proyectos, seleccione Aplicación Java y haga clic en Siguiente.
2. Debajo de Nombre del Proyecto, escriba MiAplicacion. Asegúrese que el campo Ubicación del Proyecto contenga proyectos_NetBeans.
3. Dejar el checkbox 'Usar carpeta para almacenar bibliotecas' sin seleccionar. (Esta opción no está disponible en la versión NetBeans IDE 6.0.)
4. Escriba acrostico.Main como clase principal.
5. Asegúrese que los checkbox 'Establecer como proyecto principal' y 'Crear clase principal' estén seleccionados.
6. Clic en Terminar. El proyecto MiAplicacion se mostrará en la ventana de proyectos y Main.java se abrirá en el editor de código fuente.

Configuración el classpath para la compilación

Para que MiAplicacion pueda depender de las clases de MiBiblioteca, tenemos que agregar MiBiblioteca al classpath de MiAplicacion. Al hacer esto tambie´n estamos asegurando que las clases del proyecto MiAplicacion puedan acceder a las clases del proyecto MiBiblioteca sin producir errores de compilación. En resumen, esto nos permitirá usar la completación de código en el proyecto MiAplicacion para llenarlo en el código basándose en el proyecto MiBiblioteca. En el IDE, el classpath está representado visualmente por el nodo Bibliotecas.

Agregar las clases utilitarias de la biblioteca al classpath del proyecto:

1. En la ventana de Proyectos, hagamos clic derecho en el nodo Bibliotecas del proyecto MiAplicacion y seleccionemos Agregar Proyecto.
2. Examinamos el valor del campo proyectos_NetBeans/ y seleccionamos la carpeta del proyecto MiBiblioteca. El panel 'Archivos JAR del proyecto' muestra los archivos JAR que han sido agregados al proyecto. Notemos que el archivo JAR para MiBiblioteca está listado aún cuando todavía no lo hemos construido. Este archivo JAR se creará cuando construyamos y ejecutemos el proyecto MiAplicacion.
3. Clic en Agregar Archivos JAR del Proyecto.
4. Expandamos el nodo Bibliotecas. El archivo JAR del proyecto MiBiblioteca ha sido agregada al classpath del proyecto MiAplicacion.

Creando un paquete y el archivo de clase

1. Clic derecho en el nodo del proyecto MiBiblioteca y seleccionar Nuevo > Clase Java. Escribir ClaseBiblioteca como el nombre de la nueva clase, escribir org.mi.mibiblioteca en el campo Paquete, y clic en Terminar. El archivo ClaseBiblioteca.java se abrirá el editor de c´digo fuente.
2. En ClaseBiblioteca.java, ubicar el cursor en la línea después de la declaración de la clase (public class ClaseBiblioteca {.
3. Escribir o pegar el siguiente código del método:

    public static String acrostico(String[] args) {
        StringBuffer b = new StringBuffer();
        for (int i = 0; i < args.length; i++) {
            if (args[i].length() > i) {
                b.append(args[i].charAt(i));
            } else {
                b.append('?');
            }
        }
        return b.toString();
    }

4. Si el código pegado no está formateado correctamente, presione Alt+Mayúscula+F para darle forma al archivo entero.
5. Presione Ctrl-G para guardar el archivo.

Editando un archivo Java

Ahora agregaremos algo de código a Main.java. Cuando lo hagamos, demostraremos la autoescritura de código en el editor de código fuente y las características de la plantilla de código.

1. Seleccionemos la ficha Main.java en el Editor del código fuente. Si no está abierto, expandamos en la ventana de proyectos MiAplication > Paquetes de código > acrostico y doble clic en Main.java.
2. Suprimir el comentario // TODO code application logic here que aparece en el método main.
3. En lugar del comentario, escribamos lo siguiente:

   String resultado = Cla

   Dejar el cursor después de Cla. En el siguiente paso veremos como usar el autocompletado de código para convertir Cla a ClaseBiblioteca.

4. Presionar Ctrl-espacio para abrir el cuadro de completación de código.

   Es una lista corta de posibles maneras para completar la palabra. Sin embargo, la clase que necesitamos, ClaseBiblioteca podría no aparecer.

5. Presionar Ctrl-espacio nuevamente para mosrar una lista larga de posibles coincidencias.

   ClaseBiblioteca debería estar en esta lista.

6. Seleccionemos ClaseBiblioteca y luego Intro. El IDE completará el resto del nombre de la clase y automáticamente creará una instrucción import para la clase.

   Nota:El IDE también abre un cuadro sobre el cuadro de autocompletado de código que muestra la información del Javadoc para la para clase o paquete seleccionado. Los paquetes que no tengan información del Javadoc, el cuadro mostrará un mensaje "No se puede encontrar el Javadoc" hasta que encontremos nuestra clase Java.

7. En el método main, escribir un punto despues de ClaseBiblioteca. El cuadro de autocompletado de c&ódigo se abrirá nuevamente.
8. Seleccionar el método acrostico(String[]args) y presionar Intro.El IDE completará el método acrostico y resaltará el parámetro args.
9. Presionemos Intro para aceptar args como el parámetro para el método.
10. Digitar el punto y coma ";".

    Al final, la línea debería quedar así:

    String resultado = ClaseBiblioteca.acrostico(args);

11. Presionemos Intro para iniciar una nueva línea. Luego escribamos sout y presionemos la tecla de tabulación (Tab). La abreviación sout se expande a System.out.println(""); con el cursor ubicado entre las comillas dobles. Escribamos Resultado = dentro de las comillas dobles y + resultado después de la segunda comilla doble. Al final, la línea debería lucir así:

    System.out.println("Resultado = " + resultado);

12. Presionemos Ctrl+G para guardar el archivo.

Estableciendo la clase principal y los argumentos de ejecución

La salida de nuestro programa está basado en los argumentos que le proporcionemos cuando se ejecute. Como argumentos, debemos colocar cinco palabras, de las cuales generarán el acróstico "Hola".

1. Hacemos clic derecho en el nodo del proyecto MiAplicacion del panel izquierdo, seleccionamos Propiedades, y seleccionamos el nodo Ejecutar. Notemos que la clase principal ya está definida que será acrostico.Main.
2. Escribimos Hoy conversaremos del Java en el campo "Argumentos" y hacemos clic en Aceptar.

Ejecutando el Proyecto Principal

1. Seleccionamos Ejecutar > Ejecutar  proyecto principal (F6) desde el menú Ejecutar.
2. Hacemos doble clic en la ventana de la salida para maximizarla y podamos ver los resultados. Notemos que Ant primero construye MiBiblioteca.jar y luego compila MiAplicacion usando MiBiblioteca.jar. Finalmente, imprime la salida del programa, Resultado = Hola (el acróstico de la frase que hemos pasado al programa como un argumento).
3. Seleccionamos la ventana Archivos y expandimos la carpeta del proyecto MiAplicacion. Los archivos de clase construidos están en la carpeta build.
4. Presionemos F6 para ejecutar el programa nuevamente. Sin necesidad de compilar, el programa se ejecuta.

Limpiando y construyendo el proyecto

Si construimos un proyecto y luego deseamos cambiar las clases, una buena manera es remover todos los artefactos construidos desde el sistema y crear una versión más actual de la aplicación. Podemos hacer esto con el comando Limpiar y construir.

1. Seleccionemos Construir > Limpiar y construir el proyecto (Mayúscula-F11). Tanto el proyecto MiBlioteca como MiAplicacion serán limpiados y reconstruidos como parte del proceso.
2. Hacemos clic derecho en el nodo del proyecto MiBiblioteca y seleccionamos Limpiar. Con esto solo el proyecto MiBiblioteca será limpiado.

Construyendo un proyecto individual

1. Hacemos clic derecho en el nodo del proyecto MiBlioteca de la ventana Proyectos.
2. Seleccionamos Construir desde el menú contextual.

Generando documentación con Javadoc

1. Seleccionamos el proyecto MiBiblioteca.
2. Seleccionamos Construir > Generar Javadoc para "MiBiblioteca" del menú principal del IDE.

   El IDE mostrará la salida del Javadoc en la ventana de Salida, y el navegador web se abrirá para mostrar el Javadoc generado.

Creando Pruebas con JUnit

1. Hacemos clic derecho en el nodo MiBiblioteca.java de la ventana Proyectos y seleccionamos Herramientas >Crear pruebas JUnit (Ctrl-Mayúscula-U).

   Si es la primera vez que crearemos pruebas con JUnit en el IDE, nos preguntará con una ventana de diálogo Seleccionar versión JUnit. Presionamos Intro para seleccionar JUnit 4.x y continuamos con la ventana de diálogo Crear pruebas.

2. En la ventana de diálogo Crear pruebas, hacemos clic en Aceptar para ejecutar el comando con las opciones por omisión. El IDE creará el paquete org.mi.mibiblioteca y el archivo ClaseBibliotecaTest.java en una carpeta separada llamada test. Puedes buscar el archivo expandiendo el nodo Paquetes de prueba y el subnodo org.mi.mibiblioteca.
3. En ClaseBibliotecaTest.java, suprimimos el cuerpo del método public void testAcrostico().
4. En el lugara donde suprimimos las líneas, escribimos o pegamos lo siguiente:

   System.err.println("Ejecutando testAcrostico...");
   String resultado = ClaseBiblioteca.acrostico(new String[]
                     {"astuto", "altura", "laguna", "mono"});
   assertEquals("Valor correcto", "algo", resultado);

5. Guardamos el archivo presionando Ctrl-G.

Ejecutando pruebas JUnit

1. Seleccionamos el nodo del proyecto MiBiblioteca y seleccionamos Ejecutar > Probar "MiBiblioteca" (Alt-F6). La ficha MiBiblioteca (prueba) se abrirá en la ventana de Salida. Los casos de prueba de JUnit se compilarán y ejecutarán. El resultado de la prueba de JUnit se mostrará en las fases de prueba.
2. También podemos ejecutar un archivo de prueba en lugar de ejecutar las pruebas de todo el proyecto. Seleccionamos la ficha ClaseBiblioteca.java en el Editor de código fuente y seleccionamos Ejecutar tab in the Source Editor and choose Run > Ejecutar archivo  > Probar "ClaseBiblioteca.java" del menú Ejecutar.

La documentación del API de JUnit está disponible en el IDE. Seleccione Ayuda > Referencias de Javadoc > API de JUnit.

Puedes aprender más acerca de JUnit en http://www.junit.org

Depurando el proyecto

1. En el archivo ClaseBiblioteca.java, vamos al método acrostico y ubicamos el cursor en cualquier parte de la línea b.append(args[i].charAt(i));. Luego presionamos Ctrl-F8 para poner un punto de ruptura.
2. Seleccionamos Ejecutar  > Depurar proyecto principal (Ctrl-F5). El IDE abrirá la ventana de Depuración y ejecutará el proyecto en el depurador hasta que llegue al punto de ruptura.
3. Seleccionamos la ventana de Variables locales y expandimos el nodo args. El arreglo de cadenas contendrá la frase que escribimos como argumentos de comando.
4. Hacemos clic en Paso a paso por instrucciones (F7) de la barra de herramientas para avanzar paso a paso através del programa y ver como el acróstico se está construyendo.

   Cuando el programa llegue al fin, la ventana de depuración se cerrará.