Groovy Documentation

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


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

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 class java.lang.Object
java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#wait(), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()
 

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