Definitions

Requirements

1. Using the Framework

The framework will take an interface name and return a plain Java object (POJO) which implements the interface.

1. The framework will associate interfaces to a plain Java implementation by registering a Service.
   1. A service can be registered at runtime in code.
   2. A service can be registered when the framework initializes itself by having the framework look for specifically named property files.
2. The framework will use a Registry to store services.
3. The framework will use a Locator to generate an instance of the Java class which implements the interface.

2. Configuring the Framework

The framework will configure itself with some basic, useful options to begin with, but can be overridden and/or extended.

1. The framework can be configured programatically by adding Services to the Registry. For instance:

     ServiceManager services = ServiceManager.getInstance();
     services.register(new Service(InterfaceClass.class, ImplementationClass.class));
     services.register(
       new Service(AnotherInterfaceClass.class, AnotherImplementationClass.class));
     ...
   

2. The framework can be configured using a property file where the key in the property file is the fully qualified classname of the interface and the value in the property file is the fully qualified classname of the implementation. For instance:

   servicemanager.properties
   -------------------------
   com.company.interfaces.InterfaceClass=com.company.impl.ImplementationClass
   com.company.interfaces.AnotherInterfaceClass=com.company.impl.AnotherImplementationClass
   

3. Extending the Framework

There are no easy ways to extend the framework right now, but plans are in the works.