Groovy Documentation

org.gradle.api.plugins
[Java] Interface Convention

org.gradle.api.plugins.ExtensionContainer
  org.gradle.api.plugins.Convention
All Superinterfaces:
ExtensionContainer

public interface Convention
extends org.gradle.api.internal.DynamicObject, ExtensionContainer

A Convention manages a set of convention objects. When you add a convention object to a Convention, and the properties and methods of the convention object become available as properties and methods of the object which the convention is associated to. A convention object is simply a POJO or POGO. Usually, a Convention is used by plugins to extend a Project or a Task.

Authors:
Hans Dockter


Method Summary
T findPlugin(java.lang.Class type)

Locates the plugin convention object with the given type.

T getPlugin(java.lang.Class type)

Locates the plugin convention object with the given type.

java.util.Map getPlugins()

Returns the plugin convention objects contained in this convention.

 
Methods inherited from interface org.gradle.api.internal.DynamicObject
org.gradle.api.internal.DynamicObject#setProperty(java.lang.String, java.lang.Object), org.gradle.api.internal.DynamicObject#getProperty(java.lang.String), org.gradle.api.internal.DynamicObject#getProperties(), org.gradle.api.internal.DynamicObject#hasMethod(java.lang.String, [Ljava.lang.Object;), org.gradle.api.internal.DynamicObject#invokeMethod(java.lang.String, [Ljava.lang.Object;), org.gradle.api.internal.DynamicObject#hasProperty(java.lang.String)
 
Methods inherited from interface ExtensionContainer
add, findByName, findByType, getByName, getByType
 

Method Detail

findPlugin

public T findPlugin(java.lang.Class type)
Locates the plugin convention object with the given type.
throws:
IllegalStateException When there there are multiple matching objects.
Parameters:
type - The convention object type.
Returns:
The object. Returns null if there is no such object.


getPlugin

public T getPlugin(java.lang.Class type)
Locates the plugin convention object with the given type.
throws:
IllegalStateException When there is no such object contained in this convention, or when there are multiple such objects.
Parameters:
type - The convention object type.
Returns:
The object. Never returns null.


getPlugins

public java.util.Map getPlugins()
Returns the plugin convention objects contained in this convention.
Returns:
The plugins. Returns an empty map when this convention does not contain any convention objects.


 

Groovy Documentation