[weld-commits] Weld SVN: r6192 - api/trunk/weld-spi/src/main/java/org/jboss/weld/serialization/spi.

[weld-commits at lists.jboss.org]

Author: dallen6
Date: 2010-04-29 12:59:06 -0400 (Thu, 29 Apr 2010)
New Revision: 6192

Added:
   api/trunk/weld-spi/src/main/java/org/jboss/weld/serialization/spi/ProxyServices.java
Log:
Added new ProxyServices to allow container control over proxying behaviors

Added: api/trunk/weld-spi/src/main/java/org/jboss/weld/serialization/spi/ProxyServices.java
===================================================================
--- api/trunk/weld-spi/src/main/java/org/jboss/weld/serialization/spi/ProxyServices.java	                        (rev 0)
+++ api/trunk/weld-spi/src/main/java/org/jboss/weld/serialization/spi/ProxyServices.java	2010-04-29 16:59:06 UTC (rev 6192)
@@ -0,0 +1,69 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2008, Red Hat, Inc. and/or its affiliates, and individual contributors
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * Licensed 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.
+ */
+
+package org.jboss.weld.serialization.spi;
+
+import java.security.ProtectionDomain;
+
+import org.jboss.weld.bootstrap.api.Service;
+
+/**
+ * <p>Support services related to proxy generation and serialization which are required
+ * to be implemented by all containers.</p>
+ * 
+ * <p>
+ * These services are used by all Weld proxy classes to ensure the correct class loaders
+ * are used and to aid in the serialization and deserialization of these classes across
+ * container instances.
+ * </p>
+ * 
+ * <p>
+ * Required in all environments since proxies are always in use.  A default
+ * implementation will be used if none are provided by the container which
+ * will use the information directly from the type of proxy.
+ * </p>
+ * 
+ * <p> {@link ProxyServices} is a per-deployment service.</p>
+ * 
+ * @author David Allen
+ *
+ */
+public interface ProxyServices extends Service
+{
+   /**
+    * Returns the class loader that will load the proxy class which extends or
+    * implements the given type.  This class loader may simply be the same
+    * class loader used for the type, or it may be another class loader designed
+    * to hold proxies while still providing access to the given type and any of its
+    * ancestors and used types.
+    * 
+    * @param type the super type (class or interface) of the proxy
+    * @return the class loader to use for the proxy class
+    */
+   public ClassLoader getClassLoader(Class<?> type);
+   
+   /**
+    * Returns the protection domain to use when a security manager is present
+    * during generation of a proxy class with the given super type.  Usually
+    * this protection domain will need to correspond to the one used with
+    * the class loader provided by {@link #getClassLoader(Class)}.
+    * 
+    * @param type the super type (class or interface) of the proxy
+    * @return the protection domain to use for the proxy class
+    */
+   public ProtectionDomain getProtectionDomain(Class<?> type);
+}