JCreator 3.5: Configuración y uso básico 22 de Febrero de 2005

En la asignatura Laboratorio de Tecnología de Objetos (LTO) vamos a utilizar el entorno JCreator LE/PRO 3.5 para la edición y compilación de programas Java. Este entorno puede utilizar cualquier versión del JDK que tengamos instalada y que seleccionemos adecuadamente.

En el presente documento suponemos que el JDK y su documentación ya están instalados y que falta sólo la personalización. El JDK tiene su aplicación de instalación y la documentación viene como un fichero comprimido que se descomprime en el lugar que se quiera (ver la información de instalación, normalmente se pone en un directorio docs en el mismo sitio donde está el JDK).

Si el JDK y su documentación no están instalados te recomendamos que lo instales antes de instalar JCreator, de forma que este detecte las instalaciones que tengas del JDK y te resulte más fácil. También podemos instalar JCreator primero, aunque en este caso es preciso indicar el sitio en el que se encuentra el JDK para poder utilizarlo. Esta funcionalidad será útil para actualizar la versión del JDK sin necesidad de reinstalar JCreator.

1. Configuración de JCreator 3.5 La primera vez que lo ejecutamos pregunta por las extensiones de fichero que utilizará por defecto y los directorios donde se encuentran el JDK y su documentación. La primera pantalla muestra las extensiones que pretende asociar con JCreator.

Dejemos las que propone pulsando en el botón "Next". A continuación busca instalaciones del JDK y solicita confirmación para elegir una de las encontradas. Si estamos de acuerdo y pulsamos "Next" de nuevo pasamos a una pantalla donde nos solicita que indiquemos el directorio de la documentación del JDK. En un sistema con el JDK instalado en C: \Archivos de programa\Java\jdk1.5.0_01 y su documentación en C: \Archivos de programa\Java\jdk1.5.0_01\docs mostrará la siguiente ventana:

Pulsando "Finish" terminaremos la configuración inicial.

Directorio de trabajo por defecto Al ejecutar el entorno lo primero que tenemos que hacer es configurar nuestro directorio de trabajo. En el menú Configure seleccionamos la entrada Options y a continuación, en el árbol de la izquierda, seleccionamos Directories, (a partir de ahora utilizaremos expresiones de la forma Configure -> Options -> Directories para referirnos a secuencias de elecciones de este tipo) apareciendo el siguiente diálogo:

Cambiamos la entrada titulada “Default Project Directory” a por ejemplo “c:\Java\” y salimos con OK. El resto de las entradas no hace falta modificarlas.

2. Trabajo con JCreator 2.1 Creación de un proyecto En JCreator existen los conceptos de Espacio de Trabajo y de Proyecto. Aunque un espacio de trabajo puede contener múltiples proyectos, nosotros crearemos uno nuevo para cada proyecto. Esto simplifica bastante el trabajo con JCreator.

Los proyectos pueden crearse utilizando distintas plantillas, aunque nosotros los crearemos, al menos al principio, como proyectos vacíos (Empty Projects), en File -> New -> Project (o a través de Project -> New Project, o con la combinación de teclas Ctrl+Mayúsculas+N).

Una vez elegido el tipo de proyecto que queremos crear le damos un nombre y eleginos el lugar en el que queremos que se coloque.

Al crear un nuevo proyecto tenemos que decidir si queremos incluirlo en un espacio de trabajo existente o si por el contrario queremos crear un espacio de trabajo nuevo. Nosotros recomendamos crear un nuevo espacio de trabajo para cada proyecto. Así, con la creación de un proyecto creamos un espacio de trabajo marcando la opción “Create new workspace”. Al dar un nombre de proyecto (y espacio de trabajo) se crea un subdirectorio bajo el directorio de trabajo por defecto y allí se colocarán los ficheros pertenecientes a este proyecto. Alternativamente se podría añadir el nuevo proyecto a un espacio de trabajo existente

