Java EE 7
Cuando despliegas un EJB en el servidor de aplicaciones, este hace un registro de ellos vía JNDI -llamado binding- con los siguientes datos:
java:global/[<application-name>]/<module-name>/<bean-name>!<fully-qualified-bean-interface-name>
Donde:
- application-name: es el nombre de la aplicación. Solo necesario si se ha desplegado un EAR. Se deduce por:
- el nombre del EAR
- el valor de
<display></display>
del archivo application.xml
dentro de META-INF
.
- module-name: es el nombre del módulo al cual pertenece el bean (archivos .jar, .war) sin la extensión. Esto puede ser sobreescrito en el
ejb-jar.xml
.
- bean-name: indica el nombre simple del bean.
- fully-qualified-bean-interface-name: indica el nombre calificado (con todo y paquete) del bean o de la interface (en caso sea un EJB remoto).
Esta estructura fue impuesta a partir de la especificación 3.1 de EJB y la puedes utilizar en Java EE 7+. Antes de esto, cada vendor tenía su propia estructura JNDI, no permitiendo hacer las aplicaciones totalmente portables.
Creando EJBs remotos sin estado
Para crear un EJB remoto basta con crear una interface y una clase que la implemente y que, además, referencie a la interfaz por medio de la anotación @Remote
.
public class CalculadoraRemote {
public int sumar(int n1, int n2);
public int restar(int n1, int n2);
public int multiplicar(int n1, int n2);
public double dividir(int n1, int n2);
}
@Remote(CalculadoraRemote.class);
public class CalcuadoraBean implements CalculadoraRemote {
// métodos
}
Cuando desplegemos esto, el JNDI será:
java:global/Calculadora/calculadoraejbs/CalculadoraBean!pe.mitsugami.ejb.CalculadoraRemote
Haciendo lookup (búsqueda) de EJBs remotos
Par hacer un lookup
de un EJB, lo haremos por medio de las propiedades del JNDI:
- application-name: Solo necesario si se ha desplegado un EAR.
- module-name: lo mismo, el nombre del jar que contiene el/los EJB.
- bean-name: lo mismo
- fully-qualified-bean-interface-name: lo mismo
Componentes No-JavaEE
final Map<String, String> propiedadesJndi = new HashTable<>();
propiedadesJndi.put(Context.URL_PGK_PREFIXES, "org.jboss.client.naming");
final Context contexto = new InitialContext(propiedadesJndi);
// propiedades JNDI
String appName = ""; // o el nombre del EAR en caso hayas desplegado un EAR
String moduleName = "calcuadoraejbs";
String beanName = CalculadoraBean.class.getSimpleName();
String fullyBeanName = CalculadoraBean.class.getName();
// procedemos con la búsqueda
CalculadoraRemote calculadora = (CalculadoraRemote) contexto.lookup("java:global/"+appName+"/"+beanName+"!"+fullyBeanName);
Componentes Java EE
Para componentes Java EE podemos aprovechar la anotación @EJB
para inyectar la dependencia del EJB remoto.
@EJB
private CalculadoraRemote calculadora;
Esto funcionará si solo tienes una implementación de CalculadoraRemote
, si tienes más no funcionará porque tendrás un problema de dependencias ambiguas. Esto se soluciona por medio del atributo name
de Stateless|Stateful|Singleton
:
@Stateless(name = "calculadoraCientifica")
@Remote(CalculadoraRemote.class)
public class CalculadoraCientifica implements CalculadoraRemote { }
@Stateless(name = "calculadoraSimple")
@Remote(CalculadoraRemote.class)
public class CalculadoraSimple implements CalculadoraRemote { }
E inyectamos:
@EJB(name = "calculadoraCientifica")
private CalculadoraRemote calculadora;
También puedes inyectar un EJB remoto indicando el nombre JNDI de forma explícita por medio del atributo lookup
de la anotación @EJB
.
@EJB(lookup = "java:global/calculadoraejbs/CalculadoraBean!pe.mitsugami.ejb.CalculadoraRemote")
private CalculadoraRemote calculadora;