Una de las cosas interesantes que tiene javassist es que no es necesario tener una clase con una interfaz definida, tal como se usa en JDK Dynamic Proxy o con ProxyFactoryBean (aunque también lo tiene usando cglib) para poder crear el Proxy.
Otra de las características de javassist es que posee mecanismos para mitigar la baja de rendimiento al utilizar el patrón Proxy, internamente maneja cache e intervención a nivel de bytecode para optimizar su uso.
Javassist (Java Programming Assistant) makes Java bytecode manipulation simple. It is a class library for editing bytecodes in Java; it enables Java programs to define a new class at runtime and to modify a class file when the JVM loads it. Unlike other similar bytecode editors, Javassist provides two levels of API: source level and bytecode level.
/** * Una copia de la implementación de la calculadora pero sin interfaz */ publicstatic CalculadoraWithoutInterface createCalculadoraWithoutInterface() throws InstantiationException, IllegalAccessException { ProxyFactorypf=newProxyFactory(); pf.setSuperclass(CalculadoraWithoutInterface.class); pf.setFilter(newSumaMethodFilter()); pf.setUseCache(true); Class<?> proxyClass = pf.createClass();
Como podrán ver, el uso del ProxyFactory de javassist es muy parecido a los otros (ProxyFactoryBean y JDK Dynamic Proxy), además usa un nuevo concepto llamado MethodFilter que permite agregar un filtro para los nombres de los métodos, con la finalidad de que el proxy sólo funciona cuando el método isHandled retorna true, de lo contrario hará una llamada directa a la clase RealSubject.
MethodFilter
Veamos la implementación de MethodFilter para este ejemplo:
@Override publicbooleanisHandled(Method m) { return METHOD_NAME_TO_PROXY.equals(m.getName()); } }
MethodHandler
Esta clase es la que contiene la lógica de negocio del proxy, es parecida a los interceptores (MethodInterceptor) de SpringFramework para el uso de ProxyFactoryBean o de InvocationHandler para JDK Dynamic Proxy.
for (Object object : args) { if (object instanceof Integer) { Integernumber= Integer.valueOf(object.toString());
if (number.intValue() > 0) { System.out.println("Parameter [" + number + "]"); } else { System.err.println("Invalid number [" + number + "]"); thrownewRuntimeException("Invalid number [" + number + "]"); } } else { System.err.println("Invalid type"); thrownewRuntimeException("Invalid type"); } } return proceed.invoke(self, args); } }
Test Unitario
Para hacer la prueba, realicé dos test unitarios, uno usando las mismas clases que he usado en los otros ejemplos y una nueva clase calculadora que no tiene una interfaz definida, con la finalidad de probar la funcionalidad de manipulación de bytecode en tiempo de runtime de javassist (crea una intrefaz a partir de la información de la clase).
Y finalmente la salida a la consola del test unitario es la siguiente:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
------------------------------------------------------- T E S T S ------------------------------------------------------- Running patterns.proxyjavassist.ProxyFactoryJavassistTest -------------------- Invalid number [-1] -------------------- Parameter [1] Parameter [2] -------------------- Invalid number [-1] -------------------- Parameter [1] Parameter [2] Tests run: 4, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.093 sec
En otro post, trataré de profundizar en la librería javassist ya que desde hace mucho la vengo mirando como dependencias de varios frameworks y aplicaciones (Hibernate, jboss, Spring Framework) y me llama la atención el cómo poder generar bytecode utilizando una API. La otra librería que hace algo similar es cglib y que Hibernate usó en los inicios del proyecto, aunque al parecer ya va en retroceso (también le echaré un vistazo).
Nota: Si ven en los debug de Hibernate algo como NombreDeClase_$$_javassist_0 son los proxys que arma Hibernate con javassist para las entidades que se cargan en modo lazy.
Una manera sencilla de crear Proxy es usando SpringFramework, siempre y cuando tengas configurado tu aplicación con Spring, de otra forma, puedes buscar otras librerías que puedan ayudarte con el patrón Proxy (dinámico), (cglib y javassist) o puedes utilizar la API de java para crearlos. Revisa aquí Java Dynamic Proxy o Patrones De Diseño: Proxy.
Por ahora voy a mostrar como configurar un Proxy Dinámico con SprinFramework, configuraciones y par un de conceptos.
Conceptos
Target: Es la clase que será envuelta por el proxy (RealSubject)
Interceptor(es): Son las clases accesorias donde deberás agregar la lógica de negocio asociada al Proxy. Estos interceptores pueden ser mas de uno para un mismo target.
ProxyFactoryBean: Es la clase de Spring Framework para crear proxys dinámicos, al estilo Spring (con un FactoryBean). Deja un bean configurado dentro del contexto, listo para ser usado. Lo bueno de esta estrategia es que la creación del Proxy se realiza sólo una vez y cuando levanta el contexto, al contrario del Proxy que provee la API de Java, por cada invocación se debe crear el Proxy (aunque es rápido pero todo suma).
Interceptores
Los interceptores son clases que contienen la lógica de negocio del Proxy, es el símil a el InvocationHandler de la API de Java. Estas clases deben ser implementadas desde la interfaz Interceptor que es la de mas alta jerarquía o de su herencia, MethodInterceptor o ConstructorInterceptor. Estas últimas clases pertenecen a la librería de aopalliance versión 1.0 en el package org.aopalliance.intercept.
Para poder agregar las 2 funcionalidades (loggear los parámetros de entrada y validar que no sean negativos), implementaremos 2 Interceptores con la finalidad de aislar las lógicas de negocio de cada uno.
calculadora: Es la clase a envolver en el Proxy (RealSubject o target).
calculadoraWithProxy: Proxy Factory que crea el bean configurado como Proxy. En este bean deben fijarse en las propiedades configuradas:
target: Es una referencia al bean con id calculadora.
interceptorNames: Es una lista con los id de los beans que harán de interceptores. En este caso son dos los interceptores validate y logger.
Notas
Como podrán ver, usé las mismas clases del post Java Dynamic Proxy y sólo agregue los Interceptores donde se concentra la lógica de negocio solicitada.
Recuerden que como se trata de un Proxy Dinámico se necesita que CalculadoraImpl implemente una interfaz conocida, en este caso, Calculadora.
La clase ProxyFactoryBean posee varios atributos mas que permiten agregarle funcionalidad y configuraciones al proxy, échenle un vistazo.
Test Unitario
Para poder probar las funcionalidades realicé el siguiente test unitario:
------------------------------------------------------- T E S T S ------------------------------------------------------- Running patterns.proxyAOP.CalculadoraServiceAOPTest ---------------------------------- Argument 1 Argument 2 ---------------------------------- Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.592 sec
Los proxy dinámicos fueron introducidos en la API de Java 1.3 agregando múltiples funcionalidades a la plataforma Java. En este post pretendo enseñarles algunos usos de los proxy dinámicos y cómo implementar uno sencillo.
Primero tienen que conocer la definición de proxy y sus posibles usos, que ya fueron descritas en un post anterior, puedes revisarlo antes de continuar: Patrones de Diseño: Proxy
Primero debemos conocer las clases que hacen posible la implementación de Dynamic Proxy en la API de Java, estas son java.lang.reflect.Proxy y java.lang.reflect.InvocationHandler, además debes tener conceptos básicos de Reflexión (sólo para la invocación de métodos).
java.lang.reflect.Proxy
Para crear un objeto Proxy debes utilizar la clase java.lang.reflect.Proxy de la siguiente forma:
classLoader: classloader que contiene la definición de las interfaces que componen el objeto target (o RealSubject).
interfaces: Arreglo con la definición de las interfaces que implementa el objeto target (o RealSubject).
handler: Esta es la clase que nos permitirá implementar el Proxy, es la clase que contiene la lógica de negocio del Proxy.
java.lang.reflect.InvocationHandler
Esta interfaz debe ser implementada y tenemos el método invoke que hará las veces de interceptor, es aquí donde debemos escribir nuestra lógica de negocio.
El objeto a “proxiar” debe tener una interfaz, no una clase concreta o abstracta, una Interfaz.
El arreglo de Interfaces no debe contener interfaces duplicadas.
Todas las interfaces deben ser visibles en el classloader que se esta utilizando (usado en la construcción del Proxy).
Las interfaces del proxy no deben tener conflictos de métodos. Ver la especificación de Lenguaje Java sobre sobre-escritura de métodos.
Ejemplo Práctico
Veamos un ejemplo práctico de la implementación de un proxy dinámico usando la API de Java:
1 2 3 4 5 6 7 8 9 10
publicinterfaceCalculadora {
/** * @param a * @param b * @return suma de a+b */ Integer suma(Integer a, Integer b);
}
Ahora veamos la implementación de Calculadora:
1 2 3 4 5 6 7 8
publicclassCalculadoraImplimplementsCalculadora {
@Override public Integer suma(Integer a, Integer b) { return a + b; }
}
Supongamos que estas clases ya están creadas y necesitamos agregar un par de funcionalidades sin tener que tocar el código ya existente. La primera funcionalidad es validar que los números a y b sean mayores a 0 y la segunda funcionalidad es loggear los parámetros de entrada.
Como podrán ver en el ejemplo, en el método invoke se hace el control y el log sobre los argumentos que entran al método suma del RealSubject. Además para simplificar la creación del Proxy, se implementó un method-factory que crea el proxy dinámico (método proxyFactory).
Ahora el test unitario que prueba el funcionamiento del Proxy:
La salida de este test a la consola con maven es la siguiente:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
------------------------------------------------------- T E S T S ------------------------------------------------------- Running patterns.dynamicproxy.CalculadoraProxyFactoryTest ------------------------------ Invalid number [-1] ------------------------------ Invalid type ------------------------------ Parameter [1] Parameter [2] Execute method [suma]
El patrón Proxy esta clasificado dentro de los Patrones Estructurales, es también conocido como, Embajador, Apoderado (surrogante). Veamos primero su definición:
Un proxy fuerza a que un método de un objeto RealSubject sea indirectamente ejecutado a través de un objeto Proxy, el cual actúa como delegado o sustituto del objeto RealSubject. Los objetos Proxy son usualmente declarados sin que el Cliente sepa de que se trata de un Objeto Proxy.
Les dejo un diagrama de clases de cómo se implementa este patrón.
Usos del patrón Proxy
Control de Acceso: El patrón puede ser usado para controlar el acceso a los métodos del RealSubject. La lógica del control de acceso se delegará en el proxy, de esta forma quedará mas limpio el RealSubject (en términos de código).
Acceso a objetos remotos: Representación de un objeto remoto de forma local, es decir, el Proxy resuelve y enmascara la forma en cómo conectarse al objeto remoto. Ejemplos de implementación de este patrón los pueden encontrar en EJB y RMI.
Proxy Virtual: Crea objetos costosos bajo demanda. Por ejemplo, al iniciar una aplicación se pueden instanciar con este patrón todos los iconos de dicha aplicación, pero sólo cuando éste sea solicitado realmente ira a buscarlo al disco y presentado al usuario.
Proxy de Referencia Inteligente: Sustituto de una referencia que hace operaciones adicionales cuando se accede a un objeto, como por ejemplo, controlar concurrencia, contar numero de instancias, cargar un objeto en memoria, manejo de cache)
Implementación de Ejemplo
Partamos con la interfaz que deben cumplir tanto RealSubject como el SubjectProxy
Esto imprimirá lo siguiente en la consola (systemOut)
1
Access Denied
La explicación al Access Denied esta dada porque el patrón Proxy se utilizó como control de acceso al método doOperation. Sólo si el username es admin se ejecutará dicho método.
doOperacion proxied Connecting to remote doOperation Real doOperacion proxied doOperation Real
En este caso, el usuario admin puede ejecutar la operación y la primera vez que lo haga se conectará un objeto remoto o difícil de crear (simulado para el ejemplo). Luego una vez conectado, podrá ejecutar la operación.
Nuevamente el usuario admin ejecutará la operación por segunda vez y el SubjectProxy ya posee una conexión al objeto remoto, aquí simplemente ejecutará la operación.
Espero les haya gustado y les sirva en sus proyectos, en el siguiente post les comentaré sobre Dynamic Proxy de Java.