Genesis DI

GENESIS DI

OBIETTIVI

Composizione di oggetti attraverso dependency injection
Creazione di un oggetto a partire da una sua descrizione testuale con struttura gerarchica
Risoluzione ricorsiva dei collaboratori nel processo di creazione di un oggetto
Integrazione di oggetti da librerie indipendenti

TERMINOLOGIA

SERVICE

Un servizio è un oggetto a cui viene attribuito un nome .

Ha un determinato tipo , che in base all'oggetto può essere:

la sua classe;
una sua superclasse;
un'interfaccia implementata.

Tipo e nome identificano univocamente un servizio.

TERMINOLOGIA

SERVICE CONFIGURATION

Un servizio ha un insieme di parametri necessari alla sua configurazione.

I nomi e i valori dei parametri sono rappresentati come stringhe.

Un servizio viene parametrizzato attraverso una mappa in cui sono associati valori ai nomi dei parametri.

TERMINOLOGIA

SERVICE COLLABORATORS

Un servizio può necessitare che alcuni collaboratori gli vengano iniettati per poter usarne le funzionalità.

Ad ogni collaboratore è assegnato un ruolo, il cui nome è rappresentato come stringa, analogo al nome di un parametro della configurazione.

Un collaboratore può a sua volta avere collaboratori.

SERVICE DESCRIPTOR

RAPPRESENTAZIONE

ServiceDescriptor è la classe che rappresenta la descrizione testuale di un servizio, contenente i campi:

name: nome attribuito al servizio
configuration: coppie di stringhe parametro-valore
collaborators: mappa che associa a un ruolo un descrittore di un collaboratore

SERVICE DESCRIPTOR

DEFINIZIONE

public class ServiceDescriptor {

    public final String name;
    public final Map<String, String> configuration;
    public final Map<String, ServiceDescriptor> collaborators;
}

SERVICE DESCRIPTOR

GERARCHIA DI SERVIZI

Considerando i descrittori di servizi come nodi è possibile costruire un albero che rappresenti la gerarchia di composizione dei vari oggetti descritti.

Alla radice si trova il descrittore del servizio che si vuole utilizzare.

Le foglie sono servizi che non richiedono l'iniezione di alcun collaboratore.

SERVICE DESCRIPTOR

ESEMPIO

{
    name: "dataMapper",
    configuration: {
        inputFile: "src/main/resources/file.csv",
        outputFile: "target/generated-sources/file.json"
    }, collaborators: {
        reader: {
            name: csv",
            configuration: {
                skipBlankLines: "true"
            }
        }, writer: {
            name: "json"
        }
    }
}

SERVICE FACTORY

DEFINIZIONE

Un servizio viene istanziato attraverso una factory .

public interface ServiceFactory<S> {

    S create(ServiceDescriptor service);
}

SERVICE CONTEXT

DEFINIZIONE

Un C ontext contiene factory di servizi e si occupa di istanziare un servizio costruendo ricorsivamente i collaboratori.

public interface Context {

    <S> S generate(Class<S> serviceType, ServiceDescriptor service);

    <S> Map<String, ServiceFactory<S>> load(Class<S> serviceType);
}

CONFIGURATION

OBIETTIVI

Definizione di un servizio e implementazione della sua logica di istanziazione rappresentabili in modo conciso
Raggruppamento di servizi in moduli configurabili
Possibilità di usare congiuntamente moduli caricati automaticamente dal classpath e moduli configurabili istanziati manualmente

CONFIGURATION

RAPPRESENTAZIONE

Una factory può essere definita a partire da un metodo usando le opportune annotazioni (mostrate in seguito).

Il nome del metodo rappresenta il nome del servizio, il tipo restituito diventa il tipo del servizio.

Gli argomenti del metodo possono assumere un diverso significato in base alle annotazioni usate.

CONFIGURATION

ANNOTAZIONI ARGOMENTI

@Parameter: indica che l'argomento va valorizzato recuperando dalla configurazione del servizio il valore del parametro col nome indicato
@Role: richiede che come argomento sia passato un collaboratore, istanziato usando come descrittore quello col ruolo indicato

CONFIGURATION

ESEMPIO

public class ActivationFunctionConfiguration {

    public ActivationFunction tanh() {
        return new HyperbolicTangent();
    }

    public ActivationFunction logistic() {
        return new LogisticFunction();
    }

    public ActivationFunction scale(
            @Role("inner") ActivationFunction inner,
            @Parameter("scale") String scale) {
        return new Scale(inner, Double.parseDouble(scale));
    }
}

CONFIGURATION

ESEMPIO

Implementazione diretta di una factory.

public class ScaleFactory implements ServiceFactory<ActivationFunction> {

    private final Context context;

    public ActivationFunction create(ServiceDescriptor service) {
        return new Scale(
                context.create(service.collaborators.get("inner"),
                Double.parseDouble(service.configuration.get("scale"));
    }
}

CONFIGURATION

ESEMPIO

Context context = new ConfigurationContext(Arrays.asList(
        new ActivationFunctionConfiguration()
).iterator());

ServiceDescriptor scaledTanh = new ServiceDescriptor(
        "scale",
        Collections.singletonMap("scale", "1.15"),
        Collections.singletonMap("inner", new ServiceDescriptor(
                "tanh",
                Collections.emptyMap(),
                Collections.emptyMap())));

ActivationFunction function = context
        .generate(ActivationFunction.class, scaledTanh);

CONFIGURATION

CARICAMENTO AUTOMATICO

Utilizzando come marker interface Configuration è possibile caricare tutte le sue implementazioni presenti nel classpath attraverso la classe ServiceLoader .

public class ActivationFunctionConfiguration implements Configuration { ... }

Iterable<Configuration> configurations = ServiceLoader
        .load(Configuration.class);

Context context = new ConfigurationContext(configurations.iterator());

MAVEN

INTEGRAZIONE

Maven permette di configurare un suo plugin attraverso il descrittore di progetto pom.xml.

Si possono quindi descrivere uno o più servizi usando l'xml per rappresentarne la gerarchia di collaboratori.

MAVEN

ESEMPIO

<configuration>
    <trainingMethod>
        <name>batchBackPropagation</name>
        <configuration>
            <learningRate>0.1</learningRate>
            <momentum>0.1</momentum>
            <tolerance>0.01</tolerance>
        </configuration>
        <collaborators>
            <logger>
                <name>maven</name>
            </logger>
        </collaborators>
    </trainingMethod>
</configuration>