Spring

Instalación de Spring Framework

Breve tutorial para instalar el Framework Spring en el IDE Eclipse + Maven. Como explique previamente Spring es un conjunto de varios modulos (o jars) mismos que se pueden “activar” dependiendo de nuestra necesidades; en este breve tutorial solo explicare como instalar el modulo Core.

Herramientas necesarias

Las herramientas que necesitas para realizar este tutorial son:

  1. El JDK 1.5 (o superior)
  2. El IDE Eclipse JEE
  3. Apache Maven

Como puedes observar deje un enlace a la pagina de descarga de algunas herramientas para que te sea mas facil obtenerlas.

Crear la aplicacion base (esqueleto) con Eclipse

El primer paso para la instalacion es crear un proyecto Java con Eclipse, lo ire explicando por pasos y con imagenes para que sea mas facil entenderlo.

Abrir el IDE Eclipse

A continuacion vamos al Menu File->New->Other… y se presentara el asistente de creacion de proyectos de Eclipse:

En esta ventana basicamente vamos a elegir el tipo de proyecto a crear; en este caso un Proyecto de Maven, como puedes ver hay muchos tipos de proyectos. Seleccionamos la carpeta de Maven -> Maven Project y damos click en el boton Next:

La siguiente pantalla nos permite elegir el Nombre y Ubicacion del proyecto (donde se creara), en mi caso desmarque la casilla de verificacion Use Default Workspace working location para elegir otra ubicacion distinta a la default y seleccione la carpeta del workspace de Eclipse como se muestra en la siguiente pantalla.

Damos click en el boton Next y se nos presenta la siguiente pantalla (quizas tarde un poco en presentarla debido a que se deben descargar desde el repositorio central de maven todos los arquetipos disponibles):

En esta pantalla debemos elegir el Arquetipo a utilizar para el nuevo proyecto de maven. Recordemos que un arquetipo es algo asi como el esqueleto de un proyecto maven. En el Campo Filter escribimos el nombre del arquetipo maven-archetype-quickstart, si hay mas de uno con ese nombre tener cuidado de elegir el que tenga el groupId org.apache.maven.archetypes. Este arquetipo crea un Artefacto Maven de tipo Jar, damos click en el boton Next para continuar, se presentara la siguiente pantalla (rellenamos los campos con los datos que se observan):

Group Id: Debemos pensar en este dato como si fuera el paquete principal del proyecto. Típicamente aquí se pone el nombre de la empresa u organización a la que pertenece este proyecto.
Artifact Id: Es el nombre de tu proyecto, Maven creara una carpeta con este nombre y colocara ahi la estructura de carpetas del nuevo proyecto.
Version: Número de versión de tu proyecto, en este caso indicamos que es la version 1.0.
Para finalizar y crear el nuevo proyecto damos click en el boton Finish.

Estructura del proyecto Maven

La siguiente imagen muestra la estructura de carpetas y los paquetes creados por Maven:

Basicamente se creo la siguiente estructura de carpetas:
[nombreWorkspace]\InstalacionSpring\src
[nombreWorkspace]\InstalacionSpring\src\main\java
[nombreWorkspace]\InstalacionSpring\src\test\java
Donde
[nombreWorkspace]\InstalacionSpring\src\main\java
Es donde se deben colocar los paquetes y el codigo fuente del proyecto.
[nombreWorkspace]\InstalacionSpring\src\test\java
Es donde se deben colocar los paquetes y el codigo fuente para las pruebas unitarias que sean necesarias.

Vamos a crear las siguientes carpetas:
[nombreWorkspace]\InstalacionSpring\src\main\resources
[nombreWorkspace]\InstalacionSpring\src\test\resources

Dichas carpetas nos permitiran colocar archivos de configuracion y recursos en general del proyecto; como son el archivo xml descriptor de Spring, archivos de propiedades, archivos de idioma, etc. Ademas, estas carpetas forman parte de la estructura estandar de un proyecto de Spring.

En la carpeta [nombreWorkspace]\InstalacionSpring\src\main\java se creo el paquete
com.notasprogramacion.spring.setup y dentro de éste la clase App.java que contiene el clasico Hola Mundo (“Hello World!”)

En la carpeta [nombreWorkspace]\InstalacionSpring\src\test\java se creo el paquete
com.notasprogramacion.spring.setup y dentro de éste la clase AppTest.java que contiene una prueba unitaria muy basica con JUnit (las pruebas unitarias las veremos mas adelante).

Integracion del Framework Spring al archivo pom.xml

El archivo descriptor de Maven [nombreWorkspace]\InstalacionSpring\pom.xml es donde vamos a integrar el Framework de Spring, actualmente debe lucir mas o menos asi:

Para integrar Spring Core modifiquelo para que ahora se vea asi:

Una vez modificado el archivo guárdelo, a continuación explicare algunas lineas del archivo pom.xml:

De la linea 28 a 45 se agrego el modulo Core; si quisiéramos activar o utilizar algún otro modulo de Spring Framework, por ejemplo Spring JDBC, simplemente agregamos su dependencia (con la versión respectiva que queramos usar):

..y listo maven se encargara de descargar los jars necesarios para que utilicemos dicho modulo. Observa como agregue 3 dependencias mas (lineas 47 a 81); logf4j, slf4j y junit, éstas no forman parte del modulo Core de Spring. Las primeras 2 las usaremos para mostrar logs en la consola y junit para hacer algunas pruebas unitarias mas adelante.

De la linea 85 a 89 se esta indicando que la carpeta src/main/resources es una carpeta de recursos.

De la linea 93 a 99 se esta indicando la versión de java a utilizar para compilar, en este caso el jdk 1.7.

En la linea 91 se esta indicando el nombre del artefacto a generar InstalacionSpring; como el proyecto es de tipo

El artefacto final resultante se llamara InstalacionSpring.jar.

De la linea 101 a 108 se esta indicando que se omita la ejecución de las pruebas unitarias al momento de compilar el proyecto.

A continuación de click con el botón derecho sobre el nombre del proyecto y elija la opcion Maven->Update project…, en la ventana que se presenta de click sobre el boton OK, esto con el objetivo de que se vuelva a cargar la nueva configuración del archivo pom.xml

A continuación vamos a compilar el proyecto y colocarlo dentro de nuestro repositorio local de Maven. Nuevamente da click con el botón derecho sobre el nombre del proyecto y elija la opción Run As-> Maven build…, en la ventana que se presenta en el campo Goals escriba clean install; clean para borrar todas las clases .class y archivos binarios que pudiera haber, es decir, limpiar compilaciones previas, y el parametro install para compilar e instalar el proyecto en el repositorio local de Maven.

Observe en la siguiente pantalla como se descargaron otros jars, los cuales aunque no forman parte directa de spring son necesarios para que éste funcione de manera correcta.

Con esto ha quedado instalado el modulo Core de Spring en el proyecto, en las siguientes entregas estare mostrando como utilizarlo y las bondades que ofrece al desarrollar aplicaciones.

Si tienes alguna duda o deseas expresar alguna inquietud, no olvides dejar tus comentarios y si es necesario seran contestados a la brevedad.
Hasta pronto.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *