Spring tool suite instalacion

http://myjbreak.wordpress.com/

1

Spring Tool Suite

Manual de Instalación 1.0.0


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


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://agile-peru.net/

http://agile-peru.net/

http://joedayz.org/web/


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://www.springsource.com/products/springsource-tool-suite-download



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://www.springsource.com/

http://www.springsource.com/landing/best-development-tool-enterprise-java

http://www.springsource.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


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


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í.


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.


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://www.oracle.com/technetwork/java/javase/downloads/index.html


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í:


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.


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 .


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://maven.apache.org/guides/index.html


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


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://luauf.com/2008/07/06/administrar-variables-de-entorno-en-windows/


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


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:


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.


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/2011/06/02/spring-roo-ingenieria-reversa/


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.


22

2. De la misma manera, modificamos la variable ‘PATH’ y registramos nuestra

variable creada de la siguiente manera: %ROO_HOME%\bin


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:


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.


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:


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:


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…


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…


29

Es hora de conocer nuestro pom.xml.


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://ebr.springsource.com/repository/app/

http://ebr.springsource.com/repository/app/

http://search.maven.org/#browse

http://nexus.sonatype.org/

http://nexus.sonatype.org/


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!


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.


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/
