Interface ObjectFactory
An instance of the factory can be injected into a task or plugin by annotating a public constructor or method with javax.inject.Inject
. It is also available via Project.getObjects()
.
- Since:
- 4.0
-
Method Summary
Modifier and TypeMethodDescription<T> ListProperty<T>
listProperty
(Class<T> elementType) Creates aListProperty
implementation to hold aList
of the given element type.<T extends Named>
TCreates a simple immutableNamed
object of the given type and name.<T> T
newInstance
(Class<? extends T> type, Object... parameters) Create a new instance of T, usingparameters
as the construction parameters.<T> Property<T>
Creates aProperty
implementation to hold values of the given type.
-
Method Details
-
named
Creates a simple immutableNamed
object of the given type and name.The given type can be an interface that extends
Named
or an abstract class that 'implements'Named
. An abstract class, if provided:- Must provide a zero-args constructor that is not private.
- Must not define or inherit any instance fields.
- Should not provide an implementation for
Named.getName()
and should define this method as abstract. Any implementation will be overridden. - Must not define or inherit any other abstract methods.
An interface, if provided, must not define or inherit any other methods.
Objects created using this method are not decorated or extensible.
- Throws:
ObjectInstantiationException
- On failure to create the new instance.- Since:
- 4.0
-
newInstance
<T> T newInstance(Class<? extends T> type, Object... parameters) throws ObjectInstantiationException Create a new instance of T, usingparameters
as the construction parameters.The type must be a non-abstract class.
Objects created using this method are decorated and extensible, meaning that they have DSL support mixed in and can be extended using the `extensions` property, similar to the
Project
object.An @Inject annotation is required on any constructor that accepts parameters because JSR-330 semantics for dependency injection are used. In addition to those parameters provided as an argument to this method, the following services are also available for injection:
- Throws:
ObjectInstantiationException
- On failure to create the new instance.- Since:
- 4.2
-
property
Creates aProperty
implementation to hold values of the given type.The property will have a value equal to the default value of that type as defined by the Java language specification. Please see Oracle's Java manual for more information.
Any other data type than the standard Java data types returns a property with no value defined.
- Parameters:
valueType
- The type of the property.- Returns:
- The property. Never returns null.
- Since:
- 4.3
-
listProperty
Creates aListProperty
implementation to hold aList
of the given element type. The property with have an empty list as its initial value.The implementation will return immutable
List
values from its query methods.- Type Parameters:
T
- The type of element.- Parameters:
elementType
- The type of element.- Returns:
- The property. Never returns null;
- Since:
- 4.3
-