Introducción al uso de eclipse

Transcripción

1 Introducción al uso de eclipse Versión Original: Juan Pablo Canepa, Ignacio Pérez, Alex Bustos Revisiones: Verano 2006 A. Bustos 1 de 24

2 Tabla de Contenidos Tabla de Contenidos...2 Iniciando eclipse...3 Entorno eclipse...4 Proyectos, carpetas y archivos...5 Programando en Eclipse...7 Importando librería del curso...10 Agregando código y ejecutando mi primer programa en java...12 Respaldando su proyecto...14 Recuperando un proyecto desde un archivo comprimido...16 Renombrando un proyecto...18 Proceso de entrega en el Buzón de Tareas...19 Anexos...21 Manejando errores...22 Comentarios dentro del código de 24

3 Iniciando eclipse La primera vez 1 que se inicia el eclipse, este pide que se le confirme en que directorio debe conservar los proyectos que se creen. Por defecto, esto es una carpeta bajo el directorio mismo en el que se encuentra el programa. Elija alguna carpeta en la unidad T: 2, preferentemente creando una especial para este propósito (por ejemplo T:\proyectos). Por defecto el eclipse crea una carpeta workspace en su mismo directorio (es decir, si eclipse está instalado en T:\eclipse, el workspace queda en T:\eclipse\workspace). Este comportamiento por defecto es suficiente para nuestros propósitos. Recuerde que todo el contenido de la unidad T 3 SE BORRA AL TERMINAR LA SESIÓN. No olvide respaldar su trabajo, ya sea en su home (H:) o bien en otro medio como correo electrónico antes de terminar la sesión de Windows. Seleccione la casilla Use this as the default and do not ask again para que no le vuelva a preguntar esto La próxima vez que utilice Eclipse. Posteriormente, se iniciará el programa, mostrándole una ventana de bienvenida y ayuda. Si lo desea, consulte la ayuda en línea que esta ventana provee para aprender más sobre eclipse y java. Por el momento, nosotros sólo la cerraremos haciendo clic en la cruz a la derecha de Welcome para continuar. Para volver a ver esta ventana, simplemente vaya al menú Help y haga clic en Welcome. 1 Es posible que esta pregunta se la repita cada vez que inicie el eclipse tras loguearse en una máquina. Simplemente repita el proceso. 2 Al trabajar en los laboratorios de la universidad, dispondrá de la unidad T:, al trabajar fuera de la universidad, es posible que esta unidad no este disponible, en ese caso debe escoger otra unidad como por ejemplo, C: 3 Nuevamente este comportamiento es válido para los laboratorios de la universidad y puede no ser así en otros computadores. 3 de 24

4 Entorno eclipse Tras cerrar el tab 4 de bienvenida, se nos presenta el ambiente de desarrollo, el cual tiene un aspecto como el mostrado en la siguiente figura: 4 tab es el nombre que reciben en inglés las lengüetas o pestañas que sobresalen de los ficheros, etc. que sirven para ubicar páginas en ellos. En programas computacionales es fácil encontrar este tipo de lengüetas usadas para organizar contenido. Eclipse no es la excepción. Seguiremos usando el nombre original inglés para mantener consistencia con las ayudas en línea del programa. 4 de 24

