JavaServer ^TM Faces Release Notes
Change Log

1    /* 
2     * The contents of this file are subject to the terms 
3     * of the Common Development and Distribution License 
4     * (the License). You may not use this file except in 
5     * compliance with the License. 
6     * 
7     * You can obtain a copy of the License at 
8     * http://jsf.java.net/CDDL.html or 
9     * legal/CDDLv1.0.txt. 
10    * See the License for the specific language governing 
11    * permission and limitations under the License. 
12    * 
13    * When distributing Covered Code, include this CDDL 
14    * Header Notice in each file and include the License file 
15    * at legal/CDDLv1.0.txt. 
16    * If applicable, add the following below the CDDL Header, 
17    * with the fields enclosed by brackets [] replaced by 
18    * your own identifying information: 
19    * "Portions Copyrighted [year] [name of copyright owner]" 
20    * 
21    * [Name of File] [ver.__] [Date] 
22    * 
23    * Copyright 2006 Oracle America Inc. All Rights Reserved 
24    */
25    
26    package com.sun.faces.spi; 
27    
28    /** 
29    * <p>This interface defines an integration point for Java EE vendors. 
30    * Each vendor will need to provide an implementation of this interface 
31    * which will provide the JSF implementation the necessary hooks to  
32    * perform resource injection.</p>   
33    *  
34    * <p>The implementation of this interface *must* be thread-safe and must 
35    * have a no-arg constructor.</p> 
36    */ 
37   public interface InjectionProvider { 
38    
39       /** 
40        * <p>The implementation of this method must perform the following 
41        * steps: 
42        *    <ul> 
43        *        <li>Inject the supported resources per the Servlet 2.5 
44        *           specification into the provided object</li> 
45        *        <li>Inoke any method marked with the <code>@PostConstruct</code> 
46        *          annotation (per the Common Annotations Specification)</li> 
47        *    </ul> 
48        * </p> 
49        * @param managedBean the target managed bean 
50        * @throws InjectionProviderException if an error occurs during  
51        *  resource injection 
52        */ 
53       public void inject(Object managedBean) throws InjectionProviderException; 
54    
55        
56       /** 
57        * <p>The implemenation of this method must invoke any 
58        * method marked with the <code>@PreDestroy</code> annotation 
59        * (per the Common Annotations Specification). 
60        * @param managedBean the target managed bean 
61        * @throws InjectionProviderException if an error occurs when invoking 
62        *  the method annotated by the <code>@PreDestroy</code> annotation 
63        */ 
64       public void invokePreDestroy(Object managedBean)  
65       throws InjectionProviderException; 
66   } 
67   

1    /* 
2     * The contents of this file are subject to the terms 
3     * of the Common Development and Distribution License 
4     * (the License). You may not use this file except in 
5     * compliance with the License. 
6     * 
7     * You can obtain a copy of the License at 
8     * http://jsf.java.net/CDDL.html or 
9     * legal/CDDLv1.0.txt. 
10    * See the License for the specific language governing 
11    * permission and limitations under the License. 
12    * 
13    * When distributing Covered Code, include this CDDL 
14    * Header Notice in each file and include the License file 
15    * at legal/CDDLv1.0.txt. 
16    * If applicable, add the following below the CDDL Header, 
17    * with the fields enclosed by brackets [] replaced by 
18    * your own identifying information: 
19    * "Portions Copyrighted [year] [name of copyright owner]" 
20    * 
21    * [Name of File] [ver.__] [Date] 
22    * 
23    * Copyright 2006 Oracle America Inc. All Rights Reserved 
24    */ 
25    
26   package com.sun.faces.spi; 
27    
28   import java.io.ObjectInputStream; 
29   import java.io.InputStream; 
30   import java.io.ObjectOutputStream; 
31   import java.io.OutputStream; 
32   import java.io.IOException; 
33    
34    
35   /** 
36    * <p>This interface provides a mechanism to allow the use 
37    * of alternate Java Serialization implementations.</p> 
38    *  
39    * <p>The implementation of this interface *must* be thread-safe and must 
40    * have a no-arg constructor.</p> 
41    */ 
42   public interface SerializationProvider { 
43    
44       /** 
45        * <p>Creates a new <code>ObjectInputStream</code> wrapping the specified 
46        * <code>source</code>.</p> 
47        *  
48        * <p>It's <em>extremely important</em> that the ObjectInputStream 
49        * returned by this method extends the serialization implementation's ObjectInputStream  
50        * and overrides the {@link ObjectInputStream#resolveClass(java.io.ObjectStreamClass)} 
51        * of  to perform the following or the equivalent thereof:  
52        * <br> 
53        * <pre> 
54        *     return Class.forName(desc.getName(),true,  
55                   Thread.currentThread().getContextClassLoader()); 
56        * </pre> 
57        * <br> 
58        *  
59        * If this step isn't done, there may be problems when deserializing.</p> 
60        *  
61        * @param source the source stream from which to read the Object(s) 
62        *  from 
63        * @return an <code>ObjectInputStream</code> 
64        */ 
65       public ObjectInputStream createObjectInputStream(InputStream source) 
66       throws IOException; 
67    
68    
69       /** 
70        * <p>Creates a new <code>ObjectOutputStream</code> wrapping the 
71        * specified <code>destination</code>.</p> 
72        * @param destination the destination of the serialized Object(s) 
73        * @return an <code>ObjectOutputStream</code> 
74        */ 
75       public ObjectOutputStream createObjectOutputStream(OutputStream destination) 
76       throws IOException; 
77    
78    
79   } // END SerializationProvider