| Apéndice | |
| Inicio | Apéndice | Archivo cartografía del IDE Eclipse | |
Cartografía del IDE Eclipse
Vincular y acceder al código fuente de APIs externas
Cuando estamos escribiendo código Java en ocasiones nos puede ser de gran ayuda poder acceder al código fuente de las APIs externas que estamos utilizando.
Para por ejemplo acceder al código fuente de clase ClassPathXmlApplicationContext, posicionamos el puntero del ratón sobre esta clase y seguidamente seleccionamos Navigate | Open Declaration o presionamos la tecla F3.

si tenemos vinculado o asociado el código fuente de esta clase entonces en el editor de texto de Eclipse se abrirá una nueva pestaña mostrando el código fuente de la clase en cuestión.

si por el contrario no tenemos asociado el código fuente de la clase de la API externa, en el editor de texto de Eclipse se abrirá una pestaña indicando con el texto Source not found.

Para vincular o asociar el código fuente de una clase que pertenece a una API externa lo podemos hacer de dos formas diferentes
Forma 1: accediendo a la librería donde se encuentra la API externa
Hacemos clic sobre Window | Preferences

en el cuadro de diálogo Preferences seleccionamos Java | Build Path | User Libraries. En este ejemplo desplegamos la librería SPRING y el fichero org.springframework.context-3.05.RELEASE.jar. Ahora seleccionamos Source attachment: (None) y hacemos clic sobre el botón Edit...

en el cuadro de diálogo Source Attachment Configurtion tenemos que rellenar el campo de texto Location path:. Para ello hacemos clic sobre el botón External File...

ahora navegamos hasta encontrar el fichero jara que contiene el código fuente de la API esterna. En el curso tenemos instalado el código fuente del framework de Spring en la carpeta C:\IDE\eclipse\eclipse-jee-helios-SR1-win32-librerias\spring-framework-3.0.5.RELEASE\src.
Una vez hemos seleccionado la carpeta donde se encuentra el código fuente de la API que necesitamos (en este ejemplo org.springframework.context-sources-3.0.5.RELEASE.jar), hacemos clic sobre el botón Aceptar.

como podemos ver el campo de texto Javadoc location path: ya está rellenado. Para salir hacemos clic sobre el botón OK.

en el cuadro de diálogo Preferences también podemos ver que el JavaDoc está asociado al fichero jar de la API en cuestión. Para salir hacemos clic sobre el botón OK.

Forma 2: haciendo clic sobre el botón Attach Source...
Recordemoa que accdemos a la pestaña que nos muestra el texto Source not Found después de seleccionar Navigate | Open Declaration o presionamos la tecla F3 cuando estamos posicionados sobre el nombre o método de una clase

al hacer clic sobre el botón se abre el cuadro de diálogo Source Attachment Configurtion. Para rellenar el campo de texto Location path: hacemos clic sobre el botón External File...

ahora navegamos hasta encontrar el fichero jara que contiene el código fuente de la API esterna. En el curso tenemos instalado el código fuente del framework de Spring en la carpeta C:\IDE\eclipse\eclipse-jee-helios-SR1-win32-librerias\spring-framework-3.0.5.RELEASE\src.
Una vez hemos seleccionado la carpeta donde se encuentra el código fuente de la API que necesitamos (en este ejemplo org.springframework.context-sources-3.0.5.RELEASE.jar), hacemos clic sobre el botón Aceptar.

como podemos ver el campo de texto Javadoc location path: ya está rellenado. Para salir hacemos clic sobre el botón OK.