2.2 Creación y edición de ficheros Una vez creado el proyecto podemos proceder a la creación y edición de los ficheros que van a formar parte del mismo. Un fichero que vaya a contener clases Java ha de crearse como un Java File. La creación se hace en File -> New -> File (o a través del icono New, o con Ctrl+N).

Por defecto los ficheros se crearán con extensión ".java" (Java File) y se añadirán al proyecto activo. Si deseamos crear un fichero de otro tipo podemos pulsar el botón "Back" y seleccionar el deseado, o directamente indicar la extensión del fichero. Si no queremos que se incluya en el proyecto podemos indicar una localización distinta.

También podemos añadir clases directamente a nuestro proyecto. Obsérvese que Java sigue la convención de mantener una clase por fichero. Es posible crear nuevas clases con File -> New -> Class o con Project -> New Class. De esta forma se ejecuta un asistente que nos facilita la creación de clases. No obstante, inicialmente recomendamos que este asistente no sea utilizado.

2.3 Compilación de un proyecto Puede utilizarse Build -> Compile Project para compilar todo el proyecto o Build -> Compile File para compilar un solo fichero. Hay sendos iconos en la barra de herramientas para esto, y para compilar un proyecto puede pulsarse F7 directamente.

Véase la sección 2.6 para cambiar las opciones de compilación.

2.4 Ejecución de una aplicación Una aplicación puede ser ejecutada con Build -> Execute Project, pulsando el icono Execute Project de la barra de herramientas o directamente con F5.

En determinadas circunstancias podemos desear utilizar distintos parámetros para la ejecución. Por ejemplo, cuando se espera que un programa reciba argumentos en línea de comando. Para estos casos, JCreator nos permite tener más de una configuración, teniendo la posibilidad de elegir una u otra en el momento de ejecutar una aplicación determinada. La configuración de los parámetros de ejecución lo hacemos en Build -> Runtime Configuration, o directamente a través del menú desplegable junto al icono de ejecución, apareciendo una ventana como la siguiente:

En esta ventana aparecen los posibles entornos de ejecución. Dependiendo del tipo de cambio que queramos hacer podemos modificar el modo por defecto (configuración Default) o crear uno nuevo. Para modificar la forma de ejecución por defecto seleccionamos <Default> y pulsamos Edit. Sin embargo, es preferible dejar la ejecución por defecto como está, así que creamos una nueva pulsando el botón New. Aparece entonces una ventana como la siguiente:

El campo Run indica la clase principal de nuestro proyecto (la clase que contiene el método main; JCreator tiene la lista de todas las clases con método main, y selecciona una de entre ellas, que nosotros podemos cambiar). En el campo Main(...) indicamos los parámetros que main necesita para su ejecución. Estos argumentos serían fijos, y se utilizarían cada vez que se ejecutara el proyecto con esta configuración.

Alternativamente podemos cambiar el modo de ejecución de forma que el sistema nos solicite los parámetros en el momento de comenzar la ejecución. Introduzcamos como etiqueta "con parámetros". En este caso, nuevamente, en lugar de modificar la configuración <Default> es recomendable crear una nueva.

Ahora creamos una nueva forma de ejecución pinchando el botón New estando activa la etiqueta Run Application (alternativamente podemos utilizar el botón Copy, de forma que se cree una copia las mismas opciones que después podemos modificar). Esto creará una nueva configuración de ejecución con valores iniciales los por defecto. Le damos un nombre (el mismo “con parámetros” por ejemplo) y seleccionamos las opciones deseadas. La imagen siguiente muestra la ventana que aparece tras seleccionar la pestaña Parameters y marcar la opción “Prompt for main function arguments” para que nos solicite los argumentos del main al ejecutar.

Con OK volvemos a la ventana anterior, donde tenemos que asociar como herramienta para la ejecución de aplicaciones “con parámetros” con la configuración “con parámetros”. Obsérvese que mientras la primera únicamente tiene opciones de ejecución de aplicaciones, la última también contiene opciones relacionadas con la ejecución de applets y con depurador.

