Package cdc.args

Class Factories

  • public final class Factories
extends Object
    Registry of factories.
    Author:
    Damien Carbonne

    • Field Detail

      • PRINTER

        public static final cdc.util.debug.Printable PRINTER

    • Method Detail

      • setConverter

        public static void setConverter​(Factories.ArgsConverter converter)
        Sets the arguments converter.

        This is useful when passed arguments don't have the expected types by can be converted to.
        This is typically the case when arguments are loaded from a file as strings, and must be converted to something else (Integer, Float, ...) to match factory expectations.

        Parameters:
        converter - The converter.

      • convertToStringValues

        public static Arg convertToStringValues​(Arg arg)

      • convertToStringValues

        public static Args convertToStringValues​(Args args)
        Converts arguments to strings.
        Parameters:
        args - The arguments.
        Returns:
        Arguments with same names, but with all values converted to strings.

      • register

        public static void register​(Factory<?> factory)
        Registers a factory.
        Parameters:
        factory - The factory.
        Throws:
        IllegalArgumentException - when factory is invalid or another factory is already associated to the built class.

      • getClasses

        public static Set<Class<?>> getClasses()
        Returns:
        A set of classes for which a factory is registered.

      • getFactory

        public static <T> Factory<T> getFactory​(Class<T> cls,
                                        cdc.util.lang.FailureReaction reaction)
        Returns the factory associated to a class.

        If not factory was registered for the desired class, we try:

        • To detect and register a declared one. It is searched as a Factory instance in the class.
        • To create a new factory and register it. The is possible for singletons. This does not permit to attach meta parameters to the created factory.
        Type Parameters:
        T - The object type.
        Parameters:
        cls - The class.
        reaction - The reaction to adopt when no factory is registered for cls.
        Returns:
        The factory associated to cls or  null.
        Throws:
        cdc.util.lang.NotFoundException - When reaction is FAIL and no factory is associated to cls.

      • getFactory

        public static <T> Factory<T> getFactory​(Class<T> cls)

      • create

        public static Object create​(Class<?> cls,
                            Args args)
        Creates an object.
        Parameters:
        cls - The class of the object to create.
        args - The creation arguments.
        Returns:
        The created object.
        Throws:
        cdc.util.lang.NotFoundException - When no adequate factory is found.
        IllegalArgumentException - When args are are not compliant with factory expectations.

      • create

        public static Object create​(Class<?> cls)
        Creates an object.
        Parameters:
        cls - The class of the object to create.
        Returns:
        The created object.
        Throws:
        cdc.util.lang.NotFoundException - When no adequate factory is found.
        IllegalArgumentException - When Args.NO_ARGS are are not compliant with factory expectations.

      • create

        public static Object create​(String className,
                            Args args)
        Creates an object.
        Parameters:
        className - The class name of the object to create.
        args - The creation arguments.
        Returns:
        The created object.
        Throws:
        cdc.util.lang.NotFoundException - When no adequate factory is found.
        IllegalArgumentException - When args are are not compliant with factory expectations.

      • create

        public static Object create​(String className)
        Creates an object.
        Parameters:
        className - The class name of the object to create.
        Returns:
        The created object.
        Throws:
        cdc.util.lang.NotFoundException - When no adequate factory is found.
        IllegalArgumentException - When Args.NO_ARGS are are not compliant with factory expectations.