5 Proyectos, carpetas y archivos Un proyecto es un conjunto de carpetas de archivos (No es obligatorio que tenga ambos, incluso puede tener cualquier cantidad de cada uno de ellos) que tienen alguna Ilustración 1 funcionalidad relacionada. A los archivos, carpetas y proyectos se les agrupa bajo el nombre recursos ( resources, en inglés). Idealmente, todos los recursos dentro de un proyecto apuntan a resolver un mismo problema, así, por ejemplo, un proyecto Ecuaciones podría contar con un algún número de archivos con el objetivo de conseguir un programa que resuelva algún tipo de ecuaciones. Los archivos son principalmente archivos de código (que tienen la extensión.java ) y son el ladrillo básico de construcción de un programa. Las carpetas son más que nada para permitir organización (por ejemplo, mantener todos los archivos relacionados con ecuaciones cuadráticas en una carpeta, los de ecuaciones no lineales en otras, etc.). Ilustración 2 Antes de poder empezar a trabajar, necesitamos crear un proyecto. Para esto nos vamos al menú File / New / Project, tal como se ve en Ilustración 1, que es equivalente a hacer clic en la pequeña flecha negra al costado derecho del primer botón de la barra de herramientas y elegir Project. Con esto se nos presenta un cuadro que nos pregunta el tipo de proyecto que deseamos crear. Lo que nos interesa es hacer una aplicación Java que corra independientemente, por lo que elegimos la opción Java Project [ver Ilustración 2], y hacemos clic en next. El siguiente cuadro nos pide un nombre para el proyecto. Este puede ser cualquiera que deseen. Idealmente, traten de que sea corto (no oraciones), pero que a la vez sea descriptivo. Nombres como Proyecto suelen llevar luego a complicaciones porque no se sabe que es realmente lo que realiza. Un mejor nombre podría ser Laboratorio 1. En Project layout, seleccione la opción Create separate source and output folders. Esto facilitará la entrega del código a los ayudantes, porque dejará todo el código en una carpeta aislada dentro del proyecto. Haga clic en Next y nuevamente en Next en la siguiente ventana que aparezca, porque no necesita cambiar nada. Con esto tenemos listo nuestro primer (vacío) proyecto. 5 de 24

6 Al terminar los pasos anteriores, vemos que en la vista Package Explorer aparece nuestro proyecto tal como puede verse en la Ilustración 3. Al expandirlo haciendo clic en el signo + que aparece al lado del nombre vemos que ya hay algo adentro. En este caso, están las librerías de sistema, que no necesitamos conocer en detalle por ahora, por lo que simplemente las Ilustración 3 ignoraremos. Además está la carpeta src que es la carpeta que contendrá todo el código fuente 5 (todas las clases). Pero este proyecto, así tal cual, está vacío. No hace nada. Para que haga algo, necesitamos agregar el código apropiado. A continuación desarrollaremos una aplicación básica que imprima un mensaje en pantalla. 5 Esta carpeta podría no verse si usted no seleccionó la opción Create separate source and output folders en el paso de creación del proyecto. 6 de 24

7 Programando en Eclipse En java, todo código está contenido al interior de alguna clase. Por lo anterior, si deseamos agregar alguna funcionalidad o código, debemos primer crear una nueva clase. Para conseguir esto, vamos a hacer clic en el botón Class dentro del menú File New, tal como indica la Ilustración 4. Ilustración 4 A continuación veremos un cuadro de Dialogo New Java Class, como el que se aprecia en la Error! No se encuentra el origen de la referencia.. En este se debe especificar un nombre para la clase (nuevamente, corto, pero descriptivo. Más adelante en el curso quedará más claro el concepto de clase y los nombres para estas surgirán en forma más natural), que por el momento dejaremos como Principal Dado que esta es la primera clase y la que encapsula el funcionamiento de partida del programa, asegúrese de hacer clic en el checkbox public static void main(string[] args) que se encuentra hacia el final del cuadro. Tras hacer clic en el botón Finish, nos encontramos con una serie de cambios dentro de nuestro proyecto. Ilustración 5 7 de 24

8 Inicialmente, vemos que en el Package Explorer aparece ahora, dentro de la carpeta src el paquete (default package) (ver Ilustración 6). Por el momento no nos preocuparemos mucho de la semántica de un paquete. Simplemente lo veremos como un conjunto de código relacionado. Dentro de éste hay un archivo, Principal.java que contiene la clase que acabamos de crear, Principal. Dentro de un archivo podríamos, bajo ciertas condiciones muy particulares, llegar a tener más de una Ilustración 6 clase, es por esto que las clases aparecen como una lista (árbol 6 en realidad) que cuelga del archivo. A su vez, los métodos de la clase son mostrados como un lista que cuelga de la clase. Más adelante en el curso se verá que son y para qué sirven los métodos. Por el momento sólo tenemos el método main que es el punto de entrada de nuestro programa. Cuando éste parta (el programa) lo primero que se hace es ejecutar el código que se encuentra en el método main. Es aquí donde incluiremos el código para mostrar el mensaje de nuestra aplicación demostrativa. 6 El concepto de arbol es muy usado en Ciencia de la Computación, si quiere profundizar en el tema puede visitar el siguiente sitio web 8 de 24

