Despliegue aplicación Spring-Boot en Openshift

En este tutorial vamos a explicar como se debe desplegar una aplicación Spring-Boot en Openshift. La aplicación correrá en un tomcat y utilizará como Base de Datos H2.

Creamos la aplicación en OpenShift. Para ello:
Paso 1: Nos registramos en https://www.openshift.com/
Paso 2: Creamos una aplicación que contenga un Tomcat 7 (JBoss EWS 2.0).

Instalamos y configuramos las Openshift Client Tools
Paso 1: Lo primero que debemos hacer es instalar Ruby, la versión que recomienda Openshift es la 1.9.3.
http://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-1.9.3-p551.exe
(Cuando estamos instalando Ruby debemos marcar la opcion que dice Add Ruby executables to your PATH, para que se añada al Path del sistema.)
Para saber si tenemos Ruby añadido correctamente al Path, abrimos un terminal y ejecutamos:

ruby –v.

Paso 2: Instalamos la última versión de Git.
https://github.com/msysgit/msysgit/releases/download/Git-1.9.5-preview20150319/Git-1.9.5-preview20150319.exe
para comprobar si git también está bien instalado poedemos ejecutar:

git --version.

Paso 3: Instalamos las Client Tools (Openshift rhc).

//Para instalar las rhc sólo debemos escribir en nuestro terminal:		
gem install rhc
//A continuación, configuramos con:	 
rhc setup

Nos pedirá logarnos con nuestras credenciales. Al introducirlas, si son correctas el sistema de configuración nos indicará que va a crear un Token para que podamos acceder a OpenShift sin necesidad de colocar nuestras credenciales de acceso, este Token se guardará en nuestra carpeta de usuario en una carpeta llamada .openshift.

Generando War
Usando maven se puede hacer directamente por la consola con:

mvn clean package

Desplegando WAR en OpenShift
Paso 1: Primero debemos crear un SSH public key para poder acceder al servidor por ssh. Se crean desde la propia consola web de Openshift. O usamos la que nos ha creado por defecto openshift en nuestro directorio de usuario cuando se instaló rhc.
Si queremos crear una nueva podemos crearla con el Putty Key Generator. Luego se debe añadir en el openshift a través de la consola web.
Paso 2: Descargamos el repositorio git.
Paso 3: Borrar la carpeta src y el pom.xml
Paso 4: Colocamos nuestro WAR en la carpeta webapp
Paso 5: Editar el archivo server.xml que está en .openshift/config/server.xml. Buscamos el siguiente conector y en el redirectPort pone 8443, le quitamos el 8 y guardamos.
Paso 6: Al archivo .openshift/config/context.xml le añadimos la siguiente Valve:

< Valve className="org.apache.catalina.valves.RemoteIpValve" protocolHeader="x-forwardedproto"/>

Paso 7: Hacemos commit y push
Paso 8: Reiniciamos el servidor.

Base de datos H2
Se debe colocar el fichero de bd en app-root/data y darle permisos de lectura y escritura.

i18n con Spring Boot

Paso 1: Añadir los properties con las keys en src/main/resources/ uno por cada idioma tal que así:
messages.properties (este será el de por defecto)
messages_es.properties

Paso 2: Hay que configurar la aplicación para que la request obtenga el locale. Para ello se pueden añadir estos beans:

	@Bean
	public LocaleResolver localeResolver() {
	    return new CookieLocaleResolver();
	}
	@Bean
	public LocaleChangeInterceptor localeChangeInterceptor() {
		LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
		lci.setParamName("lang");
		return lci;
	}
	@Override
	public void addInterceptors(InterceptorRegistry registry) {
		registry.addInterceptor(localeChangeInterceptor());
	}

Paso 3: Modo de uso.
Desde un controller de Spring basta con inyectar un MessageSource y ya podríamos usarlo.

        .....
	@Autowired
	private MessageSource messageSource;

	@RequestMapping(value = "/list", method = RequestMethod.GET)
        public String listItems(Model uiModel, Pageable page, HttpServletRequest request){
             String msg = messageSource.getMessage(request.getParameter("key.successMessage")
                                                     .toString(),null,LocaleContextHolder.getLocale());
             ....
        }
        ....

