org.gradle.api.plugins
Interface Convention

All Superinterfaces:
org.gradle.api.internal.DynamicObject

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.


Method Summary
<T> T
findPlugin(Class<T> type)
          Locates the plugin convention object with the given type.
<T> T
getPlugin(Class<T> type)
          Locates the plugin convention object with the given type.
 Map<String,Object> getPlugins()
          Returns the plugin convention objects contained in this convention.
 
Methods inherited from interface org.gradle.api.internal.DynamicObject
getProperties, getProperty, hasMethod, hasProperty, invokeMethod, setProperty
 

Method Detail

getPlugins

Map<String,Object> 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.

getPlugin

<T> T getPlugin(Class<T> type)
            throws IllegalStateException
Locates the plugin convention object with the given type.

Parameters:
type - The convention object type.
Returns:
The object. Never returns null.
Throws:
IllegalStateException - When there is no such object contained in this convention, or when there are multiple such objects.

findPlugin

<T> T findPlugin(Class<T> type)
             throws IllegalStateException
Locates the plugin convention object with the given type.

Parameters:
type - The convention object type.
Returns:
The object. Returns null if there is no such object.
Throws:
IllegalStateException - When there there are multiple matching objects.