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

1 de 11 23/05/2007 11:02

MANUAL DE INICIACION A NETBEANS 5.5

Este documento presenta los elementos básicos para la utilización del entorno dedesarrollo 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 unconjunto de archivos fuente JAVA y de informaciones asociadas (classpath, como construir y ejecutar el proyecto, etc.). El IDENetBeans 5.5 almacena la información asociada a un proyecto en una carpeta proyecto (project folder) incluyendo un scriptbuild Ant (archivo build.xml equivalente de un Makefile) que controla la compilación y la ejecución, y un archivoproject.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ónestá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 proyectosde 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.

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

2 de 11 23/05/2007 11:02

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.

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

3 de 11 23/05/2007 11:02

La parte Projects permite de visualizar la estructura lógica del proyecto (los diferentes packagesJava 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 paquetesJavabuild > 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

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

4 de 11 23/05/2007 11:02

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ésSystem.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. Encualquier 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 elcó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. Paraapreciar 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 delscript Ant build.xml para compilar luego ejecutar su aplicación. Las salidas de estas comandas Ant luego de su aplicación sevisualizan en la ventana Output debajo de la ventana de NetBeans.

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

5 de 11 23/05/2007 11:02

Ahora vamos a completar el programa HolaMundo para que pueda, leer una serie de nombres en lalí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 clicderecho sobre el proyecto y eligiendo el item Properties en la menu del contexto como lo muestra la imagen siguiente.

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

6 de 11 23/05/2007 11:02

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 ventanaintroducen 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:

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

7 de 11 23/05/2007 11:02

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 separa en espera del ingreso. No lo será hasta que se haya efectuado el ingreso de datos. (Pueden experimentar esosustituyendo 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 decomandos (ventana xterm bajo UNIX o cmd bajo Windows) de su sistema. Las clases Java de su aplicación se compilaron en eldirectorio build/clases situado bajo la raíz de su proyecto. Abra una ventana de comandos, coloca en este directorio y realizarel 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.

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

8 de 11 23/05/2007 11:02

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 lacomanda Generate Javadoc en el menú Build.

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

9 de 11 23/05/2007 11:02

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*/

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

10 de 11 23/05/2007 11:02

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 esteentorno, 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 manerassiguientes:

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

11 de 11 23/05/2007 11:02

Usando el code completion box. Esta manera es más fácil si usted apenas ha creado elcampo 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 preferiblesi usted también desea cambiar el modificador del campo y cambiar otro código para utilizarel getter y setter para acceder al campo.

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

Ingresar la declaracion del campo en el Source Editor y presionar Enter. 1.Presionar Ctrl-Spacebar.2.En el code completion box, bajar a la entrada Create getter getFieldName for field FieldName y presionar Enter.

3.

Presionar Ctrl-Spacebar. 4.El el code completion box, bajar a la entrada Create setter setFieldName for field FieldNamey presionar Enter.

5.

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.