Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.

htm

MANUAL DE INICIACION A NETBEANS 5.5

Este documento presenta los elementos básicos para la utilización del entorno de
desarrollo integrado (IDE) NetBeans 5.5.

Nocion de proyecto NetBeans

Creacion de una aplicacion Java con NetBeans

Utilizacion del editor

Compilar y ejecutar un proyecto

Interrumpir la ejecucion de un programa

Generar la documentacion Javadoc de un proyecto

Creacion de un archivo .jar

La documentacion en linea de NetBeans

Generar getter y setter metodos

Nocion de proyecto NetBeans

Con la versión 5.5 de NetBeans (http://www.netbeans.org) siempre se trabaja a dentro de un proyecto. Un proyecto es un
conjunto de archivos fuente JAVA y de informaciones asociadas (classpath, como construir y ejecutar el proyecto, etc.). El IDE
NetBeans 5.5 almacena la información asociada a un proyecto en una carpeta proyecto (project folder) incluyendo un script
build Ant (archivo build.xml equivalente de un Makefile) que controla la compilación y la ejecución, y un archivo
project.xml que asocia las targets Ant a las comandas del IDE. Ant es un proyecto open source de la fundación Apache
(http://ant.apache.org/)

Con NetBeans se puede

crear proyectos estándares que se apoyan sobre scripts Ant generados por NetBeans y sobre una organización
estándar de archivos de proyecto.
crear sus proyectos con sus propios scripts y su propia organización de archivos.

En esta introducción a NetBeans nos interesaremos únicamente a los proyectos estándares, y particularmente a los proyectos
de tipo Application Java

Creacion de una aplicacion Java con NetBeans

Para crear un nuevo proyecto de aplicación JAVA seleccionar File > New Project (Maj-Ctrl-N). Un
pop-up de dialogo para la creación de nuevos proyectos aparece.

1 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

En Categories, seleccionar General. En Projects, seleccionar Java Application y hacer clic sobre Next.

Un pop-up de dialogo para la creación de una nueva aplicación aparece.

En Project Name, ingresar HolaMundo. Con Project Location escoger un lugar para los archivos de su proyecto.
Seleccionar la casilla Set as Main Project así que la casilla Create Main Class. Ingresar Holamundo como clase principal.
Hacer clic sobre Finish.

NetBeans crea una carpeta HolaMundo en la carpeta que han escogido para su proyecto (en el ejemplo arriba
E:\Formacion\Workspace). El proyecto HolaMundo se abre y la clase HolaMundo.java se visualiza en el Editor.

2 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

La parte Projects permite de visualizar la estructura lógica del proyecto (los diferentes packages
Java que le constituyen), la parte Files permite de visualizar su estructura de archivos.

Vista lógica de un proyecto Vista "física" de un proyecto

estructura de un proyecto netbeans

La estructura de un proyecto Java es casi igual segun el tipo de proyecto. Las carpetas más importantes son :

src (Sources Packages) : contiene los archivos fuentes (.java) organizados según el árbol jerárquico de los paquetes
Java
build > classes : carpeta temporal conteniendo los archivos compilados (.class)
dist : carpeta generada automáticamente, conteniendo archivos listos para distribuirse a sus clientes (.jar, .war)
dist > javadoc : carpeta temporal conteniendo los archivos HTML describiendo el codigo

3 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

web (WEB pages) : contiene las paginas WEB HTML, JSP, archivos CSS...
lib o web > WEB-INF > lib : las librerias

Utilizacion del editor

Modificar el programa HolaMundo completando el método main con la instrucción System.out.println("Hola amigos!");

Cuando es posible, el editor propone una compleción automática del código. Por ejemplo, parar el ingreso después
System.out. , el editor propone todos los métodos posibles con la documentación javadoc asociada.

El editor ofrece la compleción de código para todas las clases y métodos en el classpath de compilación del proyecto. En
cualquier momento, se puede activar la compleción con Ctrl-Space.

El editor no espera siempre el lanzamiento de una compilación para indicar los errores eventuales. Durante que ingresan el
código, la sintaxis java esta verificada y en caso de error una pequeña cruz roja al frente de línea correspóndanle.
Posicionando el cursor del mouse sobre esta cruz, tendrán un mensaje de explicación indicando la natura del error. Para
apreciar este funcionalidad no poner ';' al fin del instrucción System.out.println.

Rectificar el error de sintaxis y guardar el archivo Holamundo.java (File->Save ou Ctrl-S).

Para saber si un archivo que se visualiza en el editor esta guardado o no, una estrella aparece al lado de su nombre:

Archivo no grabado Archivo grabado

Compilar y ejecutar un proyecto

Una vez el archivo grabado, se puede lanzar la compilación y la ejecución de su proyecto por Menu Run->RunMainProject (F6)
o haciendo clic en el botón de la barra de herramientas. Eso tiene por consecuencia de ejecutar las diferentes comandes del
script Ant build.xml para compilar luego ejecutar su aplicación. Las salidas de estas comandas Ant luego de su aplicación se
visualizan en la ventana Output debajo de la ventana de NetBeans.

4 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Ahora vamos a completar el programa HolaMundo para que pueda, leer una serie de nombres en la
línea de comandoss y para cada nombre leído indicar una cadena HOLA ...

public static void main(String[] args) {

System.out.println("HOLA");
for (int i = 0; i < args.length; i++)
System.out.println("HOLA" + args[i]);
}
}

Para ejecutar este programa desdeNetBeans al comunicarle una serie de argumentos se debe
configurar las propiedades de su proyecto. Se accede al panel de configuración efectuando un clic
derecho sobre el proyecto y eligiendo el item Properties en la menu del contexto como lo
muestra la imagen siguiente.

5 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Una ventana de edicion de propriedades del proyecto HolaMundo aparece.

Seleccione las propiedades Run (configuraciones para la ejecución del proyecto) en Run y en la parte derecha de la ventana
introducen una serie de nombres en el campo de ingreso Arguments. Valide por OK, luego reactivan la ejecución del proyecto
(Run -> Run Main Project o F6).

En la ventana de salida deben obtener la visualizacion siguiente:

6 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Atención: si en el ingreso de un valor, preceden ésta de un mensaje de invita que no efectúa vuelta a la línea
(System.out.print en vez de System.out.println), no se indica este último en la ventana Output cuando el programa se
para en espera del ingreso. No lo será hasta que se haya efectuado el ingreso de datos. (Pueden experimentar eso
sustituyendo a System.out.println(“ingresan su nombre”) por System.out.println(“ingresan su nombre”) en su
programa HolaMundo).

Para remediar estos inconvenientes, es siempre posible ejecutar directamente la aplicación lanzándola desde una ventana de
comandos (ventana xterm bajo UNIX o cmd bajo Windows) de su sistema. Las clases Java de su aplicación se compilaron en el
directorio build/clases situado bajo la raíz de su proyecto. Abra una ventana de comandos, coloca en este directorio y realizar
el programa HolaMundo con el comando java.

Interrumpir la ejecucion de un programa

Modificar el programa HolaMundo con el código siguiente:

public static void main(String[] args) {

Boolean cerro = false;
while (!cerro) {
System.out.println("Hola amigos");
}
}

Compilar y ejecutar la aplicación HolaMundoCerro (Run -> Run Main Project o F6).

La aplicación HolaMundoCerro esta constituida de un cerro infinito que visualiza “Hola amigos”.

Cuando el programa se lanza desde una consola, este programa puede ser parado con CTRL-C.

Para interrumpir la ejecución de un programa desde NetBeans, se debe proceder de la manera siguiente:

Abrir la ventana Runtime.

Despliegue el nudo Processes que muestra los procesos en ejecución.

Hacer clic derecho luego Terminate Process en el nudo correspóndanle al aplicación HolaMundo.

7 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Interrumpir la ejecución del proyecto HolaMundo como indicado arriba.

Generar la documentacion Javadoc de un proyecto

Para generar la documentación javadoc de un proyecto a partir de las fuentes, hay que activar la
comanda Generate Javadoc en el menú Build.

8 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Normalmente, una vez que la documentación esta generada, NetBeans abre una ventana del
navegador por defecto visualizando esta documentación.
Los archivos generados se encuentran en la carpeta dist/javadoc que se ubica a la raíz del proyecto.

Para que sus proprios comentarios se insertan en las paginas HTML generadas, es importante de
respetar el formato siguiente :

/** Allí tenemos un comentario javadoc. Como se puede ver

* la linea empieza con los caracteres /**.
* Puede extenderse en varias lineas
*/

9 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

creacion de un archivo .jar

Click derecho sobre el proyecto y "Build project".

La documentacion en linea de NetBeans

Hemos visto en lo que precede el estricto minimum para la utilización de NetBeans 5.5 en la
escritura de aplicación Java. Para utilizar a lo mejor las numerosas funcionalidades de este
entorno, es aconsejado de leer la documentación en línea.
Para obtener este ayuda, menú Help-->Help Contents. La ventana de ayuda tiene la organización siguiente:

3 partes permiten de utilizar la ayuda de 3 maneras distintas:

por capítulos,
a partir de un indexo,
efectuando una búsqueda.

Consultar este ayuda en línea de NetBeans, será probablemente muy útil durante utilizaciones ulteriores del IDE.

El capitulo Getting Started permite de tener una visión global del software.

GENERACION DE GETTER y SETTER METODOS

Se puede generar los métodos getter y setter para un campo en una de las dos maneras
siguientes:

10 de 11 23/05/2007 11:02
Manual iniciacion NetBeans 5.5 file:///E:/manualUtilizacionNetBeans5.5.htm

Usando el code completion box. Esta manera es más fácil si usted apenas ha creado el
campo en su código y desea agregar los métodos del comprador y del setter.
Usando the Encapsulate Field refactoring comando. Esta manera es generalmente preferible
si usted también desea cambiar el modificador del campo y cambiar otro código para utilizar
el getter y setter para acceder al campo.

GENERAR GETTER Y SETTER MÉTODOS USANDO EL CODE COMPLETION BOX:

1. Ingresar la declaracion del campo en el Source Editor y presionar Enter.

2. Presionar Ctrl-Spacebar.
3. En el code completion box, bajar a la entrada Create getter getFieldName for field
FieldName y presionar Enter.
4. Presionar Ctrl-Spacebar.
5. El el code completion box, bajar a la entrada Create setter setFieldName for field FieldName
y presionar Enter.

GENERAR GETTER Y SETTER MÉTODOS USANDO EL ENCAPSULATE FIELDS COMANDO:

Clic derecho un nonstatic campo en la ventana Projects o Source Editor y escoger Refactor
> Encapsulate Fields.
En el Encapsulate Fields dialog box, fije la visibilidad para el campo y los accessores y clic
Next
En la ventana Output, clic Do Refactoring.

11 de 11 23/05/2007 11:02