Servidor de aplicaciones Jboss EAP 6.3.0

Transcripción

1 Tutorial Servidor de aplicaciones Jboss EAP Mario Humberto Tiburcio Zúñiga 2015

2 Red Hat Jboss Enterprise Application Platform JBoss es un servidor de aplicaciones Java EE de código abierto implementado en Java puro. Al estar basado en Java, JBoss puede ser utilizado en cualquier sistema operativo para el que esté disponible la máquina virtual de Java. JBoss Inc., empresa fundada por Marc Fleury y que desarrolló inicialmente JBoss, fue adquirida por Red Hat en abril del El proyecto se nutre de una red mundial de colaboradores. Los ingresos de la empresa están basados en un modelo de negocio de servicios. JBoss implementa todo el paquete de servicios de JEE [Referencia Wikipedia]. En este pequeño tutorial se explica el procedimiento de instalación de Jboss en Ubuntu, incoporando algunas pautas para su configuración así como los códigos fuentes de ejemplos de programación de EJB Stateless, EJB Stateful y WebServices. También se incorporan ejemplos de programas cliente en Java y Android que consumen componentes EJB y WebServices montados en el servidor.

3 Instalación del servidor de aplicaciones Jboss EAP Descargue el archivo jboss-eap zip ( y desde terminal cópielo como root a un directorio de trabajo: cp jboss-eap zip /root/trabajo 2. Cámbiese al directorio de trabajo y descomprima el jboss-eap zip: cd /root/trabajo unzip jboss-eap zip Nota: Verifique que aparezca el directorio jboss-eap Mueva el directorio jboss-eap-6.3 al directorio /usr/local: mv jboss-eap-6.3 /usr/local 4. Modifique el archivo /etc/profile agregando la variable de ambiente JBOSS_HOME como se indica a continuación: export JBOSS_HOME=/usr/local/jboss 4. Cámbiese al directorio /usr/local y cree un enlace simbólico de nombre jboss que apunte al directorio jboss-eap-6.3: cd /usr/local ln -s /usr/local/jboss-eap-6.3 /usr/local/jboss 5. Modifique el archivo de configuración standalone.xml para cambiar el puerto de escucha por defecto del JBoss: Para editar el archivo teclee: nano /usr/local/jboss-eap-6.3/standalone/configuration/standalone.xml Modifique en el archivo la línea siguiente (el puerto por defecto es 8080): <socket-binding name="http" port="8080"/> De manera que quede por ejemplo así (el nuevo puerto es 8888): <socket-binding name="http" port="8888"/> Modifique también la dirección local sustituyéndola por la IP o el nombre de la máquina donde se está instalando el Jboss.

4 6. Reinicie sesión y desde terminal con privilegios de root inicie el servicio Jboss con la orden siguiente: $JBOSS_HOME/bin/standalone.sh El servicio se habrá iniciado satisfactoriamente si aparece en la terminal un mensaje similar al siguiente: 22:26:31,125 INFO [org.jboss.as] (Controller Boot Thread) JBAS015874: JBoss EAP GA (AS Final-redhat-19) inició en 6605ms - Inició 151 de 189 servicios (56 servicios son perezosos, pasivos o por demanda) Nota: Cuando se requiere parar el servicio de Jboss, sólo pulse CTRL-C en la terminal donde fue invocado. 7. Tecleé en un navegador el URL y observe si se despliega una página similar a la siguiente:

5 8. Si se trata de acceder a Administration Console, será necesario crear una cuenta de administrador y una cuenta de usuario de la aplicación. Para esto ejecute en terminal con privilegios de root el comando: Deberá verse algo similar a lo siguiente: $JBOSS_HOME/bin/add-user.sh Qué tipo de usuario desea agregar? a) Usuario de administración (mgmt-users.properties) b) Usuario de la aplicación (application-users.properties) (a): Nota: Debe escribir a para una cuenta de administrador o una b para una cuenta de usuario de la aplicación. Después sólo debe contestar adecuadamente a las preguntas que se le soliciten hasta que las cuentas se hayan creado. 9. Trate ahora de ingresar como administrador a la Consola de Administración del Jboss dando clic en el enlace Administration Console en la página de inicio mostrada en el paso 7. Tecleé el nombre de usuario y contraseña que se le soliciten. Si todo es correcto, se mostrará un despliegue similar al siguiente:

