wamblee.org Git - utils/blob - system/general/src/main/java/org/wamblee/system/adapters/ClassConfiguration.java

   1 /*
   2  * Copyright 2008 the original author or authors.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 package org.wamblee.system.adapters;
  17
  18 import java.lang.reflect.Constructor;
  19 import java.util.ArrayList;
  20 import java.util.Arrays;
  21 import java.util.List;
  22
  23 import org.wamblee.collections.CollectionFilter;
  24 import org.wamblee.conditions.Condition;
  25 import org.wamblee.system.core.DefaultProvidedInterface;
  26 import org.wamblee.system.core.DefaultRequiredInterface;
  27 import org.wamblee.system.core.ProvidedInterface;
  28 import org.wamblee.system.core.RequiredInterface;
  29 import org.wamblee.system.core.Scope;
  30 import org.wamblee.system.core.SystemAssemblyException;
  31
  32 /**
  33  * The class configuration encapsulates the knowledge of how to wrap a class as a component.
  34  * In particular, it provides:
  35  * <ul>
  36  *   <li> Selection of a constructor using explicit selection
  37  *      {@link #select(Class...)} or using the most greedy constructor
  38  *      {@link #greedy()}.
  39  *   </li>
  40  *   <li>
  41  *      Selection of methods to invoke to inject other objects into the object.
  42  *   </li>
  43  *   <li> Selection of fields to set.
  44  *   </li>
  45  * </ul>
  46  *
  47  * @author Erik Brakkee
  48  *
  49  */
  50 public class ClassConfiguration {
  51
  52         private Class _class;
  53         private ConstructorConfiguration _constructorConfig;
  54
  55         /**
  56          * Constructs the configuration. By default no constructor is selected and
  57          * one of {@link #select(Class...)} or
  58          * {@link #greedy()} must be called.
  59          * @param aClass Class to construct.
  60          */
  61         public ClassConfiguration(Class aClass) {
  62                 _class = aClass;
  63                 _constructorConfig = new ConstructorConfiguration(aClass);
  64         }
  65
  66         public ConstructorConfiguration getConstructorConfig() {
  67                 return _constructorConfig;
  68         }
  69
  70         /**
  71          * Creates the object in the given scope.
  72          * @param aScope Scope containing required interfaces for this object.
  73          * @return object.
  74          */
  75         public Object create(Scope aScope) {
  76                 return _constructorConfig.create(aScope);
  77         }
  78
  79         public ProvidedInterface[] getProvidedInterfaces() {
  80                 return new ProvidedInterface[] {
  81                         new DefaultProvidedInterface("provided", _class)
  82                 };
  83         }
  84
  85         public RequiredInterface[] getRequiredInterface() {
  86                 return _constructorConfig.getRequiredInterfaces().toArray(new RequiredInterface[0]);
  87         }
  88 }