Factory


1   /***
2    * Fractal ADL Parser
3    * Copyright (C) 2002-2004 France Telecom R&D
4    *
5    * This library is free software; you can redistribute it and/or
6    * modify it under the terms of the GNU Lesser General Public
7    * License as published by the Free Software Foundation; either
8    * version 2 of the License, or (at your option) any later version.
9    *
10   * This library is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13   * Lesser General Public License for more details.
14   *
15   * You should have received a copy of the GNU Lesser General Public
16   * License along with this library; if not, write to the Free Software
17   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18   *
19   * Contact: Eric.Bruneton@rd.francetelecom.com
20   *
21   * Author: Eric Bruneton
22   */
23  
24  package org.objectweb.fractal.adl;
25  
26  import java.util.Map  ;
27  
28  /**
29   * A component factory.
30   */
31  
32  public interface Factory {
33    
34    /**
35     * TODO.
36     * @param name
37     * @param context
38     * @return
39     * @throws ADLException
40     */
41    
42    Object   newComponentType (String   name, Map   context) throws ADLException;
43    
44    /**
45     * Creates a new instance of the component whose name is given. This can be
46     * done by loading the ADL definition of this name, by compiling it into a
47     * set of tasks and by executing these tasks in the proper order.
48     *  
49     * @param name the name of the component to be created. 
50     * @param context optional additional information.
51     * @return the component that has been created. The type of this result 
52     *      depends on the implementation of this interface: it can be a Fractal
53     *      component reference (if this factory creates Fractal components), it 
54     *      can be an identifier (if this factory generates source code that will
55     *      create components, instead of directly creating components), etc.   
56     * @throws ADLException if a problem occurs during the creation of the 
57     *      component.
58     */
59    
60    Object   newComponent (String   name, Map   context) throws ADLException;
61  }
62
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags