// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

[[custom_gradle_types]]
= Developing Custom Gradle Types

This page has been removed.

[[managed_properties]]

[[read_only_managed_properties]]

[[read_only_managed_nested_properties]]

    override fun execute(parameters: Params) {

    }
}
----

The `execute` method must be implemented because this is where the work happens.
An action implementation is treated as a <<custom_gradle_types.adoc#custom_gradle_types,custom Gradle type>> and can use any of the features available to custom Gradle types.
In particular, some Gradle services can be injected into the implementation.

A dataflow action may accept parameters.

[source,groovy]
----
abstract class BaseCountingService implements BuildService<CountingParams>, AutoCloseable {

}
----

A build service implementation is treated as a <<custom_gradle_types.adoc#custom_gradle_types,custom Gradle type>> and can use any of the features available to custom Gradle types.

A build service can optionally take parameters, which Gradle injects into the service instance when creating it.

    static final String CUSTOM_GRADLE_TASK_DOC_LINK = "Rewrite the class with a constructor injection. " + new DocumentationRegistry().getDocumentationRecommendationFor("information on developing custom gradle task types", "custom_gradle_types", "service_injection");

    private final CrossBuildInMemoryCache<Class<?>, CachedConstructor> constructorCache;
    private final ClassGenerator classGenerator;

 * {@link org.gradle.kotlin.dsl.DependenciesExtensions extension functions for Kotlin DSL}.
 * <p>
 * @see <a href="https://docs.gradle.org/current/userguide/custom_gradle_types.html#custom_dependencies_blocks">Creating custom dependencies blocks.</a>
 *
 * @since 7.6
 */
@Incubating
@SuppressWarnings("JavadocReference")
public interface Dependencies {
    /**

include::logging.adoc[leveloffset=+2]
include::potential_traps.adoc[leveloffset=+2]
include::build_environment.adoc[leveloffset=+2]
include::init_scripts.adoc[leveloffset=+2]
include::custom_gradle_types.adoc[leveloffset=+2]
include::build_services.adoc[leveloffset=+2]
include::dataflow_actions.adoc[leveloffset=+2]
include::test_kit.adoc[leveloffset=+2]
include::ant.adoc[leveloffset=+2]

[[part:jvm_projects]]

 * considered as an input to the work graph cache.
 * </p>
 * <p>
 * It is possible to have some Gradle services to be <a href="https://docs.gradle.org/current/userguide/custom_gradle_types.html#service_injection">injected</a>
 * into the implementation, similar to tasks and plugins.
 * It can be done by adding a parameter to the constructor and annotating the
 * constructor with the {@code @Inject} annotation:

You can also create a container instance using a <<custom_gradle_types.adoc#read_only_managed_properties,read-only managed property>>.

====
include::sample[dir="snippets/providers/collections/kotlin",files="build.gradle.kts[tags=ndoc]"]

----

In the example above, a deployment task is created dynamically for every user-configured environment.

You can find out more about implementing project extensions in <<custom_gradle_types.adoc#custom_gradle_types,Developing Custom Gradle Types>>.

[[modeling_dsl_like_apis]]
== Modeling DSL-like APIs
DSLs exposed by plugins should be readable and easy to understand.

====

==== Next to the property declaration

You may configure a convention on a lazy property next to the place where the property is declared.
Note this option is not available for <<custom_gradle_types.adoc#managed_properties,managed properties>>, and has the same caveats as configuring a convention from the task constructor.

====