9 Junto con el cambio en el Package Explorer también aparece, en la parte principal del editor, el código de la clase, que por el momento no es más que la definición de esta. Ilustración 7 Como se puede ver en la Ilustración 7, se agregan automáticamente comentarios que guían inicialmente el desarrollo. Por el momento ignoraremos el significado de los mismos. Para más detalles en torno a los comentarios refiérase al anexo dedicado al tema al final del documento. Un último cambio observable es que la vista Outline (ver Ilustración 8), que se encuentra a la derecha, se ha actualizado para mostrarnos el esquema de clases actual. Esta vista será útil cuando tengamos más clases, pero por el momento sólo nos ocupa un poco de espacio útil por lo que si lo desea puede arrastrarla por encima de el Package Explorer, para que quede oculta como un tab en ese mismo sector. Una vez arrastrada, puede recuperar la vista del Package Explorer con sólo hacer clic en el tab correspondiente. Todos los cambios anteriormente descritos son efecto de haber agregado la clase y por lo tanto están relacionados. Por ejemplo, si Ilustración 8 Ud. hace doble-clic sobre el nombre de una clase en el Package Explorer, el editor mostrará el código para esta clase. Lo mismo ocurrirá con los métodos de estas y con otras cosas. No tenga miedo en explorar el programa. 9 de 24

10 Importando librería del curso Los ayudantes del curso, pensando siempre en el bienestar de sus queridos alumnos, han encapsulado un conjunto de funcionalidad para hacerles la vida más fácil. Funcionalidad como por ejemplo, imprimir mensajes. Para poder usar esta funcionalidad, es necesario incluir en el proyecto el código preparado por lo ayudantes. Para esto, los ayudantes pondrán a su disposición (por algún medio 7 ) un archivo llamado iic1102.jar. Este debe ser arrastrado por sobre el nombre del proyecto creado. Veamos este paso con un poco más de detalle. Digamos que usted ha descargado el archivo iic1102.jar y que lo tiene en el escritorio. Debemos ahora arrastrar este archivo hasta el proyecto, al interior de eclipse. Para lograr esto, se recomienda que redimensione la ventana de eclipse de forma de ver tanto el archivo descargado como eclipse tal como se indica en la Ilustración 9. Ilustración 9 7 El medio más usado para distribuir este archivo es a través del sitio del curso. Revise la sección de Noticias para enterarse de cómo descargar este paquete. 10 de 24

11 A continuación arrastramos el archivo sobre nuestro proyecto tal como indica la Ilustración 10. Si el procedimiento anterior fue realizado en forma correcta, entonces debiéramos haber incorporado el archivo a nuestro proyecto. Sin embargo eso no significa que estemos listos para usar las funcionalidades provístas por este. Para poder usar la funcionalidad encapsulada, debemos hacer clic derecho sobre el archivo recién incorporado, luego seleccionar en el menú emergente la opción Add to build path del submenú Source como puede verse en la Ilustración 11. Ilustración 10 Ilustración 11 Con esto el código preparado por los ayudantes queda listo para ser usado (ojo: para ser USADO. El formato en el que se distribuye este código NO PERMITE ser editado. Eso es normal, y por lo tanto hacer doble-clic sobre iic1102.jar sólo mostrará información sobre los nombres de las clases y funciones que hay en este archivo, pero no el código respectivo. Simplemente asegúrese de que este archivo queda insertado correctamente en el proyecto, comprobando que el icono que acompaña al archivo se transforma en un frasco blanco de tapa amarilla y luego ignore su presencia por completo). 11 de 24

