org.meanbean.factories.util

Class BasicFactoryLookupStrategy

java.lang.Object

org.meanbean.factories.util.BasicFactoryLookupStrategy

All Implemented Interfaces:

FactoryLookupStrategy

@MetaInfServices
public class BasicFactoryLookupStrategy
extends Object
implements FactoryLookupStrategy

Concrete FactoryLookupStrategy that implements the following Factory lookup algorithm:

1. If a Configuration is provided, this is first inspected for a property-specific Factory.
2. If no Configuration is provided or there is no property-specific Factory in the Configuration, the FactoryCollection is then searched for a Factory suitable for the type of the property.
3. If the FactoryCollection does not contain a suitable Factory, an attempt is made to create a Factory for the type. For example, if the type is an Enum, then a generic Enum Factory will be created for the Enum's constants, registered in the Factory Collection for future use, and returned from this method. As a last resort, an attempt is made create a Factory that creates objects of the custom data type. If successful, this Factory is registered in the Factory Collection for future use, and return from this method.
4. If ultimately a suitable Factory cannot be found or created, a NoSuchFactoryException detailing the problem is thrown.

Author:

Graham Williamson

Constructor Summary

Constructors

Constructor and Description
BasicFactoryLookupStrategy(FactoryCollection factoryCollection, RandomValueGenerator randomValueGenerator) Construct a new Factory Lookup Strategy.

Method Summary

Modifier and Type	Method and Description
Factory<?>	getFactory(BeanInformation beanInformation, PropertyInformation propertyInformation, Configuration configuration) Get a factory for the specified property that is of the specified type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.meanbean.factories.util.FactoryLookupStrategy

getInstance, getServiceDefinition

Constructor Detail

BasicFactoryLookupStrategy

public BasicFactoryLookupStrategy(FactoryCollection factoryCollection,
                                  RandomValueGenerator randomValueGenerator)
                           throws IllegalArgumentException

Construct a new Factory Lookup Strategy.

Parameters:

factoryCollection - A collection of test data Factories.

randomValueGenerator - Random number generator used by factories to randomly generate values.

Throws:

IllegalArgumentException - If either the factoryCollection or randomValueGenerator are deemed illegal. For example, if either is null.

Method Detail

getFactory

public Factory<?> getFactory(BeanInformation beanInformation,
                             PropertyInformation propertyInformation,
                             Configuration configuration)
                      throws IllegalArgumentException,
                             NoSuchFactoryException

Get a factory for the specified property that is of the specified type.

If a Configuration is provided, this is first inspected for a property-specific Factory.

If no Configuration is provided or there is no property-specific Factory in the Configuration, the FactoryCollection is then searched for a Factory suitable for the type of the property.

If the FactoryCollection does not contain a suitable Factory, an attempt is made to create a Factory for the type.

For example, if the type is an Enum, then a generic Enum Factory will be created for the Enum's constants, registered in the Factory Collection for future use, and returned from this method.

As a last resort, an attempt is made create a Factory that creates objects of the custom data type. If successful, this Factory is registered in the Factory Collection for future use, and return from this method.

If ultimately a suitable Factory cannot be found or created, a NoSuchFactoryException detailing the problem is thrown.

Specified by:

getFactory in interface FactoryLookupStrategy

Parameters:

beanInformation - Information about the bean the property belongs to.

propertyInformation - The information of the property.

configuration - An optional Configuration object that may contain an override Factory for the specified property. Pass null if no Configuration exists.

Returns:

A Factory that may be used to create objects appropriate for the specified property.

Throws:

IllegalArgumentException - If any of the required parameters are deemed illegal. For example, if any are null.

NoSuchFactoryException - If an unexpected exception occurs when getting the Factory, including failing to find a suitable Factory.