Extension (XWiki Commons - Extension

All Superinterfaces:

Comparable<Extension>

All Known Subinterfaces:

CoreExtension, InstalledExtension, LocalExtension, MutableExtension, RatingExtension, RemoteExtension, RewritenExtension

All Known Implementing Classes:

AbstractExtension, AbstractRatingExtension, AbstractRemoteExtension, WrappingCoreExtension, WrappingExtension, WrappingInstalledExtension, WrappingLocalExtension, WrappingRatingExtension, WrappingRemoteExtension
```
public interface Extension
extends Comparable<Extension>
```
Represent an extension.

Since:

4.0M1

Version:

$Id: 23285b469ff4e5c1ea0590c44db32df25656d632 $

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`FIELD_ALLOWEDNAMESPACE`
`static String`	`FIELD_ALLOWEDNAMESPACES`
`static String`	`FIELD_AUTHOR`
`static String`	`FIELD_AUTHORS`
`static String`	`FIELD_CATEGORY`
`static String`	`FIELD_DEPENDENCIES`
`static String`	`FIELD_DESCRIPTION`
`static String`	`FIELD_EXTENSIONFEATURE`
`static String`	`FIELD_EXTENSIONFEATURES`
`static String`	`FIELD_FEATURE` Deprecated. since 9.0RC1/8.4.2, use `FIELD_FEATURE` instead
`static String`	`FIELD_FEATURES` Deprecated. since 9.0RC1/8.4.2, use `FIELD_FEATURES` instead
`static String`	`FIELD_ID`
`static String`	`FIELD_ISSUEMANAGEMENT`
`static String`	`FIELD_LICENSE`
`static String`	`FIELD_LICENSES`
`static String`	`FIELD_MANAGEDDEPENDENCIES`
`static String`	`FIELD_NAME`
`static String`	`FIELD_NAMESPACES`
`static String`	`FIELD_PROPERTIES`
`static String`	`FIELD_REPOSITORIES`
`static String`	`FIELD_REPOSITORY`
`static String`	`FIELD_SCM`
`static String`	`FIELD_SUMMARY`
`static String`	`FIELD_TYPE`
`static String`	`FIELD_VERSION`
`static String`	`FIELD_WEBSITE`
`static String`	`IKEYPREFIX` Prefix to use for custom properties names in external systems (Maven, etc).

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`<T> T`	`get(String fieldName)` Get an extension field (name, summary, id, etc.) by name.
`default Collection<String>`	`getAllowedNamespaces()`
`Collection<ExtensionAuthor>`	`getAuthors()`
`String`	`getCategory()`
`Collection<ExtensionDependency>`	`getDependencies()`
`String`	`getDescription()`
`default ExtensionId`	`getExtensionFeature(String featureId)` Return the `ExtensionId` object that matches the passed feature id.
`default Collection<ExtensionId>`	`getExtensionFeatures()` Indicate in an extension a list of provided "functionalities".
`Collection<String>`	`getFeatures()` Deprecated. since 8.0M1, use `getExtensionFeatures()` instead
`ExtensionFile`	`getFile()` Return extension file descriptor.
`ExtensionId`	`getId()`
`ExtensionIssueManagement`	`getIssueManagement()`
`Collection<ExtensionLicense>`	`getLicenses()`
`default Collection<ExtensionDependency>`	`getManagedDependencies()` Managed dependencies are used to override transitive dependencies (usually the version of this transitive dependency).
`String`	`getName()`
`Map<String,Object>`	`getProperties()` Extends `Extension` standard properties.
`<T> T`	`getProperty(String key)`
`<T> T`	`getProperty(String key, T def)` Get a property.
`Collection<ExtensionRepositoryDescriptor>`	`getRepositories()`
`ExtensionRepository`	`getRepository()`
`ExtensionScm`	`getScm()`
`String`	`getSummary()`
`String`	`getType()`
`String`	`getWebSite()`

Methods inherited from interface java.lang.Comparable
compareTo

- Field Detail
  - FIELD_REPOSITORY
```
static final String FIELD_REPOSITORY
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getRepository(), Constant Field Values
  - FIELD_ID
```
static final String FIELD_ID
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getId(), Constant Field Values
  - FIELD_VERSION
```
static final String FIELD_VERSION
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getId(), Constant Field Values
  - FIELD_FEATURE
```
static final String FIELD_FEATURE
```
    Deprecated. since 9.0RC1/8.4.2, use FIELD_FEATURE instead
    
    Since:
    
    7.0RC1
    
    See Also:
    
    getFeatures(), Constant Field Values
  - FIELD_FEATURES
```
static final String FIELD_FEATURES
```
    Deprecated. since 9.0RC1/8.4.2, use FIELD_FEATURES instead
    
    Since:
    
    7.0RC1
    
    See Also:
    
    getFeatures(), Constant Field Values
  - FIELD_EXTENSIONFEATURE
```
static final String FIELD_EXTENSIONFEATURE
```
    Since:
    
    9.0RC1, 8.4.2
    
    See Also:
    
    getFeatures(), Constant Field Values
  - FIELD_EXTENSIONFEATURES
```
static final String FIELD_EXTENSIONFEATURES
```
    Since:
    
    9.0RC1, 8.4.2
    
    See Also:
    
    getFeatures(), Constant Field Values
  - FIELD_SUMMARY
```
static final String FIELD_SUMMARY
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getSummary(), Constant Field Values
  - FIELD_DESCRIPTION
```
static final String FIELD_DESCRIPTION
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getDescription(), Constant Field Values
  - FIELD_AUTHOR
```
static final String FIELD_AUTHOR
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getAuthors(), Constant Field Values
  - FIELD_AUTHORS
```
static final String FIELD_AUTHORS
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getAuthors(), Constant Field Values
  - FIELD_CATEGORY
```
static final String FIELD_CATEGORY
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getCategory(), Constant Field Values
  - FIELD_LICENSE
```
static final String FIELD_LICENSE
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getLicenses(), Constant Field Values
  - FIELD_LICENSES
```
static final String FIELD_LICENSES
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getLicenses(), Constant Field Values
  - FIELD_NAME
```
static final String FIELD_NAME
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getName(), Constant Field Values
  - FIELD_TYPE
```
static final String FIELD_TYPE
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getType(), Constant Field Values
  - FIELD_WEBSITE
```
static final String FIELD_WEBSITE
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getWebSite(), Constant Field Values
  - FIELD_NAMESPACES
```
static final String FIELD_NAMESPACES
```
    Since:
    
    8.3M1
    
    See Also:
    
    getAllowedNamespaces(), Constant Field Values
  - FIELD_ALLOWEDNAMESPACE
```
static final String FIELD_ALLOWEDNAMESPACE
```
    Since:
    
    8.0M1
    
    See Also:
    
    getAllowedNamespaces(), Constant Field Values
  - FIELD_ALLOWEDNAMESPACES
```
static final String FIELD_ALLOWEDNAMESPACES
```
    Since:
    
    8.0M1
    
    See Also:
    
    getAllowedNamespaces(), Constant Field Values
  - FIELD_SCM
```
static final String FIELD_SCM
```
    Since:
    
    7.0RC1
    
    See Also:
    
    getScm(), Constant Field Values
  - FIELD_REPOSITORIES
```
static final String FIELD_REPOSITORIES
```
    Since:
    
    7.3M1
    
    See Also:
    
    getRepositories(), Constant Field Values
  - FIELD_PROPERTIES
```
static final String FIELD_PROPERTIES
```
    Since:
    
    7.4.3, 8.0.1, 8.1M1
    
    See Also:
    
    getProperties(), Constant Field Values
  - FIELD_ISSUEMANAGEMENT
```
static final String FIELD_ISSUEMANAGEMENT
```
    Since:
    
    9.0RC1, 8.4.2
    
    See Also:
    
    getIssueManagement(), Constant Field Values
  - FIELD_MANAGEDDEPENDENCIES
```
static final String FIELD_MANAGEDDEPENDENCIES
```
    Since:
    
    9.0RC1, 8.4.2
    
    See Also:
    
    getManagedDependencies(), Constant Field Values
  - FIELD_DEPENDENCIES
```
static final String FIELD_DEPENDENCIES
```
    Since:
    
    9.0RC1, 8.4.2
    
    See Also:
    
    getDependencies(), Constant Field Values
  - IKEYPREFIX
```
static final String IKEYPREFIX
```
    Prefix to use for custom properties names in external systems (Maven, etc).
    
    Since:
    
    8.3M1
    
    See Also:
    
    Constant Field Values
- Method Detail
  - get
```
<T> T get(String fieldName)
```
    Get an extension field (name, summary, id, etc.) by name. Fallback on properties.
    
    Type Parameters:
    
    T - type of the field value
    
    Parameters:
    
    fieldName - the field name;
    
    Returns:
    
    the field value or null if none could be found
    
    Since:
    
    7.0RC1
  - getId
```
ExtensionId getId()
```
    Returns:
    
    the id/version combination which makes the extension unique
  - getFeatures
```
@Deprecated
Collection<String> getFeatures()
```
    Deprecated. since 8.0M1, use getExtensionFeatures() instead
    
    Indicate in an extension a list of provided "functionalities". Then when resolving extensions dependencies they can be matched in this list.
    
    Returns:
    
    the extension ids also provided by this extension, an empty collection if there is none
  - getExtensionFeatures
```
default Collection<ExtensionId> getExtensionFeatures()
```
    Indicate in an extension a list of provided "functionalities". Then when resolving extensions dependencies they can be matched in this list.
    
    Returns:
    
    the ExtensionIds also provided by this extension, an empty collection if there is none
    
    Since:
    
    8.0M1
  - getExtensionFeature
```
default ExtensionId getExtensionFeature(String featureId)
```
    Return the ExtensionId object that matches the passed feature id.
    
    Parameters:
    
    featureId - the id of the feature
    
    Returns:
    
    the ExtensionId associated to the passed id
    
    Since:
    
    8.0M1
  - getType
```
String getType()
```
    Returns:
    
    the type of the extension
  - getName
```
String getName()
```
    Returns:
    
    the display name of the extension
  - getLicenses
```
Collection<ExtensionLicense> getLicenses()
```
    Returns:
    
    the license of the extension, an empty collection if there is none
  - getSummary
```
String getSummary()
```
    Returns:
    
    a short description of the extension
  - getDescription
```
String getDescription()
```
    Returns:
    
    a description of the extension
  - getWebSite
```
String getWebSite()
```
    Returns:
    
    an URL for the extension website
  - getAuthors
```
Collection<ExtensionAuthor> getAuthors()
```
    Returns:
    
    the extension authors, an empty collection if there is none
  - getAllowedNamespaces
```
default Collection<String> getAllowedNamespaces()
```
    Returns:
    
    the namespaces where it's allowed to install this extension
    
    Since:
    
    8.0M1
  - getDependencies
```
Collection<ExtensionDependency> getDependencies()
```
    Returns:
    
    the dependencies of the extension, an empty collection if there is none
  - getManagedDependencies
```
default Collection<ExtensionDependency> getManagedDependencies()
```
    Managed dependencies are used to override transitive dependencies (usually the version of this transitive dependency).
    
    Returns:
    
    the managed dependencies, empty list if there is none
    
    Since:
    
    8.1M1
  - getFile
```
ExtensionFile getFile()
```
    Return extension file descriptor. Also allows to get the content of the file.
    
    Returns:
    
    the file of the extension
  - getRepository
```
ExtensionRepository getRepository()
```
    Returns:
    
    the repository of the extension
  - getScm
```
ExtensionScm getScm()
```
    Returns:
    
    informations related to extensions's source control management
    
    Since:
    
    6.3M1
  - getIssueManagement
```
ExtensionIssueManagement getIssueManagement()
```
    Returns:
    
    informations related to extension's issues management
    
    Since:
    
    6.3M1
  - getCategory
```
String getCategory()
```
    Returns:
    
    the category of the extension
    
    Since:
    
    7.0M2
  - getRepositories
```
Collection<ExtensionRepositoryDescriptor> getRepositories()
```
    Returns:
    
    the custom repositories provided by the extension (usually to resolve dependencies)
    
    Since:
    
    7.3M1
  - getProperties
```
Map<String,Object> getProperties()
```
    Extends Extension standard properties.
    Theses are generally provided by specific repositories. For example a maven repository will provide group and artifacts ids.
    
    Returns:
    
    the properties
  - getProperty
```
<T> T getProperty(String key)
```
    Type Parameters:
    
    T - type of the property value
    
    Parameters:
    
    key - the property key
    
    Returns:
    
    the property value
  - getProperty
```
<T> T getProperty(String key,
                  T def)
```
    Get a property.
    
    Type Parameters:
    
    T - type of the property value
    
    Parameters:
    
    key - the property key
    
    def - the value to return if no property is associated to the provided key
    
    Returns:
    
    the property value or default of the property is not found
    
    See Also:
    
    getProperty(String)

Interface Extension

Field Summary

Method Summary

Methods inherited from interface java.lang.Comparable

Field Detail

FIELD_REPOSITORY

FIELD_ID

FIELD_VERSION

FIELD_FEATURE

FIELD_FEATURES

FIELD_EXTENSIONFEATURE

FIELD_EXTENSIONFEATURES

FIELD_SUMMARY

FIELD_DESCRIPTION

FIELD_AUTHOR

FIELD_AUTHORS

FIELD_CATEGORY

FIELD_LICENSE

FIELD_LICENSES

FIELD_NAME

FIELD_TYPE

FIELD_WEBSITE

FIELD_NAMESPACES

FIELD_ALLOWEDNAMESPACE

FIELD_ALLOWEDNAMESPACES

FIELD_SCM

FIELD_REPOSITORIES

FIELD_PROPERTIES

FIELD_ISSUEMANAGEMENT

FIELD_MANAGEDDEPENDENCIES

FIELD_DEPENDENCIES

IKEYPREFIX

Method Detail

get

getId

getFeatures

getExtensionFeatures

getExtensionFeature

getType

getName

getLicenses

getSummary

getDescription

getWebSite

getAuthors

getAllowedNamespaces

getDependencies

getManagedDependencies

getFile

getRepository

getScm

getIssueManagement

getCategory

getRepositories

getProperties

getProperty

getProperty