Package net.shibboleth.idp.plugin

Class PropertyDrivenIdPPlugin

java.lang.Object

net.shibboleth.idp.plugin.AbstractIdPPlugin

net.shibboleth.idp.plugin.PropertyDrivenIdPPlugin

All Implemented Interfaces:

IdPPlugin

Direct Known Subclasses:

FirstPartyIdPPlugin

public abstract class PropertyDrivenIdPPlugin
extends AbstractIdPPlugin

Implementation of IdPPlugin relying on Java Properties.

Since:

4.1.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_RESOURCE	Default name of plugin properties resource.
private org.slf4j.Logger	log	Class logger.
static final String	PLUGIN_ID_PROPERTY	Property for plugin ID.
static final String	PLUGIN_LICENSE_PROPERTY	Property for plugin license.
static final String	PLUGIN_REQ_MODULES_PROPERTY	Property for plugin's required modules.
static final String	PLUGIN_URL_PROPERTY	Prefix of property for plugin update URL.
static final String	PLUGIN_VERSION_PROPERTY	Property for plugin version.
private String	pluginId	Non-defaulted plugin ID.
private final Properties	pluginProperties	Properties describing plugin.
private PluginVersion	pluginVersion	Handles parsing of plugin version.
private Set<String>	requiredModules	Required modules.
private List<URL>	updateURLs	Plugin update URLs.

Constructor Summary

Constructors

Constructor	Description
PropertyDrivenIdPPlugin(InputStream inputStream)	Constructor.
PropertyDrivenIdPPlugin(Class<? extends IdPPlugin> claz)	Constructor.
PropertyDrivenIdPPlugin(Properties properties)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected List<URL>	getDefaultUpdateURLs()	Provides default update locations to use.
String	getLicenseFileLocation()	Return the classpath location of the license file to emit when --license is specified.
int	getMajorVersion()	Return the major version, (as defined by the Java Product Version Policy.
int	getMinorVersion()	Return the minor version, (as defined by the Java Product Version Policy.
int	getPatchVersion()	Return The patch version, (as defined by the Java Product Version Policy.
String	getPluginId()	Return the unique identifier for the plugin.
Set<String>	getRequiredModules()	Get the IDs of any IdPModules required for installation of this plugin.
List<URL>	getUpdateURLs()	Return the places to look for information for this plugin package.
protected void	load()	Load plugin information from properties.

Methods inherited from class net.shibboleth.idp.plugin.AbstractIdPPlugin

equals, getDisableOnRemoval, getEnableOnInstall, hashCode, setDisableOnRemoval, setEnableOnInstall, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

DEFAULT_RESOURCE

@Nonnull
@NotEmpty
public static final String DEFAULT_RESOURCE

Default name of plugin properties resource.

See Also:

• Constant Field Values

PLUGIN_ID_PROPERTY

@Nonnull
@NotEmpty
public static final String PLUGIN_ID_PROPERTY

Property for plugin ID.

See Also:

• Constant Field Values

PLUGIN_VERSION_PROPERTY

@Nonnull
@NotEmpty
public static final String PLUGIN_VERSION_PROPERTY

Property for plugin version.

See Also:

• Constant Field Values

PLUGIN_LICENSE_PROPERTY

@Nonnull
@NotEmpty
public static final String PLUGIN_LICENSE_PROPERTY

Property for plugin license.

See Also:

• Constant Field Values

PLUGIN_URL_PROPERTY

@Nonnull
@NotEmpty
public static final String PLUGIN_URL_PROPERTY

Prefix of property for plugin update URL.

See Also:

• Constant Field Values

PLUGIN_REQ_MODULES_PROPERTY

@Nonnull
@NotEmpty
public static final String PLUGIN_REQ_MODULES_PROPERTY

Property for plugin's required modules.

See Also:

• Constant Field Values

log

@Nonnull
private org.slf4j.Logger log

Class logger.

pluginProperties

@Nonnull
private final Properties pluginProperties

Properties describing plugin.

pluginId

@Nullable
private String pluginId

Non-defaulted plugin ID.

pluginVersion

@Nullable
private PluginVersion pluginVersion

Handles parsing of plugin version.

updateURLs

@Nonnull
@NonnullElements
private List<URL> updateURLs

Plugin update URLs.

requiredModules

@Nonnull
@NonnullElements
private Set<String> requiredModules

Required modules.

Constructor Details

PropertyDrivenIdPPlugin

public PropertyDrivenIdPPlugin(@Nonnull
 Class<? extends IdPPlugin> claz)
                        throws IOException,
PluginException

Constructor.

Parameters:

claz - type of object used to locate default module.properties resource

Throws:

IOException - if unable to read file

PluginException - if the plugin is not in a valid state

PropertyDrivenIdPPlugin

public PropertyDrivenIdPPlugin(@Nonnull
 InputStream inputStream)
                        throws IOException,
PluginException

Constructor.

Parameters:

inputStream - property stream

Throws:

IOException - if unable to read file

PluginException - if the plugin is not in a valid state

PropertyDrivenIdPPlugin

public PropertyDrivenIdPPlugin(@Nonnull
 Properties properties)
                        throws PluginException

Constructor.

Parameters:

properties - property set

Throws:

PluginException - if the plugin is not in a valid state

Method Details

load

protected void load()
             throws PluginException

Load plugin information from properties.

Throws:

PluginException - on errors

getPluginId

@Nonnull
@NotEmpty
public String getPluginId()

Return the unique identifier for the plugin. This name MUST be

• renderable in all file systems (for instance alphanumerics, '-' and '.' only)
• unique. This is best done using java module guidance

For instance org.example.plugins.myplugin

Specified by:

getPluginId in interface IdPPlugin

Overrides:

getPluginId in class AbstractIdPPlugin

Returns:

The id of this plugin.

getUpdateURLs

@Nonnull
@NonnullElements
@Unmodifiable
@NotLive
public List<URL> getUpdateURLs()

Return the places to look for information for this plugin package. The format of the (property) file at this location is fixed.

Returns:

Zero or more URLs

getRequiredModules

@Nonnull
@NonnullElements
@Unmodifiable
@NotLive
public Set<String> getRequiredModules()

Get the IDs of any IdPModules required for installation of this plugin.

Specified by:

getRequiredModules in interface IdPPlugin

Overrides:

getRequiredModules in class AbstractIdPPlugin

Returns:

module IDs that are required

getLicenseFileLocation

@Nullable
public String getLicenseFileLocation()

Return the classpath location of the license file to emit when --license is specified.

Specified by:

getLicenseFileLocation in interface IdPPlugin

Overrides:

getLicenseFileLocation in class AbstractIdPPlugin

Returns:

the location

getMajorVersion

@NonNegative
public int getMajorVersion()

Return the major version, (as defined by the Java Product Version Policy.

Returns:

The major version.

getMinorVersion

@NonNegative
public int getMinorVersion()

Return the minor version, (as defined by the Java Product Version Policy.

Returns:

The minor version.

getPatchVersion

@NonNegative
public int getPatchVersion()

Return The patch version, (as defined by the Java Product Version Policy.

Specified by:

getPatchVersion in interface IdPPlugin

Overrides:

getPatchVersion in class AbstractIdPPlugin

Returns:

The patch version.

getDefaultUpdateURLs

@Nonnull
@NonnullElements
@Unmodifiable
@NotLive
protected List<URL> getDefaultUpdateURLs()
                                  throws PluginException

Provides default update locations to use.

Returns:

default update locations

Throws:

PluginException - if a derived class throws it (see derived classes)