12 Agregando código y ejecutando mi primer programa en java Cambiemos la definición del método main para que muestre un mensaje a través de un cuadro de dialogo 8. Para esto, cambie el código de la clase Principal para que se vea así: import iic1102package.*; public class Principal { public static void main(string[] args) { Interfaz.MostrarMensaje( Este es mi primer programa en java ); } } En el código anterior se han omitido los comentarios para no entorpecer la lectura. Guarde sus cambios (apretando la tecla CTRL y la tecla S simultáneamente 9 ) o bien mediante el menú File Save. Ahora, haga clic con el botón derecho del mouse sobre la clase Principal, y elija la opción Java Application del submenú Run, como se muestra en la Ilustración 12. Ilustración 12 8 Un Cuadro de dialogo es la tradicional ventana que vemos en sistemas operativos como Windows. 9 Esta acción la abreviaremos CTRL+S de ahora en adelante. Así mismo con cualquier combinación de teclas. 12 de 24

13 La aplicación será compilada y cualquier error será reportado. Si todo ha salido bien, en la parte central de su pantalla debiera observar un cuadro de dialogo como el siguiente: Si ha habido errores, el eclipse le advertirá de ello y le preguntará si desea tratar de continuar con la ejecución de todas maneras. No es sabio hacerlo, por lo que se le aconseja que ante esta pregunta elija la opción Cancel que detendrá el intento de ejecución. Proceda entonces a revisar el tab Problems, que detallará una lista con todos los errores encontrados. Trate de resolver siempre el primer error de la lista primero, dado que a veces ese error gatilla los demás. Haciendo doble-click sobre el error en la lista de errores, le lleva al código, en la línea en la que se produjo el error. El mensaje asociado a este error suele ser lo suficientemente explicativo como para resolver el error muy rápido, préstele atención! 13 de 24

14 Respaldando su proyecto Para respaldar su proyecto, basta con respaldar la carpeta del workspace asociada al proyecto (léase, la que tiene el mismo nombre). La forma más eficiente y cómoda de hacer esto es comprimiendo dicha carpeta, porque así se beneficia por partida doble: Solo tiene que asegurarse de copiar a un lugar seguro un único archivo El espacio ocupado por este archivo es reducido, por estar comprimido [Opcional] Para hacer más pequeño el archivo comprimido, eliminaremos todos los archivos que se generan durante la compilación. Estos no se ven normalmente, pero son generados por el compilador en la carpeta del proyecto. Para limpiar nuestro proyecto de dichos archivos, vamos al menú Project y desmarcamos la opción Build Automatically, luego vamos al mismo menú y en él elegimos Clean. Esto abrirá una ventana preguntándonos por qué proyecto deseamos limpiar (dado que podemos tener más de un proyecto en nuestro workspace). Para asegurarnos que limpie el que nos interesa, hacemos clic en la opción que nos muestra el proyecto en el que hemos estado trabajando, y nos aseguramos que la casilla Start a build immediately NO esté marcada. Finalmente, podemos ir al menú Project y volver a marcar la opción. Build Automatically. Es necesario deshabilitar esta opción para que el cuadro Clean? permita deseleccionar la opción Start a build immediately. Si esta opción estuviese marcada (o bien, la opción Build Automatically estuviese elegida en el menú Project ), inmediatamente tras el clean se construirían de nuevo los archivos, inutilizando todo lo que acabamos de hacer. [Necesario] Habiendo limpiado el proyecto, podemos cerrar el eclipse e irnos al workspace. Para seguir con nuestro ejemplo, necesitaríamos ir a T:\eclipse\workspace. Para esto, abrimos de alguna manera una ventana del explorador de windows (ya sea a traves de My Computer, o en el menú inicio siguiendo Start/All Programs/Accesories/Windows Explorer, o la forma que más le acomode). Si nos paramos en la carpeta del workspace, vamos a ver todos los proyectos que en ella hay, como se aprecia en la siguiente figura. 14 de 24

