Package 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>, org.gradle.api.internal.rules.NamedDomainObjectFactoryRegistry<T>, NamedDomainObjectSet<T>, PolymorphicDomainObjectContainer<T>, Set<T>
All Known Subinterfaces:
NativeToolChainRegistry, PlatformContainer, PublicationContainer
@Incubating public interface ExtensiblePolymorphicDomainObjectContainer<T> extends PolymorphicDomainObjectContainer<T>, org.gradle.api.internal.rules.NamedDomainObjectFactoryRegistry<T>
A PolymorphicDomainObjectContainer that can be extended at runtime to create elements of new types.

  • Method Details

    • 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.
      Specified by:
      registerFactory in interface org.gradle.api.internal.rules.NamedDomainObjectFactoryRegistry<T>
      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