Repository: deltaspike Updated Branches: refs/heads/master 6d89d1dc8 -> 08dd95a31
DELTASPIKE-952 Document Proxy Module Project: http://git-wip-us.apache.org/repos/asf/deltaspike/repo Commit: http://git-wip-us.apache.org/repos/asf/deltaspike/commit/08dd95a3 Tree: http://git-wip-us.apache.org/repos/asf/deltaspike/tree/08dd95a3 Diff: http://git-wip-us.apache.org/repos/asf/deltaspike/diff/08dd95a3 Branch: refs/heads/master Commit: 08dd95a3122a98cfc15dfab97efb2529d8a5cdf1 Parents: 6d89d1d Author: Thomas Andraschko <[email protected]> Authored: Mon Sep 14 22:25:17 2015 +0200 Committer: Thomas Andraschko <[email protected]> Committed: Mon Sep 14 22:25:17 2015 +0200 ---------------------------------------------------------------------- .../proxy/spi/ProxyClassGenerator.java | 20 ++++++++++++++++++++ .../proxy/impl/AsmProxyClassGenerator.java | 1 + documentation/src/main/asciidoc/proxy.adoc | 4 +++- 3 files changed, 24 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/deltaspike/blob/08dd95a3/deltaspike/modules/proxy/api/src/main/java/org/apache/deltaspike/proxy/spi/ProxyClassGenerator.java ---------------------------------------------------------------------- diff --git a/deltaspike/modules/proxy/api/src/main/java/org/apache/deltaspike/proxy/spi/ProxyClassGenerator.java b/deltaspike/modules/proxy/api/src/main/java/org/apache/deltaspike/proxy/spi/ProxyClassGenerator.java index 5898e7a..355168f 100644 --- a/deltaspike/modules/proxy/api/src/main/java/org/apache/deltaspike/proxy/spi/ProxyClassGenerator.java +++ b/deltaspike/modules/proxy/api/src/main/java/org/apache/deltaspike/proxy/spi/ProxyClassGenerator.java @@ -22,6 +22,26 @@ import java.lang.reflect.InvocationHandler; public interface ProxyClassGenerator { + /** + * Generates a proxy class from the given source class. + * The proxy class will be generated in the same package as the original class + * and the suffix will be appended to the name of the class. + * + * @param <T> The target class. + * @param classLoader The {@link ClassLoader} to be used to define the proxy class. + * @param targetClass The class to proxy. + * @param delegateInvocationHandlerClass The {@link InvocationHandler} which will be used for the delegateMethods. + * @param suffix The classname suffix. + * @param superAccessorMethodSuffix It's required to generate methods which just invokes the original method. + * We generate them with the same name as the original method + * and append the suffix. + * @param additionalInterfaces Additional interfaces which should be implemented. + * @param delegateMethods Methods which should be delegated to the {@code delegateInvocationHandlerClass} + * instead of invoking the original method. + * @param interceptMethods Methods which should be intercepted (to call interceptors or decorators) + * before invoking the original method. + * @return The generated proxy class. + */ <T> Class<T> generateProxyClass(ClassLoader classLoader, Class<T> targetClass, Class<? extends InvocationHandler> delegateInvocationHandlerClass, http://git-wip-us.apache.org/repos/asf/deltaspike/blob/08dd95a3/deltaspike/modules/proxy/impl-asm5/src/main/java/org/apache/deltaspike/proxy/impl/AsmProxyClassGenerator.java ---------------------------------------------------------------------- diff --git a/deltaspike/modules/proxy/impl-asm5/src/main/java/org/apache/deltaspike/proxy/impl/AsmProxyClassGenerator.java b/deltaspike/modules/proxy/impl-asm5/src/main/java/org/apache/deltaspike/proxy/impl/AsmProxyClassGenerator.java index c33d11c..59860e4 100644 --- a/deltaspike/modules/proxy/impl-asm5/src/main/java/org/apache/deltaspike/proxy/impl/AsmProxyClassGenerator.java +++ b/deltaspike/modules/proxy/impl-asm5/src/main/java/org/apache/deltaspike/proxy/impl/AsmProxyClassGenerator.java @@ -47,6 +47,7 @@ public class AsmProxyClassGenerator implements ProxyClassGenerator private static final Type TYPE_CLASS = Type.getType(Class.class); private static final Type TYPE_OBJECT = Type.getType(Object.class); + @Override public <T> Class<T> generateProxyClass(ClassLoader classLoader, Class<T> targetClass, Class<? extends InvocationHandler> delegateInvocationHandlerClass, http://git-wip-us.apache.org/repos/asf/deltaspike/blob/08dd95a3/documentation/src/main/asciidoc/proxy.adoc ---------------------------------------------------------------------- diff --git a/documentation/src/main/asciidoc/proxy.adoc b/documentation/src/main/asciidoc/proxy.adoc index 7db0c11..e2d1c04 100644 --- a/documentation/src/main/asciidoc/proxy.adoc +++ b/documentation/src/main/asciidoc/proxy.adoc @@ -5,7 +5,9 @@ :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. == Overview -The Proxy Module provides a simple CDI based wrapper for creating dynamic proxies that can be used within other extensions. +The Proxy Module provides a simple CDI based wrapper for creating dynamic proxies that can be used within other extensions. + +The benefit of the DeltaSpike Proxy Module (compared to Javassist or any library) is that the DeltaSpike proxies will execute CDI interceptors. + +The Proxy Module also provides the 'DeltaSpikeProxyContextualLifecycle', which enables you to dynamically register a proxy as CDI bean via our 'BeanBuilder'. === 1. Declare Proxy Module Dependencies
