Download Esta prctica est dedicada al entorno de desarrollo Eclipse

Universidad Tecnológica Centroamericana
Ingeniería de Sistemas Computacionales
Compiladores 1 – Semestre 1 2005
Ing. Egdares Futch H.
Laboratorio #1
Introducción a Eclipse y ANTLR
Duración estimada: 3 horas
Esta práctica está dedicada a introducirse a las herramientas que usaremos en los cursos de
Compiladores 1 y 2, especialmente Eclipse y ANTLR. Uno de los mayores atractivos de la
plataforma Eclipse es la flexibilidad de los famosos plugins. Un plugin es una pequeña
aplicación escrita en Java que aumenta la funcionalidad de la plataforma, haciendo que Eclipse
se convierta en un entorno de desarrollo para cualquier cosa que cuente con unl plugin adecuado,
como validadores, etc. Para nuestro curso, existe un plugin para ANTLR que nos permitirá
manejar de manera más eficiente los archivos de trabajo para la generación del analizador léxico
y sintáctico. Los objetivos de ésta práctica son:
•
•
•
•
Hacer la instalación de Eclipse
Crear un proyecto básico de Java
Instalar el plugin de ANTLR de forma remota
Crear un proyecto básico de ANTLR
Para hacer esta práctica se asume que previamente se ha instalado el Software Development Kit
(SDK) de Java 1.4. No se incluyen las instrucciones en este documento para esta actividad.
Consulte http://java.sun.com para referencia. Deberá tomar notas detalladas de los resultados
obtenidos en cada paso, ya que debe entregar un informe de laboratorio.
Materiales requeridos
•
•
Un CD con herramientas e información
Un computador equipado con Windows XP, 512 MB de memoria RAM y al menos 128
MB libres de espacio en disco
A) Instalación del entorno de programación Eclipse
1. Copiar eclipse.exe en la carpeta c:\eclipse.
2. Ejecutar eclipse.exe. La primera vez preguntará por la carpeta (workspace) donde se
quieren ubicar los proyectos, elegir la ruta default: c:\eclipse\workspace
3. La primera vez que se ejecute aparecerá una pantalla de bienvenida que podrá ser visitada
en cualquier momento desde el menú Help → Welcome. Después de navegar por la
información, pasar al entorno de trabajo a través del icono Workbench en la esquina
superior derecha y proceder a familiarizarse con los menús y las características del
Eclipse.
B) Creación de un proyecto Java
1. Proceda a crear un proyecto Java por medio de las opciones File →
New→Project→Java→Java Project. Elija un nombre de proyecto (MiPrimerProyecto).
En el Package Explorer aparecerá una carpeta dedicada al proyecto. Puede estudiar las
opciones disponibles para proyectos colocándose sobre ella y activando el botón derecho
del mouse.
2. Pase a la vista de Java por medio de Window → Open Perspective.
3. Se añaden clases al proyecto a través de las opciones File → New→Class. Ingrese “test”
en el recuadro Package,y “Test” en el recuadro Class. Asimismo, marque la opción para
crear automáticamente el “public static void main(String[] args)”. Presione “Finish”,
para que Eclipse proceda a crear los archivos que correspondan.
4. Ingrese la línea “System.out.println(“Hola, mundo!”);” en el cuerpo del método main().
Salve el archivo Test.java y la compilación se hará automáticamente en ese momento.
Los errores, si los hubiera, aparecerán en la pestaña inferior de Problems.
5. Para especificar la manera en la que queremos ejecutar las clases que forman parte de un
proyecto se crea una configuración. Esto se hace mediante la opción Run → Run...
→Java Application → New. En la ventana correspondiente se podrán especificar la clase
principal del proyecto (pestaña Main) y los argumentos de entrada (pestaña Arguments).
C) Instalación del plugin de ANTLR de forma remota (conectado al Internet)
1. Entrar a la opción Help → Software Updates → Find and Install
2. Escoja la opción Search for new features to install
3. Introducir la dirección de donde descargar
http://antlreclipse.sourceforge.net/updates/
el
plugin
(New
Remote
Site)
4. Una vez creado el enlace a este nuevo sitio marcarlo y proseguir con la instalación con el
botón Next.
5. Elegir la última versión del plugin y proseguir con la instalación, al cabo de unas cuantas
confirmaciones se recomendará el reinicio del entorno Eclipse para que las
actualizaciones tengan efecto.
6. Si no tiene acceso a Internet durante la instalación, deberá seguir el procedimiento de
instalación de una copia local, descrito en la página del plugin
http://antlreclipse.sourceforge.net/, copiando a un diskette u otro medio removible los
archivos especificados en la sección de Instalación Manual (Manually).
D) Creación de un proyecto ANTLR
1. Crear un proyecto Java.
2. Para convertirlo en proyecto ANTLR usar la opción Toggle ANTLR project nature (botón
derecho del ratón sobre nombre del proyecto).
3. Para verificar que efectivamente es un proyecto ANTLR, y que por tanto procesa
automáticamente los archivos de ANTLR al hacer modificaciones, debe verificar por
medio de la opción Project → Properties → Builders que ANTLR Builder está activo.
4. Para que la compilación incluya las librerías de ANTLR, debe seleccionar Project →
Properties → Java Build Path →Libraries y añadir la biblioteca de ANTLR (antlr.jar), la
cual estará disponible bajo su directorio C:\eclipse\plugins\org.antlr_VERSION.
5. Busque ahora en la página de ANTLR http://www.antlr.org el Ejemplo Copy/Paste en la
sección de Documentación (Documentation), Getting Started with ANTLR y siga las
instrucciones allí descritas, pero haciendo uso de las facilidades de Eclipse. La
compilación de ANTLR y Java será automática al salvar los archivos y no se hace
necesario invocar la herramienta como indica la página, ni al compilador de Java.
6. Modifique el Ejemplo Copy/Paste para que el token NAME ahora se llame ID, y
reconozca nombres de variables que inicien con una letra mayúscula o un underscore,
seguidas de letras o números. Cambie el mensaje de “Hi there, dear friend” para que
ahora diga “El identificador detectado es:“.
7. Investigue ahora el formato de la documentación de programas por medio de Javadoc en
la página http://java.sun.com/j2se/javadoc/ y agregue documentación al archivo
Main.java (del Ejemplo Copy/Paste), indicando el autor, la forma de compilación, el
URL de referencia hacia la página de donde tomó el código, la forma de uso y una breve
descripción de qué hace el programa. Se hará especial énfasis en una redacción clara y
sin faltas de ortografía.
Blog del proyecto
1. Como parte del desarrollo de las habilidades de documentación y expresión de ideas,
cada alumno del curso deberá crear un blog, el cual deberá contener como mínimo una
entrada por semana detallando los avances en su aprendizaje de Java, ANTLR y el curso
de Compiladores. Esta documentación auxiliar será considerada como el 20% de la nota
del proyecto final. Para facilidad de calificación, se recomienda el uso de Blogger
(http://www.blogger.com).
Entregables
1. La primera entrada en su blog contando acerca de los resultados obtenidos y problemas al
hacer este laboratorio. Comentar acerca del uso de Java, Eclipse, Javadoc y otras
tecnologías nuevas que no habían tenido la oportunidad de utilizar. Remitir la dirección
del blog por medio de un correo con el subject “BLOG #CUENTA” a efutch AT
NOSPAM gmail.com.
2. Remitir por medio de la Plataforma de Universidad Virtual un informe detallando los
resultados obtenidos en las secciones A, B, C y D.