gradle
8.6

# named

@Incubating
open fun named(nameFilter: Spec<String>): NamedDomainObjectCollection<T>(source)

Returns a collection containing the objects with names matching the provided filter. The returned collection is live, so that when matching objects are added to this collection, they are also visible in the filtered collection. This method will NOT cause any pending objects in this container to be realized.

#### Return

The collection of objects with names satisfying the filter. Returns an empty collection if there are no such objects in this collection.

#### Parameters

nameFilter

The specification to test names against.

abstract fun named(name: String): NamedDomainObjectProvider<T>(source)

Locates a object by name, without triggering its creation or configuration, failing if there is no such object.

#### Return

A Provider that will return the object when queried. The object may be created and configured at this point, if not already.

#### Parameters

name

The object's name

#### Throws

UnknownDomainObjectException

If a object with the given name is not defined.

abstract fun named(name: String, configurationAction: Action<out Any>): NamedDomainObjectProvider<T>(source)

Locates a object by name, without triggering its creation or configuration, failing if there is no such object. The given configure action is executed against the object before it is returned from the provider.

#### Return

A Provider that will return the object when queried. The object may be created and configured at this point, if not already.

#### Parameters

name

The object's name

#### Throws

UnknownDomainObjectException

If an object with the given name is not defined.

abstract fun <S : T?> named(name: String, type: Class<S>): NamedDomainObjectProvider<S>(source)

Locates a object by name and type, without triggering its creation or configuration, failing if there is no such object.

#### Return

A Provider that will return the object when queried. The object may be created and configured at this point, if not already.

#### Parameters

name

The object's name

type

The object's type

#### Throws

UnknownDomainObjectException

If an object with the given name is not defined.

abstract fun <S : T?> named(name: String, type: Class<S>, configurationAction: Action<out Any>): NamedDomainObjectProvider<S>(source)

Locates a object by name and type, without triggering its creation or configuration, failing if there is no such object. The given configure action is executed against the object before it is returned from the provider.

#### Return

A Provider that will return the object when queried. The object may be created and configured at this point, if not already.

#### Parameters

name

The object's name

type

The object's type

configurationAction

The action to use to configure the object.

#### Throws

UnknownDomainObjectException

If an object with the given name is not defined.