Desde el front-end con thymeleaf bastaria con usar el #{key.successMessage}

< html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
	xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"
>
....
< span th:text="#{key.successMessage}">
....

Crear una aplicación Spring-Boot

Paso 1 – Instalar maven
Se descarga la version de maven (3.0.5 o superior en este caso). Se mete el directorio bin al path.

Paso 2 – Instalar el wraper de maven para spring-boot. Ver https://github.com/takari/maven-wrapper
Se instala con este comando de maven: mvn -N io.takari:maven:wrapper
Luego para compilar se podría hacer (en lugar de mvn clean install):
./mvnw clean install or ./mvnw.cmd clean install

Paso 3 – Crear proyecto boot inicial.
Consiste en, primero, crear aplicacion en esta url: http://start.spring.io/
Y luego, montar aplicacion:

mvn eclipse:eclipse

Paso 3 – Correr la aplicación.
Dos opciones para lanzar la aplicación pueden ser:

//Con maven:	
mvn spring-boot:run. 

//Construyendo el jar:		
mvn clean package 
//Y haciéndolo correr con:	
java -jar target/nombre_jar.jar

Crear una aplicación con gvNIX

gvNIX está basado en Spring Roo y te permite generar aplicaciones web java de manera muy rápida a partir de un esquema de base de datos. http://www.gvnix.org/

Instalación de gvNIX

Comandos a ejecutar para la creación de un proyecto

//Primero se configura la BD de la que luego se hará ingeniería inversa...
jpa setup --database MYSQL --provider HIBERNATE --databaseName mi_base_datos --hostName mi_ip --userName mi_usuario --password mi_contraseña

//Luego se puede comprobar si se ha realizaco la conexión bien
database introspect --schema nombre_de_mi_esquema

// si te dice que no encuentra el driver puedes instalarlo así
addon search mysql
//te deberia salir una lista con los drivers que puedes instalar para a continuación
addon install id --searchResultId xx    
//xx sería el codigo del driver mostrado en el listado que saca el anterior comando...

//En mi caso me dió problemas y el de mysql no me lo instaló bien así que lo instale a mano.
//Para ello me lo descargue y lo instalé con el siguiente comando:
osgi start --url file:///C:\\mysql-connector-java-5.1.18.jar

//Ahora ya se puede crear las entidades a partir de la BD.
database reverse engineer --schema nombre_de_mi_esquema --package ~.domain --includeTables "tab_*"

//se crea el negocio y la presentación para spring mvc
web mvc setup
web mvc all --package ~.web
web mvc finder all

//añadimos la internacionalización
web mvc language --code en
web mvc language --code es

//Seleccionamos el nivel de log
logging setup --level INFO

Hasta aquí ya tendriamos un el proyecto funcionando, podriamos ejecutarlo y ver como se pueden hacer las tareas crud con las pantallas con los estilos por defecto de gvNIX. Ver guia de estilos gvNIX.

Si quisiéramos cambiar la presentación para usar por ejemplo bootstrap deberiamos seguir a continuación los siguientes pasos:

// Añadimos jQuery al proyecto
web mvc jquery setup

// Instalamos Bootstrap
web mvc bootstrap setup

// Instalamos el componente datatables
web mvc datatables setup 

// Añadimos JQuery a todos los archivos
web mvc jquery all

// Se crea los datatables de todos los listados
web mvc datatables all

// Se actualiza bootstrap para que importe los ficheros datatables
web mvc bootstrap update

//Instalamos el security
security setup

// Seactualiza bootstrap para que importe los ficheros del security
web mvc bootstrap update

// Instalamos reports en el proyecto
web report setup

// Creamos un report 
web report add --controller ~.web.SampleController --reportName samplereport

Notas:
web mvc bootstrap setup
Este comando importará e instalará todos los recursos necesarios para utilizar bootstrap. Además, modificará la estructura de algunos tagx existentes para que funcionen correctamente con Bootstrap y modificará todas las vistas de la aplicación para que utilicen los tags de JQuery.

