com.cookingfox.chefling.api.command.CreateInstanceCommand Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of chefling-di-java Show documentation

Chefling is a very minimal dependency injection container written in pure Java.

There is a newer version: 7.1.1

package com.cookingfox.chefling.api.command;

import com.cookingfox.chefling.api.CheflingContainer;
import com.cookingfox.chefling.api.CheflingLifecycle;
import com.cookingfox.chefling.api.exception.ContainerException;

public interface CreateInstanceCommand {

    /**
     * Creates a new instance of `type`, attempting to resolve its full dependency tree. The
     * instance is not stored (that's what {@link CheflingContainer#getInstance(Class)} is for), so
     * only use this method directly when you need a NEW instance. It uses the type mappings (from
     * the `map...` methods) to create the instance. If no mapping is available, it attempts to
     * resolve the dependencies by inspecting the constructor parameters. If the created instance
     * implements {@link CheflingLifecycle}, its {@link CheflingLifecycle#initialize()} method will
     * be called.
     *
     * @param type The type (class, interface) to instantiate.
     * @param   Ensures the returned object is cast to the expected type.
     * @return Instance of `type`.
     * @throws ContainerException when the instance cannot be created, for example because its
     *                            dependencies cannot be resolved.
     */
     T createInstance(Class type);

}