Ahora es posible ejecutar nuestro proyecto utilizando la configuración por defecto o la nueva con parámetros. Por ejemplo, el aspecto del desplegable del icono de ejecución del entorno es el siguiente:

Por defecto se utilizará, claro está, las opciones indicadas en Default.

Obsérvese que todo esto es necesario porque no es posible pasar los argumentos en línea de comandos. Si ejecutáramos nuestra aplicación desde una sesión MS-DOS nada de esto es necesario.

2.5 Modificación de CLASSPATH Una vez dentro de un proyecto, podemos indicarle a JCreator dónde puede encontrar los paquetes que necesite sin necesidad de modificar directamente la variable de entorno CLASSPATH. Para ello, debemos ir a Project -> Project Properties -> Required Libraries y allí añadir una ruta al CLASSPATH simplemente creando una entrada y seleccionándola. Pulsamos New..., le damos un nombre, por ejemplo, Util, y ahora añadimos una ruta(Add -> Add Path...).

Nosotros utilizaremos normalmente el directorio c:\java\util\ para nuestras librerías de clases.

Puede añadirse la documentación de la librería si se dispone de ella.

2.6 El depurador de JCreator PRO 3.5 (y EDDJava 1.3) La versión LITE de JCreator no dispone de depurador, este sólo está disponible, y en un formato muy simple, en la versión Pro. Se recomienda el uso del depurador EDDJava. Si vas a utilizar la herramienta EDDJava puedes saltarte el resto de la sección. Puedes encontrar información sobre la instalación y uso de dicha herramienta en el documento sobre ella.

Para ejecutar con depuración en JCreator Pro 3.5, simplemente hay que seleccionar Build -> Start Debugger (Ctrl-F5). A partir de entonces, aparecerá un triángulo amarillo a la izquierda de alguna línea del programa indicando por dónde va la ejecución. En el menú Build hay diferentes entradas con algunas de las operaciones que se pueden realizar en este modo de ejecución. Hay teclas para ejecutar pasa a paso, se pueden incluir puntos de ruptura, etc.

Para interrumpir la depuración puede pulsarse el icono Stops the active tool del menú de herramientas o usarse la combinación de teclas Ctrl-B.

2.6.1 Generación de entorno de depuración completo Con lo visto en la sección anterior no es posible visualizar el estado de los objetos ni de sus variables. Esta es la parte que está menos desarrollada en JCreator Pro.

Para ello es necesario generar un entorno de compilación que llamaremos Debug que permita que se inspeccionen los objetos y variables.

Para ello Project -> Project Properties y aparecerá una ventana similar a la siguiente:

Seleccionamos la opción JDK Tools y seleccionamos la herramienta compilador (Select Tool Type: Compiler). Ahora tenemos dos opciones, modificar la configuración por defecto o crear un segundo entorno de compilación. Hagamos lo segundo: Seleccionamos la herramienta por defecto (<Default>) y pulsamos Copy. En este momento se nos abre una ventana con los datos de un nuevo entorno de compilación (con los mismos datos que el entorno por defecto), a la que hemos de dar un nombre, por ejemplo, “Debug”. Ahora, en Parameters, seleccionamos Include debug info para que se incluya la información adicional para depuración.

Al pulsar OK volvemos a la ventana anterior donde ahora aparece una nueva opción de compilación que seleccionamos.

Al compilar se utilizará el entorno seleccionado. Posteriormente podemos ejecutar cualquier aplicación con o sin depuración según se utilice Execute Project (F5) o Debug (Ctrl-F5). Pero ahora podemos consultar el estado de las variables y de los objetos.

2.6.2 Utilización de la información de objetos Desde la ventana de depuración podemos escribir varios comandos. En particular:

- locals Produce un listado de las variables locales

- dump <variable> Produce un listado del contenido de esa variable. Si variable

referencia a un objeto, puede accederse a sus variables de instancia cualificándolas. Esto puede hacerse en varios niveles.

- exit Para interrumpir la depuración (igual que CTRL-B).

- help Para obtener una lista de todos los comandos disponibles.