web mvc bootstrap update
Este comando permite regenerar de forma correcta todos los componentes importados por Bootstrap. En caso de una modificación incorrecta de estos componentes, podremos regenerarlos para que vuelvan a su estado inicial.



Documentación oficial versión 1.4.1

Eliminar Spring Roo con eclipse

Para quitar Spring Roo de un proyecto que lo esté utilizando sin perder las funcionalidades que se tienen se deben seguir los siguientes pasos:

Paso 1: Eliminación de los aspectos del proyecto
Para ello seleccionamos el proyecto en el IDE -> pulsamos el botón derecho del ratón -> en el menú contextual seleccionamos la opción Refactor/Push In… -> tras pulsar el botón “OK” -> se eliminarán del proyecto las clases de los aspectos.

Paso 2: Eliminación de las anotaciones de las clases del proyecto.
Se realiza reemplazando las anotaciones de Spring Roo. Para ello, iremos a la opción del menú Search/Search/File Search -> en el campo con título “containing text” insertaremos la expresión regular “\n.*[@\.]Roo[^t_]+?.*$” (sin comillas) -> seleccionaremos las check: “Case sensitive” y “Regular expression” -> a continuación, pulsaremos el botón “Replace…” -> y, para finalizar, se mostrará un ventana que solicitará el nuevo texto, en donde pulsaremos el botón de aceptación.

Paso 3: Eliminación referencias del pom.
Se eliminan a mano todas las dependencias a Spring ROO existentes en el pom.xml.

Paso 4: Corregir errores del eclipse
Aparte es posible que haya que corregir algun error en el codigo generado en las clases con relaciones muchos a muchos. Tales como:
– crear método ‘getSerialversionUID’ en las clases,
– pasar los constructores a public
– quitar la propiedad ‘final’ de la clase
– quitar los ‘implements serializes’ repetidos
– añadir los métodos ‘hashcode’ y ‘equals’
– …
Se trata de errores que se solucionan rapido porque los va a ir sacando el eclipse.

Tras todo eso puedes probar tu proyecto ejecutando
mvn clean install jetty:run

Crear aplicación a partir de la Base de Datos con Spring Roo

Paso 1: Instalar Spring Roo
– En primer lugar necesitas tener instalado Java y Maven.
– A continuación te descargas Spring Roo de la página oficial.
– Se descomprime en un directorio y se añade al path. En windows seria añadir en el path $ROO_HOME\bin siendo $ROO_HOME el directorio donde lo has descomprimido.
– Para comprobar que se ha instalado correctamente podemos ejecutar directamente en la consola el siguiente comando.
roo quit
Si todo va bien debería mostrarnos el logo de Spring Roo.

Paso 2: Crear un proyecto de Spring Roo
Se puede crear de distintas formas:
– Con el STS se puede crear un proyecto de Spring Roo como tal.
– Con el eclipse también se podría añadiendo el plugin de Spring Roo.
– Y por último también podriamos utilizar directamente la consola para su creación.

De esta forma, los comandos para la creación de un proyecto a partir de una BD Mysql serían:

//Primero se configura la BD de la que luego se hará ingeniería inversa...
jpa setup --database MYSQL --provider HIBERNATE --databaseName nombre_de_mi_esquema --hostName ip_de_mi_mysql --userName mi_usuario --password mi_contraseña

//Luego se puede comprobar si se ha realizaco la conexión bien
database introspect --schema nombre_de_mi_esquema

// si te dice que no encuentra el driver puedes instalarlo así
addon search mysql
//te deberia salir una lista con los drivers que puedes instalar para a continuación
addon install id --searchResultId xx    
//xx sería el codigo del driver mostrado en el listado que saca el anterior comando...

//En mi caso me dió problemas y el de mysql no me lo instaló bien así que lo instale a mano.
//Para ello me lo descargue y lo instalé con el siguiente comando:
osgi start --url file:///C:\\mysql-connector-java-5.1.18.jar