15 en esta, se ha hecho clic con el botón derecho sobre la carpeta del proyecto Laboratorio En este caso en particular, el autor tiene instalado el software de compresión WinRAR 11, pero es posible que el lector tenga instalado otro muy popular, el WinZIP 12. Ambos funcionan en forma muy similar, y ofrecen opciones muy similares en el menú emergente. En este caso, se ha seleccionado la opción Add to Laboratorio 1.rar, ya que esta opción es la más rápida. Tras hacer clic en esa opción, se produce en la misma carpeta el archivo Laboratorio 1.rar. Este archivo es el comprimido con todo el contenido de la carpeta Laboratorio 1, y por lo tanto puede ser copiado a un dikette (si le cabe) o a un pendrive o mandado por mail o lo que se le ocurra. Tenga en consideración que durante las sesiones de laboratorios, la única forma de respaldar su trabajo será a través del buzón de tareas del curso. Si usted desea obtener este archivo para revisarlo en su casa o para efectos de las recorrecciones se publicará una noticia en el sitio del curso que informará el procedimiento a seguir para conseguir este archivo Los proyectos que se muestran en la imagen corresponden a los que están presentes en el computador del autor de este documento, los que por supuesto no tienen por qué ser los mismo que tendrá Ud. Esto mismo aplica para las entradas del menú emergente. El autor tiene instalados softwares que se incluyen en este menú, y que no necesariamente tiene instalados el lector (por ejemplo, las entradas que empiezan con CVS corresponden a un programa de manejo de versiones, el TortoiseCVS, que nada tiene que ver con nada de este manual.) Este comportamiento es válido al menos para el periodo y pudiera repetirse en semestres posteriores. 15 de 24

