Save This Page
Home » apache-openwebbeans-1.0.0-incubating-M3-sources » javax.enterprise.context.spi » [javadoc | source]
    1   /*
    2    * Licensed to the Apache Software Foundation (ASF) under one
    3    * or more contributor license agreements.  See the NOTICE file
    4    * distributed with this work for additional information
    5    * regarding copyright ownership.  The ASF licenses this file
    6    * to you under the Apache License, Version 2.0 (the
    7    * "License"); you may not use this file except in compliance
    8    * with the License.  You may obtain a copy of the License at
    9    *
   10    * http://www.apache.org/licenses/LICENSE-2.0
   11    *
   12    * Unless required by applicable law or agreed to in writing,
   13    * software distributed under the License is distributed on an
   14    * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   15    * KIND, either express or implied.  See the License for the
   16    * specific language governing permissions and limitations
   17    * under the License.
   18    */
   19   package javax.enterprise.context.spi;
   20   
   21   import javax.enterprise.inject.CreationException;
   22   
   23   /**
   24    * Each webbeans instance that is contained in the <code>Context</code>
   25    * must be defined as <code>Contextual</code>.
   26    * 
   27    * This interface defines the creating and destroying of the webbeans instances
   28    * that are contained in the its {@link Context} instance.
   29    * 
   30    * @param <T> type of the webbeans component
   31    * @see Context
   32    * 
   33    * @version $Rev: 815435 $ $Date: 2009-09-15 21:18:44 +0300 (Tue, 15 Sep 2009) $
   34    */
   35   public interface Contextual<T>
   36   {
   37       /**
   38        * Creates and returns a new instance of the webbeans component.
   39        * 
   40        * @param context new creational context instance
   41        * @return the new instance of the webbeans component
   42        * @throws CreationException if any exception occurs
   43        */
   44       public T create(CreationalContext<T> context);
   45   
   46       /**
   47        * Destroys the instance. Any destroy logic is encapsulated
   48        * in this method.
   49        * 
   50        * @param instance already created webbeans instance
   51        * @param context creational context
   52        */
   53       public void destroy(T instance, CreationalContext<T> context);
   54   }

Save This Page
Home » apache-openwebbeans-1.0.0-incubating-M3-sources » javax.enterprise.context.spi » [javadoc | source]