//Ahora ya se puede crear las entidades a partir de la BD.
database reverse engineer --schema nombre_de_mi_esquema --package ~.domain --includeTables "tab_*"

Por último sería añadir el resto del negocio y la presentación. Para ello pongo dos ejemplos: MVC y JSF.

//Usando Spring MVC
web mvc setup
web mvc all --package ~.web

Usando JSF
web jsf setup --implementation --library --theme
web jsf all --package ~.web

Como nota decir que se lía algo con las tablas con clave primaria múltiple (hay que quitar unos errores que salen en los ficheros *.aj que crea).

Puedes probar a ejecutar el proyecto simplemente con la instrucción de manve
mvn clean install jetty:run

Documentación:
Ejemplo de creación de un proyecto con STS. Ver
Ejemplo de creación de un proyecto con el plugin de eclipse para Spring Roo. Ver

Borrado de documentos en Alfresco

Por un lado hay que tener en cuenta que los documentos en alfresco no se borran realmente hasta que el usuario que los ha borrado o el administrador vacia la papelera de reciclaje. Ésta se vacia en la sección User Profile.

Por otro lado se debe tener en cuenta que lo que se hace es un borrado lógico. De tal forma que aunque no podamos verlos desde el interfaz de Alfresco, no se han borrado físicamente del disco. Se mantienen dentro del contentstore en estado huérfano ya que no quedan referencias a él en la base de datos.

Ahora bien, en Alfresco se ejecutan una serie de procesos automáticos de mantenimiento. Se definen en el fichero scheduled-jobs-context.xml que se apoya en el repository.properties para configurarse (localizables ambos en /Alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/). Entre ellos nos encontramos con:

– contentStoreCleanerTrigger: es el encargado de lanzar el bean contentStoreCleaner (definido en el content-services-context.xml) que se encarga de borrar los contenidos huérfanos del contentstore. Por defecto se ejecuta a las 4:00 AM cada día (0 0 4 * * ?). El parámetro system.content.orphanProtectDays establece el número mínimo de días que el contenido debe ser huérfano antes de poder eliminarlo, el valor predeterminado es de 14 días. Es decir, el documento permanecera 14 días en estado huérfano en el contentstore hasta que por fin la tarea Cleaner lo pase al contentstore.deleted.

Nota 1: Si la propiedad system.content.eagerOrphanCleanup está a true los documentos se moverán al directorio contentstore.deleted sin necesidad de la ejecución del contentStoreCleaner.

Nota 2: El contentstore.deleted es responsabilidad del administrador de borrarlo para liberar espacio.

Scheduled jobs
Content store configuration

Máquinas virtuales de Bitmani para desarrollo web

Bitnami es una biblioteca de aplicaciones de servidor populares y entornos de desarrollo que se pueden instalar con un solo clic. Es tan sencillo como descargarse una máquina virtual ya preparada para VMware o Virtual Box con los servidores que deseemos. Además, luego le puedes ir añadiendo módulos que vayas necesitando.

A continuación se muestra una guía de comandos rápida de uso para montar un servidor Tomcat con java 1.7 y nodejs.

Arrancar y parar Tomcat
-----------------------
	Todos los servicios se arrancan y paran de la siguiente forma:
		sudo /opt/bitnami/ctlscript.sh status
		sudo /opt/bitnami/ctlscript.sh start tomcat
		sudo /opt/bitnami/ctlscript.sh stop tomcat
		sudo /opt/bitnami/ctlscript.sh restart tomcat

Cambiar el teclado inglés
-------------------------
	Por defecto la máquina virtual viene configurada con teclado en inglés. 
	Para cambiarlo sería:
		sudo dpkg-reconfigure keyboard-configuration

Activar SSH
-----------
	Por defecto el servicio ssh viene desactivado. Se puede activar así:
		sudo mv /etc/init/ssh.conf.back /etc/init/ssh.conf
		sudo start ssh

Configuración de red en VMware
------------------------------
	Tarjetas de red con el VMware Bridge Protocol desactivado.
	Tarjetas de red con ip y dns automático.
	Network Adapter de la máquina virtual en modo brighed.
	