16 Recuperando un proyecto desde un archivo comprimido Tras haber ejecutado los pasos de la sección anterior, es probable que ahora necesite recuperar el proyecto a partir del archivo comprimido. Para hacer esto, es necesario descomprimir el contenido del archivo comprimido en la carpeta del workspace. Por ejemplo, si el archivo comprimido generado en la sección anterior se encuentra ya en la carpeta del workspace, basta con hacerle clic con el botón derecho y elegir la opción Extract Here (o equivalente) del menú emergente. Si el archivo no está directamente en la carpeta del workspace, basta con arrastrarlo a ella con el botón derecho (esto es, hacer clic con el botón derecho sobre el archivo en el lugar donde este se encuentre originalmente, y sin soltar el botón, arrastrar el puntero del mouse por sobre la carpeta workspace del eclipse y soltar el botón. Con esto surgirá un menú emergente similar al anterior y basta con elegir la opción Extract Here o equivalente. Note que la opción Extract to Laboratorio 1\ NO sirve, porque creará una carpeta extra que entorpecerá al eclipse. Debe asegurarse que la carpeta creada sea efectivamente la que contiene el proyecto y no una carpeta que contiene otra carpeta con el proyecto. Hecho esto, estamos listos para el último paso. Inicie el eclipse si es que no lo ha iniciado ya, en él siga los pasos descritos con anterioridad para crear un nuevo proyecto. Cuando se le pregunte por el nombre ingrese el nombre del proyecto que recuperó del archivo comprimido (con exactamente el mismo nombre, es decir, si el proyecto se llama Laboratorio 1, no le servirá escribir acá Laboratorio1 ). Si todo ha resultado bien, en el final de la ventana de creación del nuevo proyecto aparecerá un mensaje como el que se muestra en la figura 16 de 24

17 el cual le advierte que ya existe una carpeta con dicho nombre y que por lo tanto eclipse tratará de automáticamente detectar si es que existe un proyecto en ella, y lo agregará a la lista del Package Explorer si lo logra. Haciendo clic en el botón Finish debería estar terminado el proceso de recuperación del proyecto. 17 de 24

18 Renombrando un proyecto A veces, es necesario renombrar un proyecto. Y dado que eclipse mantiene información interna sobre cada proyecto, cambiar el nombre de la carpeta en el workspace no tiene los efectos que uno esperaría. Luego es mejor dejar que eclipse se encargue del trabajo sucio. Para esto, abra 14 el proyecto que quiere renombrar (un proyecto puede estar abierto o cerrado en el Package explorer. Sólo se puede trabajar en los proyectos abiertos, por lo que tiene sentido tener abierto únicamente el proyecto en que se está trabajando. Para abrir (o cerrar) un proyecto, basta hacer clic con el botón derecho sobre él y elegir la opción Open Project del menú emergente 15 ) y haga clic con el botón izquierdo en el nombre del proyecto. Luego, aprete la tecla F2 y cambie el nombre del proyecto en el cuadro que aparece (mostrado en la figura siguiente). En algunos casos puede aparecer un error muy feo, pero que haciendo clic en abort es ignorado con la suficiente frialdad como para que todo resulte bien. Hasta ahora no parece haber inconveniente en darle abort, pero el sentido común llama a revisar que el proyecto renombrado funciona bien haciendo una corrida de compilación y ejecución. Si todo funciona ok, estaría listo. 14 Si el proyecto ya estaba abierto, asegúrese de cerrar todas los archivos que haya estado editando 15 Equivalentemente, en un proyecto cerrado aparecerá la opción Close Project que, si es elegida, cerrará el proyecto. 18 de 24

19 Proceso de entrega en el Buzón de Tareas La presente sección será válida para los buzones de tareas provistos por las páginas de cursos administradas por DI 16. Para efectos prácticos, son aquellas páginas ubicadas en Este proceso comienza una vez que se concluyó el proceso de compresión de su trabajo. Es necesario recalcar que los trabajos deben ser comprimidos en formato rar 17. Existen variaciones semestrales que podrían indicar un determinado formato en el nombre del proyecto y del archivo que usted entrega en el buzón de tareas. Manténgase al tanto de estas variantes a través del sitio web del curso. Este proceso se inicia en el sitio del curso, el cual debe verse como en la Ilustración 13, debemos poner especial atención en la sección Entrega de Tareas que en la ilustración se destaca en azul. La presentación y ubicación de los vínculos pudiera cambiar dependiendo del semestre, la imagen es válida para la fecha de redacción de la presente revisión del tutorial. Ilustración 13 Ingresando en dicha sección se encontrará con una nueva ventana que le solicita un usuario y contraseña. Debe ingresar su loginpuc y la contraseña que usa en sistemas como Mi PortalUC o PucMail. Si no consigue ingresar debido a un problema con su contraseña debe dirigirse a DI. Si está seguro de recordar su contraseña y aún así no consigue entrar debido a que el sistema le dice que usted no pertenece al curso, debe comunicarse con el ayudante jefe del curso. 16 DI es el acrónimo de Dirección de Informática 17 El formato rar es el que es se revisó en la sección anterior. 19 de 24

20 Una vez que ha logrado autentificarse, verá un formulario como el que se muestra en la Ilustración 14. En este formulario debe seleccionar la actividad que está subiendo al buzón de tareas y el archivo que desea subir que en este caso se trata del archivo comprimido que contiene el proyecto desarrollado. Ponga especial cuidado en este proceso, debe seleccionar la actividad correcta, es más usual de lo que usted imagina entregar el laboratorio 4 en el buzón del laboratorio 1. Lo anterior es gravísimo dado que ante los ojos del ayudante, usted no habrá entregado el laboratorio 4 y será calificado como tal. Ilustración 14 Al subir en forma satisfactoria el laboratorio, se le desplegará información relevante como la fecha y hora de entrega así como el archivo que usted ha subido, verifique una vez más que la actividad que ha entregado es la correcta, es decir, que no entrego el laboratorio en un buzón incorrecto. Usted puede subir tantas veces como desee su trabajo al buzón de tareas, sin embargo, tenga en consideración que sólo el último archivo subido es el que permanece, el resto se pierde, por lo tanto será el último archivo subido al buzón el que revisen los ayudantes del curso para corregir su trabajo. 20 de 24

21 Anexos Las páginas siguientes no son parte fundamental para el desarrollo de los laboratorios, sin embargo es altamente recomendada su lectura y puesta en práctica debido a que les facilitará el desarrollo de las sesiones de laboratorios. Estos anexos han surgido de las mismas preguntas recurrentes por parte de los alumnos durante el transcurso de tareas y laboratorios en semestres anteriores. Se considera de su responsabilidad el aprendizaje de los contenidos aquí expuestos. 21 de 24

22 Manejando errores Eclipse es tremendamente expresivo en cuanto a los errores. Mientras Ud. programa, eclipse estará revisando que lo que ud. haya escrito: 1. Esté sintácticamente correcto: es decir, que no hayan caracteres indebidos en donde no deben ir, que todas las líneas terminen en ;, que no haya espacios en donde debe haber comas, etc, etc. 2. Que los tipos coincidan: entre los tipos que se declararon para los argumentos y el retorno de una función y la llamada a esta. 3. Que no hayan variables sin declarar: es decir, que no se usen variables que no han sido declaradas previamente. Esto es parte pequeña de la gran cantidad de errores que puede detectar el eclipse en tiempo de programación. Para informarle de que hay algo raro en alguna parte del código, normalmente eclipse subraya la parte con problemas con rojo. Al posar el puntero del mouse por sobre el lugar subrayado, eclipse entrega una descripción del error que encontró. En el caso del ejemplo anterior, el problema es que falta poner ; al final de la línea. En los mensajes de error de eclipse suele aparecer la palabra token. Esta palabra significa cualquier elemento del programa, como puede ser el nombre de una variable, una llave {, un operador o cualquier elemento. En el caso del ejemplo de la imagen de abajo, el token es el nombre de la variable f1. En este ejemplo, el error es que no se puso una coma entre la declaración de los dos argumentos. 22 de 24

23 Comentarios dentro del código Usted ya se ha topado con una serie de líneas en el código que tiene colores como verde o celeste similares a los que se observan en la Ilustración Ilustración 15 Los comentarios es texto que ayuda la lectura y entendimiento de un programa java. Este texto no es un código java válido y de hecho es omitido al momento de ejecutar el programa. Por lo mismo, sea generoso a la hora de escribir comentarios, tiene varios beneficios asociados entre los que se encuentran: Debido a que los laboratorios son actividades largas, es frecuente que uno deba volver al código que escribió horas antes, y es más frecuente aún que no se recuerde completamente el sentido que tenía dicho código. El comentar el código indicando que se está realizando en cada segmento de código facilita su lectura. No tan solo usted debe leer su código, piense que hay correctores que deben revisar el correcto funcionamiento del mismo, de esta forma, es mejor entregar la mayor cantidad de facilidades al corrector de forma que él pueda realizar su labor de la forma más expedita posible. Ejemplos de comentarios útiles son: Ahora voy a calcular los valores promedios pedidos A continuación desplegare los valores pedidos en el enunciado Sin embargo, los siguientes son malos comentarios debido a que no ayudan realmente a la comprensión del código o bien porque no brinda información adicional relevante. Aquí declaro una variable El siguiente es un método que retorna un valor entero Java permite básicamente dos tipos de comentarios: De línea Bloques de comentario 23 de 24

24 Los comentarios de línea son los indicados con un número 1 en la Ilustración 15, el comentario está defindo por los dos slash" //. Todo lo ubicado a la derecha de estas dos barras inclinadas, hasta el final de la línea se considera un comentario y eclipse lo colorea de verde. Los comentarios de bloques son similares a los de línea, pero permiten comentar más una línea a la vez tal como se observa con un número 2 en la misma ilustración. La forma de definir estos comentarios es mediante una apertura del comentario por medio de /* y un cierre del comentario definido por */. Todo lo que se encuentre al interior de estos delimitadores será considerado como un comentario y no será ejecutado 18. El siguiente es un ejemplo un poco más extenso del uso de comentarios dentro del código. Sientase libre de comentar su código, le ayudará a usted mismo y a los correctores. Ilustración 16 Fuente: Laboratorios IIC Existe una sutil diferenta entre los comentarios de bloque delimitados por /* y */ y aquellos que son delimitados por /** y */. Sin embargo para los efectos de este tutorial considere que ambos son comentarios, sin entrar en más detalles. 24 de 24