6 Pasos para hacer el deploy (montaje) de los EJB Stateless, EJB Stateful y WebServices en el servidor de aplicaciones JBoss 1. Para compilar los componentes y clientes cuyo código se proporciona en este tutorial, asegúrese de incluir en la variable de ambiente CLASSPATH, las librerías indicadas en cada caso. 2. Cree un directorio de trabajo y copie ahí los códigos Java proporcionados y compílelos para obtener archivos class: cd path_directorio_de_trabajo javac *.java Nota importante: Verifique que se hayan generado los archivos class. 3. Cree una carpeta con el nombre del package y copie ahí los archivos class: mkdir nombre_package cp *.class nombre_package 4. Genere un archivo jar que contenga la estructura del directorio nombre_package con sus archivos class : jar -cf archivo.jar nombre_package 5. Para hacer el deploy del componente o componentes incluidos en el archivo.jar, es necesario copiarlo al directorio correcto en el servidor de aplicaciones Jboss como se indica a continuación: cp archivo.jar $JBOSS_HOME/standalone/deployments 6. Si el deploy se realiza correctamente, esto se verificará en la terminal donde se arrancó el servidor Jboss. Tambien es posible hacer la verificación en la Consola de Administración del Jboss vía Web: Nota importante: [Administration console] [Home] [>Create deployment] Los archivos con las librerías necesarias para realizar la compilación de los archivos Java, se pueden encontrar en el directorio de instalación de Jboss en la carpeta modules.

7 Códigos fuente

8 Archivo: CalculatorBean.java package calculator; import javax.ejb.remote; import javax.ejb.stateless; Ejemplo Enterprise Java Bean Stateless Librerías para public class CalculatorBean implements public int add(int a, int b) return a + public int subtract(int a, int b) return a - public int multiply(int a, int b) return a * b; Archivo: RemoteCalculator.java package calculator; import javax.ejb.remote; public interface RemoteCalculator int add(int a, int b); int subtract(int a, int b); int multiply(int a, int b);

9 Archivo: CirculoBean.java package figuras; import javax.ejb.remote; public class CirculoBean private double radio; Ejemplo Enterprise Java Bean Stateful public void setradio(double valor) radio=valor; public double getradio() return radio; public double area() return *radio*radio; Librerías para compilar: jboss-ejb-api_3.1_spec final-redhat-2.jar public double perimetro() return 2*3.1416*radio; Archivo: CirculoRemote package figuras; import javax.ejb.remote; public interface CirculoRemote void setradio(double valor); double getradio(); double area(); double perimetro();