Configurar la red manualmente.
------------------------------
    Hay que editar el archivo interfaces, por ejemplo así:

	1- Editamos la interface de la tarjeta de red. En este caso la eth0 
		vi /etc/network/interfaces 
		
		Dentro del archivo debes buscar:
		auto eth0
		iface eth0 inet dhcp
		
		y sustituirlo por lo que corresponda en cada caso:

		auto eth0
		iface eth0 inet static
		address 192.168.1.40
		netmask 255.255.255.0
		gateway 192.168.1.1
		network 192.168.1.0
		broadcast 192.168.1.255
	
    2- Ahora editamos los DNS:
		vi /etc/resolv.conf
		
		nameserver = 8.8.8.8
		nameserver = 8.8.4.4 
	
	3- Por ultimo reiniciamos el servicio de red:
		/etc/init.d/networking restart 
		
Cambiar la jdk
--------------
	Descargar la deseada, en este caso queremos pasar de la 1.8 que nos traia 
	la máquina a la 1.7 así que descargamos al 1.7 de aquí
		http://www.oracle.com/technetwork/es/java/javase/downloads/jre7-downloads-1880261.html
		
	Lo más rápido es reemplazar el directorio /opt/bitnami/java por el nuevo. 
	Se puede hacer por consola tal que así:
		sudo mv /opt/bitnami/java /opt/bitnami/java8
		sudo mv /tmp/java /opt/bitnami/java
		sudo chown -R root /opt/bitnami/java	  (cambiar el usuario)
		sudo chown -R :root /opt/bitnami/java	(Cambiar el grupo)
		sudo chmod -R 777 /opt/bitnami/java
	
Añadir un módulo nuevo (Ej: nodejs)
-----------------------------------
	Descargarse de la página el *.run 
		https://bitnami.com/stack/nodejs/installer#linux
	Se puede utilizar para ello el comando wget si se quiere.
		wget https://bitnami.com/..................../bitnami-nodejs-5.4.0-0-linux.run
	
	Darle permisos:
		chmod 755 bitnami-nodejs-5.4.0-0-linux.run
		
	Ejecutarlo y seguir los pasos de instalación
		sudo /bitnami-nodejs-5.4.0-0-linux.run

Apagar la máquina virtual
-------------------------
	sudo poweroff

DOC:
https://wiki.bitnami.com/Virtual_Appliances_Quick_Start_Guide


https://bitnami.com/stack/tomcat/virtual-machine

Ver certificados de una dirección https con HttpsURLConnection

Ver HttpsURLConnection

Ejemplo:

...
     URL url = new URL(HTTPS_DIRECCION_WEB);
     HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
     conn.connect();
     Certificate[] certs = conn.getServerCertificates();

     if (conn != null) {
          for (Certificate cert : certs) {
               log.info("Cert Type: " + cert.getType());
               ....
          }
     }
...

Connectar a una BD Open Office (*.odb) usando jdbc

En primer lugar se debe descomprimir el archivo odb. Esto se puede realizar a mano o automatizarlo, a mano podría ser de la siguiente manera:

1. Renombra tu fichero.odb a fichero.zip
2. Extrae su contenido.
3. Ahora tu puedes ver los archivos: backup, data, script, properties en el directorio creado de la BD.
4. Renombra los archivos a: NOMBRE_BD.data, NOMBRE_BD.backup, NOMBRE_BD.script, NOMBRE_BD.properties
5. La cadena de conexión a esa BD sería: jdbc:hsqldb:file:DIRECCION_FISICA_A_LA_BD/NOMBRE_BD

Ejemplo de uso:

...
Class.forName("org.hsqldb.jdbcDriver");
String cadenaConexion = "jdbc:hsqldb:file:DIRECCION_FISICA/NOMBRE_BD";
Connection con =  DriverManager.getConnection(cadenaConexion,"sa","");
Statement statement = con.createStatement();
ResultSet rs = statement.executeQuery("SELECT * FROM tabla");
while (rs.next()) {
   System.out.print("ID: " + rs.getString("ID"));
}
con.close();
...