org.gradle.api

## Interface ExtensiblePolymorphicDomainObjectContainer<T>

- Type Parameters:
    `T` - the (base) container element type
  All Superinterfaces:
    Collection<T>, org.gradle.util.Configurable<NamedDomainObjectContainer<T>>, DomainObjectCollection<T>, Iterable<T>, NamedDomainObjectCollection<T>, NamedDomainObjectContainer<T>, NamedDomainObjectSet<T>, PolymorphicDomainObjectContainer<T>, Set<T>
  All Known Subinterfaces:
    BinaryContainer, FunctionalSourceSet, PublicationContainer, ToolChainRegistry

      @Incubating
      public interface ExtensiblePolymorphicDomainObjectContainer<T>
      extends PolymorphicDomainObjectContainer<T>

  A `PolymorphicDomainObjectContainer` that can be extended at runtime to create elements of new types.

- - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `<U extends T> void` | `registerBinding(Class<U> type, Class<? extends U> implementationType)` Registers a binding from the specified "public" domain object type to the specified implementation type.
    `<U extends T> void` | `registerFactory(Class<U> type, Closure<? extends U> factory)` Registers a factory for creating elements of the specified type.
    `<U extends T> void` | `registerFactory(Class<U> type, NamedDomainObjectFactory<? extends U> factory)` Registers a factory for creating elements of the specified type.

    - ### Methods inherited from interface org.gradle.api.PolymorphicDomainObjectContainer

      `create, create`

    - ### Methods inherited from interface org.gradle.api.NamedDomainObjectContainer

      `configure, create, create, create, maybeCreate`

    - ### Methods inherited from interface org.gradle.api.NamedDomainObjectSet

      `findAll, matching, matching, withType`

    - ### Methods inherited from interface org.gradle.api.NamedDomainObjectCollection

      `add, addAll, addRule, addRule, findByName, getAsMap, getAt, getByName, getByName, getNamer, getNames, getRules`

    - ### Methods inherited from interface org.gradle.api.DomainObjectCollection

      `all, all, whenObjectAdded, whenObjectAdded, whenObjectRemoved, whenObjectRemoved, withType, withType`

    - ### Methods inherited from interface java.util.Collection

      `clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray`

    - ### Methods inherited from interface java.util.Set

      `add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray`

- - ### Method Detail

    - #### registerFactory

          <U extends T> void registerFactory(Class<U> type,
                                           NamedDomainObjectFactory<? extends U> factory)

      Registers a factory for creating elements of the specified type. Typically, the specified type is an interface type.
      Type Parameters:
        `U` - the type of objects created by the factory
      Parameters:
        `type` - the type of objects created by the factory
        `factory` - the factory to register
      Throws:
        `IllegalArgumentException` - if the specified type is not a subtype of the container element type

    - #### registerFactory

          <U extends T> void registerFactory(Class<U> type,
                                           Closure<? extends U> factory)

      Registers a factory for creating elements of the specified type. Typically, the specified type is an interface type.
      Type Parameters:
        `U` - the type of objects created by the factory
      Parameters:
        `type` - the type of objects created by the factory
        `factory` - the factory to register
      Throws:
        `IllegalArgumentException` - if the specified type is not a subtype of the container element type

    - #### registerBinding

          <U extends T> void registerBinding(Class<U> type,
                                           Class<? extends U> implementationType)

      Registers a binding from the specified "public" domain object type to the specified implementation type. Whenever the container is asked to create an element with the binding's public type, it will instantiate the binding's implementation type. If the implementation type has a constructor annotated with `Inject`, its arguments will be injected.

      In general, registering a binding is preferable over implementing and registering a factory.

      Type Parameters:
        `U` - a public domain object type
      Parameters:
        `type` - a public domain object type
        `implementationType` - the corresponding implementation type