10 Ejemplo de Webservice basado en un EJB Archivo: Calculator.java package calculadoras; import javax.jws.webservice; import javax.jws.webmethod; import java.rmi.remote; import java.rmi.remoteexception; import javax.jws.soap.soapbinding; public interface Calculator extends int add(int x, int int subtract(int x, int int multiply(int x, int int module(int x, int int divide(int x, int y); Librerías para compilar: jboss-jaxws-api_2.2_spec final-redhat-1.jar jboss-ejb-api_3.1_spec final-redhat-2.jar

11 Archivo: CalculatorBean.java package calculadoras; import javax.ejb.stateless; import javax.jws.webservice; import javax.jws.soap.soapbinding; public class CalculatorBean public int add(int x, int y) return x + y; public int subtract(int x, int y) return x - y; public int multiply(int x, int y) return x * y; public int module(int x, int y) return x % y; public int divide(int x, int y) return x / y;

12 Archivo: clientecalculator.java Ejemplo cliente Java de un Webservice import javax.xml.namespace.qname; import javax.xml.ws.service; import java.net.url; class clientcalculator Librerías para compilar: jboss-jaxrpc-api_1.1_spec final-redhat-3.jar y el jar con la interfaz calculadoras.calculator public static void main(string args[ ]) throws Exception URL url = new URL(" // Qualified name of the service: // 1st arg is the service URI // 2nd is the service name published in the WSDL QName qname = new QName(" "CalculatorBeanService"); System.out.println("QName"); // Create, in effect, a factory for the service. Service service = Service.create(url, qname); System.out.println("QName"); // Extract the endpoint interface, the service "port". calculadoras.calculator eif = service.getport(calculadoras.calculator.class); System.out.println(eif.add(11,6)); System.out.println(eif.subtract(11,6)); System.out.println(eif.multiply(11,6)); System.out.println(eif.module(25,6));

13 Ejemplo de cliente Java para EJB stateful import java.io.*; import java.util.*; import javax.naming.context; import javax.naming.initialcontext; import javax.naming.namingexception; import java.util.properties; import figuras.circuloremote; Librerías para compilar: jboss-client.jar y el jar de la interfaz figuras.circuloremote public class ClienteEJB3V2Stateful public static void main(string arg[]) System.out.println ("Yo soy un Cliente de un EJB3 Stateful"); final Hashtable jndiproperties=new Hashtable(); jndiproperties.put(context.url_pkg_prefixes, "org.jboss.ejb.client.naming"); try final Context ctx = new InitialContext(jndiProperties); CirculoRemote frijol = (CirculoRemote) ctx.lookup("ejb:/ff//circulobean! figuras.circuloremote?stateful"); System.out.println("lookup hecho...<br>"); for(double r=1;r<=5;r+=0.5) frijol.setradio(r); System.out.print(String.format(" Radio: %6.2f ",r)); System.out.print(String.format("%11s %10.3f "," Perimetro:",frijol.perimetro())); System.out.println(String.format("%11s %10.3f "," Area:",frijol.area())); ctx.close(); catch (Exception ex) System.out.println(ex.getMessage()); ex.printstacktrace(); // service // class

14 Ejemplo de cliente Java para EJB stateless import java.io.*; import java.util.*; import javax.naming.context; import javax.naming.initialcontext; import javax.naming.namingexception; import java.util.properties; import calculator.remotecalculator; Librerías para compilar: jboss-client.jar y el jar de la interfaz calculator.remotecalculator public class ClienteEJB3V2 public static void main(string arg[]) System.out.println ("Yo soy un cliente de un EJB3 Stateless"); final Hashtable jndiproperties=new Hashtable(); jndiproperties.put(context.url_pkg_prefixes, "org.jboss.ejb.client.naming"); try final Context ctx = new InitialContext(jndiProperties); RemoteCalculator frijol = (RemoteCalculator) ctx.lookup("ejb:/calc//calculatorbean! calculator.remotecalculator"); System.out.println("Sumar :"+frijol.add(100,50)); System.out.println("Multiplicar:"+frijol.multiply(100,50)); System.out.println("Listo!!"); ctx.close(); catch (Exception ex) System.out.println(ex.getMessage()); ex.printstacktrace(); // service // class Nota importante: El archivo jboss-ejb-client.properties es requerido para ejecutar al cliente de EJB Stateful y Stateless) remote.connectionprovider.create.options.org.xnio.options.ssl_enabled=false remote.connections=default remote.connection.default.host= remote.connection.default.port=4447 remote.connection.default.connect.options.org.xnio.options.sasl_policy_noanonymous=false remote.connection.default.username=humberto remote.connection.default.password=alfabeta123. No olvide crear un usuario de la aplicación con username y password lo cual se logra ejecutando add-user.sh, como se explica en el punto 8 del procedimiento de instalación del servidor de aplicaciones Jboss.

15 package com.example.ejemplows001; import android.widget.textview; Cliente de Webservice desde Android Librería para compilar: ksoap2-android-assembly jar-with-dependencies import org.ksoap2.soapenvelope; import org.ksoap2.serialization.soapobject; import org.ksoap2.serialization.soapprimitive; import org.ksoap2.serialization.soapserializationenvelope; import org.ksoap2.transport.httptransportse; import org.ksoap2.serialization.propertyinfo; import android.app.activity; import android.os.bundle; public class MainActivity extends Activity private static final String NAMESPACE = " private static String URL = " private static final String METHOD_NAME1 = "subtract"; private static final String METHOD_NAME2 = "add"; private static final String METHOD_NAME3 = "multiply"; private static final String METHOD_NAME4 = "module"; private static final String METHOD_NAME5 = "divide"; private static final String SOAP_ACTION = ""; private TextView public void oncreate(bundle savedinstancestate) super.oncreate(savedinstancestate); setcontentview(r.layout.activity_main); lblresult = (TextView) findviewbyid(r.id.textview1); lblresult.settext("webservice: \n"+url+"\n\n"); SoapObject request = new SoapObject(NAMESPACE, METHOD_NAME1); SoapObject request2 = new SoapObject(NAMESPACE, METHOD_NAME2); SoapObject request3 = new SoapObject(NAMESPACE, METHOD_NAME3); SoapObject request4 = new SoapObject(NAMESPACE, METHOD_NAME4); SoapObject request5 = new SoapObject(NAMESPACE, METHOD_NAME5); PropertyInfo propinfo0=new PropertyInfo(); propinfo0.name="arg0";

16 propinfo0.type=propertyinfo.integer_class; PropertyInfo propinfo1=new PropertyInfo(); propinfo1.name="arg1"; propinfo1.type=propertyinfo.integer_class; request.addproperty(propinfo0, 13); request.addproperty(propinfo1, 3); request2.addproperty(propinfo0, 13); request2.addproperty(propinfo1, 3); request3.addproperty(propinfo0, 13); request3.addproperty(propinfo1, 3); request4.addproperty(propinfo0, 13); request4.addproperty(propinfo1, 3); request5.addproperty(propinfo0, 13); request5.addproperty(propinfo1, 3); SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11); HttpTransportSE androidhttptransport = new HttpTransportSE(URL); envelope.setoutputsoapobject(request); try androidhttptransport.call(soap_action, envelope); SoapPrimitive resultsrequestsoap = (SoapPrimitive) envelope.getresponse(); lblresult.append("resta: "+resultsrequestsoap.tostring()); catch (Exception e) lblresult.settext(e.getmessage()); envelope.setoutputsoapobject(request2); try androidhttptransport.call(soap_action, envelope); SoapPrimitive resultsrequestsoap = (SoapPrimitive) envelope.getresponse(); double mul=double.parsedouble(resultsrequestsoap.tostring()); lblresult.append("\nsuma: "+mul); catch (Exception e) lblresult.settext(e.getmessage());

17 envelope.setoutputsoapobject(request3); try androidhttptransport.call(soap_action, envelope); SoapPrimitive resultsrequestsoap = (SoapPrimitive) envelope.getresponse(); double mul=double.parsedouble(resultsrequestsoap.tostring()); lblresult.append("\nproducto: "+mul); catch (Exception e) lblresult.settext(e.getmessage()); envelope.setoutputsoapobject(request4); try androidhttptransport.call(soap_action, envelope); SoapPrimitive resultsrequestsoap = (SoapPrimitive) envelope.getresponse(); double mul=double.parsedouble(resultsrequestsoap.tostring()); lblresult.append("\nmodulo: "+mul); catch (Exception e) lblresult.settext(e.getmessage()); envelope.setoutputsoapobject(request5); try androidhttptransport.call(soap_action, envelope); SoapPrimitive resultsrequestsoap = (SoapPrimitive) envelope.getresponse(); double mul=double.parsedouble(resultsrequestsoap.tostring()); lblresult.append("\ncocient: "+mul); catch (Exception e) lblresult.settext(e.getmessage());

18 Notas: Jboss es una excelente alternativa a servidores de aplicaciones populares como Glassfish o TomcatEE dada su compatibilidad con el estándar JEE. Se sugiere probar proyectos con Servlets y JSPs en archivos WAR generados en estas plataformas, en la plataforma Jboss. Basta con copiar los archivos WAR en el directorio $JBOSS_HOME/standalone/deployments para montar (deploy) los proyectos. =======================================================================

19 Notas:

20