Download - Spring tool suite instalacion
http://myjbreak.wordpress.com/
2
Contenido I. Introducción: ......................................................................................................................... 4
II. Descarga e Instalación de SpringSource Tool Suite: ............................................................ 5
III. Configuración de Maven: ................................................................................................... 14
IV. Configuración de Spring ROO (Línea de Comandos): ........................................................ 20
V. Nuestro primer proyecto con Spring Tool Suite y Maven: ................................................ 24
http://myjbreak.wordpress.com/
3
Agradecimientos:
Bueno debido a que este tutorial tiene pinta de libro y que es muy bueno lo que haré,
comenzaré a agradecer (Espero no arrepentirme luego). Agradezco a mi chow chow
‘Morado’ por morderme un par de veces y por los paseos diarios que a veces despejan
mi mente y me traen buenas ideas como la de este tutorial, gracias … A
CIBERTEC…no! Bueno, a los profes con los que he tenido clase y los que han
fomentado el También a los profesores que me jalaron en ADSI y Taller de Formación
3, sino probablemente, no fuera lo que hoy, soy ... ya. A la family, a los amigos del
barrio, a los pocos amigos en el instituto, a un par de amigos de la comunidad Ágil
Perú, a mi profe Jose Díaz que me enseño todo lo que sé sobre Spring. Finalmente,
muchas gracias a Yamili, mis ojos, no me atrevería a escribir un post, sin su ayuda. No
soy daltónico, pero soy muy malo en cosas gráficas. Y así como soy tan malo en eso,
soy muy malo dando las gracias…Saludos!
http://myjbreak.wordpress.com/
4
I. Introducción:
SpringSource Tool Suite (STS) es una herramienta libre desarrollada por Spring Source,
basada actualmente en Eclipse 3.x, para construir aplicaciones empresariales
enriquecidas por los proyectos de Spring Source. Personalmente, hace mucho “dejé de
usar” Eclipse. Una de las principales razones es que STS no sólo incluye herramientas
para el desarrollo en lenguaje Java, sino también, para Spring, Groovy and Grails y
Scala. Además, si estás utilizando Spring Framework para desarrollar tus proyectos, es
una herramienta, que te va ayudar mucho, debido a que incluye muchos Wizards y la
configuración de archivos XML, comúnmente usados por Spring, de manera visual. No
me extenderé mucho por ahora, pero ya te darás cuenta del gran poder que tiene esta
herramienta, si has usado Eclipse anteriormente, no será nada extraño para ti. Suerte y
espero que te sirva!
MyJBreak
http://myjbreak.wordpress.com/
http://myjbreak.wordpress.com/
5
II. Descarga e Instalación de SpringSource Tool Suite:
Primero, ingresemos a la página de SpringSource (www.springsource.com). Hasta aquí
tenemos dos opciones: es normal que aparezca el aviso con el link (FREE Download)
para descargar el instalador del STS, tal como se muestra en la figura 1.1. Si no
aparece, no te preocupes, aquí te ofrezco el link directo:
http://www.springsource.com/landing/best-development-tool-enterprise-java
Te recomiendo que siempre tengas la última versión estable de STS. La última versión estable
es la 2.6.1. Sin embargo, para este tutorial, he utilizado la instalación del STS IDE 2.6.0.
1.1 Página Oficial de Spring Source, la página comercial del Spring Source (VMWare) es: http://www.springsource.com/
El segundo paso, será registrarnos para obtener el instalador del STS (Figura 1.2).
Personalmente, no me ha llegando ningún correo de Spring Source y tampoco spam,
sin embargo, si prefieres agregar un correo electrónico alterno para cuidar tu
información, EnBuenaHora!
http://myjbreak.wordpress.com/
6
Figura 1.2
Es hora de elegir que instalador descargaremos según nuestro sistema operativo. La
guía se ha realizado en Windows XP (32 Bits). Existen 2 opciones a elegir: descargar el
archivo zip con los proyectos o el instalador (exe). Personalmente, creo que es más
recomendable, instalar STS a través de un wizard, por lo que te aconsejo elegir alguno
de los 2 instaladores (32b o 64b) según tu caso, tal como se muestra en la figura 1.3.
Figura 1.3
http://myjbreak.wordpress.com/
7
Si has optado por descargar el instalador, obtendrás un archivo .exe como el siguiente.
Ejecútalo, y te trasladará al Wizard de Instalación (Figura 1.5).
Figura 1.4
Figura 1.5
http://myjbreak.wordpress.com/
8
Ahora sí, nos encontramos con lo más importante, así que mucho cuidado.
Paso 1 – Acuerdo de Licencia: Si quieres leer toda la licencia bien por ti, en cambio, si
quieres evitar perder el tiempo, dale clic al mensaje “I accept the terms of this license
agreement” (Imagino que alguno se ha encontrado con uno de estos anteriormente) y
clic en la opción Next.
Paso 2 – Directorio de Instalación: Elegimos el directorio (carpeta) en donde
instalaremos el SpringSource Tool Suite. Por defecto, aparecerá: ‘ C:\springsource’. Le
damos, siguiente (Next) y todo listo hasta aquí.
http://myjbreak.wordpress.com/
9
Paso 3 – Instalación de Paquetes: Que Bonito! El instalador no sólo te permitirá
instalar el SpringSource Tool Suite IDE, sino también, las herramientas: Apache Maven,
Spring ROO y Spring Source tc Server (Este es un servidor basado en Tomcat
desarrollado por SpringSource). La decisión la dejó en tus manos, sin embargo te
recomiendo instalar las 4 herramientas, es más, te obligo a hacerlo.
http://myjbreak.wordpress.com/
10
Paso 4 – Path de JDK: Hazlo rápido, dile a Spring cual es la ruta en donde se encuentra
tu JDK. Si no tienes instalado el JDK en tu PC, pues, qué esperas… Descargar JDK.
Seguimos con los next, next, next…
Paso 5 – Deja trabajar al Wizard: Anda relájate un poco, porque esto demorará máximo 10
minutos. Si quieres, puedes ir revisando mis otros posts .
http://myjbreak.wordpress.com/
11
Bueno, luego de tomarte tu tiempo revisando mis posts. Sólo te falta decidir si quieres
un acceso directo en tu menú de inicio y si deseas ejecutar el Spring Tool Suite. A lo
último, estás obligado a decirle que sí:
http://myjbreak.wordpress.com/
12
Y Whoalaaa!! Ya tienes tu SpringSource Tool Suite. Mira, si hasta verdecito es… Bueno
como verás, se te presenta un Dashboard con las noticias acerca de lo que están
haciendo mis comadres de SpringSource. Así como una serie de extensiones, parches y
plugins que serán de mucha utilidad en un futuro, y que luego compartiremos en este
espacio.
http://myjbreak.wordpress.com/
13
¿No es genial? Hasta aquí ha sido un gusto compartir contigo. Sin embargo, puedes
seguir mirando la guía, hay mucho por compartir aún, como la configuración de
Maven, Spring ROO y nuestro primer proyecto en Maven con JUnit 4. Finalmente,
invito a que esta herramienta sea tu opción por defecto.
Si te quedaste aquí, muchas gracias y hasta la próxima!!.
Aún sigo recomendandote que veas, al menos, lo de maven .
http://myjbreak.wordpress.com/
14
III. Configuración de Maven:
Si es tu segunda vez leyendo esta guía (sabía que volverías ). Y si te quedaste hasta el
final la primera vez, eres muy inteligente. A veces es necesario, tener instalado Maven
“completamente” para poder utilizarlo en consola, ya verás que también nos servirá
luego. Comenzemos!
Hablemos de Maven 2.0…
¿Qué es Maven? Sinceramente, no sabría como explicártelo muy bien porque aún no
lo conozco a la perfección, pero aquí te va algunas ideas básicas. Si alguien ha utilizado
los antiguos archivos ‘Makefile’ en algún lenguaje estructurado (4GL) o la herramienta
Apache Ant, se llevará una idea de lo que es.
Maven es una herramienta que nos permite gestionar y describir nuestros proyectos
de software a través de un modelo estándar. En conclusión, es una herramienta que
automatiza muchos procesos en la construcción de software que usualmente no
quisiéramos hacer - algunos dicen que la flojera es la madre de todas las invenciones,
¿Será el caso?
Bueno, cuando comenzamos un proyecto Java lo primero en que pensamos es crear
una estructura de directorios o paquetes, con un espacio para nuestro código fuente,
archivos de configuración, tests, librerías, etc. Sin embargo, cuando generamos un
proyecto Java sólo tenemos una carpeta en donde tenemos que ingresar, todo lo
registrado. Mientras, más grande la aplicación, tarea difícil es la de mantener el orden,
y si careces de esta cualidad, mucho peor. A veces, no te preguntas, si en realidad los
archivos de configuración como los XML o tus test deberían registrarse en el mismo
paquete en el que se encuentra tu código fuente. Maven, de manera simple, nos crea
una estructura de paquetes o directorios comprensible, flexible y estandarizada, con
espacio para lo que indicábamos: nuestro código fuente, archivos de configuración,
.class, los jars/wars, etc.
http://myjbreak.wordpress.com/
15
Arquitectura Maven Simple
Otro factor es, ¿Qué aplicación no utiliza jar externos? Me refiero a los drivers de base
de datos, las librerías de Spring, log4j, etc. ¿No es problemático copiar todos estas
librerías a un directorio, y luego incluirlas a tu proyecto? ¿Alguna vez te ha pasado que
el proyecto pesa demasiado, y no debido a su ‘gran’ código fuente, sino más bien, a las
diferentes librerías que tiene? ¿No es un problema pasar los proyectos de fin de ciclo
por correo?
En Maven, no se trabaja con el término de manejo de librerías, sino se habla de una
gestión de dependencias. Maven tiene un repositorio en donde almacena todos
nuestros componentes y librerías de terceros (Spring,Struts,JUnit,etc) de una manera
ordenada, agrupándolos por el nombre de las empresas, los artefactos y las versiones.
Es importante señalar, que el repositorio es comúnmente almacenado en un
directorio local. Sin embargo, se puede utilizar un directorio compartido en un servidor
o intranet local, y lo más interesante, si no encuentra la librería en nuestro repositorio
local, es capaz de buscarla y descargarla desde Internet. Mira tú…ya hablaremos de
esto más adelante.
Finalmente, hasta antes de que existieran estas herramientas, no había una manera
“elegante” de eliminar los archivos de compilación, compilar, ejecutar test antes de
compilar, empaquetar, generar los javadoc, etc. Maven implementa muchas de estas
http://myjbreak.wordpress.com/
16
opciones a través de simples comandos mvn.
Al hablar de comandos, te imaginarás que maven es sólo una consola de líneas de
comando. Estás en lo cierto, no tiene interface gráfica ni nada parecido, sin embargo,
gracias a nuestro querido SpringSource Tool Suite (STS) podemos ejecutar muchas de
sus operaciones desde la IDE. Espero que hayas comprendido lo que proporciona
Maven, si estás muy interesado, invito a que revises la última parte del tutorial, en el
que crearás tu primer proyecto con Maven desde STS, pero eso sí, luego de haber
terminado su configuración.
Let’s Do It! Hablábamos de líneas de comando. Lo primero que tienes que configurar
para utilizar maven a través de tu consola (cmd), es registrar una variable de entorno
de la siguiente manera:
1. Para generar una variable de entorno dale clic derecho a Mi PC e ingresa a
Propiedades > Opciones Avanzadas > Variables de Entorno. Si no te quedo
claro, puedes revisar este tutorial.
2. En Variables del Sistema, le daremos clic a Nueva.
http://myjbreak.wordpress.com/
17
3. En este caso, registraremos una variable con el nombre ‘M2_HOME’ en
referencia a Maven, y con el valor ‘C:\springsource\maven-2.2.1.RELEASE\’, si
es que instalaste Maven en la ruta por defecto que te brindo el wizard, y si no,
ya sabes que hacer .
4. Luego, agreguemos nuestra variable registrada, a la variable ‘PATH’ para que
pueda estar ubicada en memoria y utilizada en cualquier ubicación de nuestra
línea de comandos. No te olvides: %M2_HOME%\bin
http://myjbreak.wordpress.com/
18
5. Probemos si funciona Maven, abriendo un procesador de comandos (Windows
cmd). Escribamos la función mvn –version:
6. Si te sale el siguiente mensaje, es porque no tienes configurada la variable
JAVA_HOME que indica la ruta de instalación de Java. Si no obtuviste este
mensaje, y te salió la versión del Maven (como en el paso 8), puedes pasar al
paso 9.
7. Primero, cierra la consola y luego registrar una variable de entorno para tu JDK,
como muestro a continuación:
http://myjbreak.wordpress.com/
19
8. Listo! Ejecuta de nuevo el comando mvn –version:
9. Ahora sí, vamos a darle a Maven nuestro primer comando para que se instale y
configure nuestro repositorio local. Escribimos el comando mvn install y damos
ENTER!
10. Si estás en Windows XP, dirígete a la siguiente ruta ‘C:\Documents and
Settings\XXXXX(Usuario)’. En cambio, si utilizas Windows 7, ve a
‘C:\Users\XXXXX(Usuario)’. Podrás observar que Maven ha creado tu
repositorio local y lo ha nombrado .m2. Aquí se almacenarán tus componentes
y los de terceros como explicamos anteriormente.
http://myjbreak.wordpress.com/
20
IV. Configuración de Spring ROO (Línea de Comandos):
Si aún no te has enterado las ventajas del proyecto Spring ROO, sugiero que veas el
siguiente post ‘¿Cómo crear tu aplicación en pocos minutos con Spring ROO?’.
Este capítulo es rápido, y no es muy necesario, sin embargo si has visto las bondades
que tiene Spring ROO, te animo a configurarlo de una buena vez.
Uno de los proyectos que descargarte fue Spring ROO:
http://myjbreak.wordpress.com/
21
Bueno es hora de configurar Spring ROO para que pueda ser utilizado por consola. Si
viste el capítulo de configuración de Maven, te será muy fácil hacer lo siguiente. Viste,
sabía que finalmente tendrías que revisar toda la guía ¬¬.
1. Registraremos una variable de entorno, indicado un nombre ‘ROO_HOME’ y la
ruta de instalación de Spring ROO.
http://myjbreak.wordpress.com/
22
2. De la misma manera, modificamos la variable ‘PATH’ y registramos nuestra
variable creada de la siguiente manera: %ROO_HOME%\bin
http://myjbreak.wordpress.com/
23
3. Finalmente, abrimos una instancia del símbolo del sistema (cmd) y ejecutamos
el comando roo. Si todo sale ok, deberá aparecer la consola de Spring ROO:
http://myjbreak.wordpress.com/
24
V. Nuestro primer proyecto con Spring Tool Suite y Maven:
Llegamos al final, y que bueno para tí, como para mí y como para mi sistema circular
que estemos cerrando. Recomiendo que no seas tan pegado a la guía, prueba y
mucho, pregúntate siempre por qué, resuelve tus dudas, y por último, escribe tus
propios ejemplos.
Comencemos creando un proyecto Maven:
1. En el Explorador de Paquetes, damos clic derecho en New > Other…
2. En la caja de texto (filters), escribimos ‘maven’. Se mostrará una lista, en donde
seleccionaremos la opción Maven Project. Finalmente, damos clic a Next.
http://myjbreak.wordpress.com/
25
3. En la siguiente ventana, activaremos la opción: ‘Create a simple project’.
Seguimos con los Next.
4. Es tiempo de darle un nombre (artefact-id) a nuestro proyecto, una versión y
un group id (relacionado con el nombre de la empresa). Pueden guiarse del
siguiente ejemplo:
http://myjbreak.wordpress.com/
26
5. Finalmente, dale clic en Finish y se creará tu proyecto Maven.
6. Antes de seguir, te sugiero que revises ciertas configuraciones. Para eso, anda a
la configuración de tu proyecto de la siguiente manera:
http://myjbreak.wordpress.com/
27
7. Si nos fijamos en la pestaña Source, encontraremos los folders o directorios de
la arquitectura Maven de nuestro proyecto. Si te centras en los foldes de
recursos (resources), se está habilitando la opción de excluir cualquier archivo
en estas carpetas. Vamos a deshabilitar esta opción, ya que sólo se debería
excluir a los archivos .java.
8. Elegimos la opción Excluded del folder mi-primer-proyect-
maven/src/main/resources y le damos clic a la opción Edit… Aparecerá una
ventana, en esta elegiremos el patrón de exclusión y lo editaremos de la
siguiente manera. Aplicar lo mismo para el folder mi-primer-proyect-
maven/src/test/resources. Listo, problema solucionado, ahora Maven si podrá
reconocer tus archivos de configuración, etc…
http://myjbreak.wordpress.com/
28
Hasta ahora sólo hemos configurado el proyecto, sin embargo, sería muy bueno ver
cómo funciona la gestión de dependencias. En la segunda parte de este capítulo,
vamos a generar una dependencia a la librería de JUnit 4, asimismo, veremos si ¿es
verdad o no que Maven puede traerte la librería desde internet? Sigamos…
Bueno, aún no hemos hablado de ese archivo, que aparece solitario en nuestro
proyecto, llamado pom.xml. ¿Qué es el pom.xml? El POM (Project Object
Management) es el “corazón” de nuestro proyecto Maven (¿a poco creías que Maven
lo sabía todo porque sí?, no te preocupes en su momento, lo creí también). En este
“simple” fichero XML se coloca la información acerca de las dependencias, los
repositorios, plugins, versiones, etc…
http://myjbreak.wordpress.com/
30
En realidad, hasta ahora no tiene ningún valor sobre el proyecto. Sin embargo, vamos a
realizar algunas modificaciones. Copia el siguiente código a tu pom.xml.
pom.xml.txt
En este caso, como indicamos al inicio, la parte azul indica que hemos agregado una
dependencia a la librería de JUnit siguiendo las mismas convenciones de Maven.
Asimismo, como vemos en la parte roja, hemos agregado los repositorios de Spring
Source, recordemos que en caso nuestra aplicación no encuentre la librería en nuestro
repositorio local (.m2), buscará y descargará la misma en alguno de estos repositorios.
NOTA: Los repositorios de Spring Source, no son los únicos que existen en internet.
Existen otros como la Maven Central de Apache Maven, el repositorio Maven de
Nexus por Sonatype, etc. Sin embargo, a mayor repositorios configurados, más lento
se vuelve Maven.
http://myjbreak.wordpress.com/
31
Listo, si hicieron lo que indique, y le dieron guardar a su archivo pom.xml. Podrán
visualizar en la consola que Maven estuvo “jugando” con alguna de sus operaciones,
en este caso, ha buscado la libraría de JUnit en los repositorios de Spring Source y ha la
descargado. Si no visualizas la consola Maven, puedes abrir una en Open Console…
También podemos comprobar que hace realizado la referencia de la siguiente manera.
En la vista Package Explorer, veremos que se ha creado un folder referencial llamado
Maven Dependencies, aquí podemos visualizar que tenemos el JUnit enlazado en
nuestro proyecto. Asimismo, si nos dirigimos a nuestro repositorio local (.m2) veremos
que la librería se encuentra allí, por lo tanto, en un segundo proyecto ya no será
necesario que Maven descargue la librería. Ya no tienes que pasarle a tus amigos la
lista de librerías que usaste, sólo pásales tu proyecto Maven o tu pom.xml y listo!
http://myjbreak.wordpress.com/
32
Para finalizar, comprobaremos que si tenemos la referencia a la librería de
JUnit, desarrollando un pequeño test:
Creamos una clase llamada ‘MiPrimerTest’. Luego, extendemos a la clase de
JUnit: ‘TestCase’ para identificar a la clase como una prueba unitaria.
Finalmente, escribimos un método (ojo! Tiene que comenzar con test el nombre
del método sino JUnit no lo reconocerá como tal) y realizamos una comprobación
‘dummy’(tonta).
Hasta ahora todo bien, el STS no nos ha tirado un problema tal como que no
existe tal clase, etc. Eso quiere decir, que pues sí, finalmente la librería está en
nuestro proyecto. OK! No nos emocionemos y pasemos al paso final. Correrá el
test? Para eso ejecutamos el test, como lo hacíamos con una aplicación, sin
embargo elegimos la opción JUnit Test.
http://myjbreak.wordpress.com/
33
y…………………………………………. TARANN!!
Que mejor que ver un Test en verde! Eso es todo por ahora!!
No se olviden de visitar su nueva doctrina religiosa: http://myjbreak.wordpress.com/