fedora.server
Class Pluggable

java.lang.Object
  extended by fedora.server.Parameterized
      extended by fedora.server.Pluggable
All Implemented Interfaces:
Constants
Direct Known Subclasses:
Module, Server

public abstract class Pluggable
extends Parameterized

Title: Pluggable.java

Description: Abstract superclass of all Fedora components that can be configured by a set of name-value pairs.

Version:
$Id: Pluggable.java 4878 2006-03-02 17:18:42Z eddie $
Author:
cwilper@cs.cornell.edu

Nested Class Summary
 
Nested classes/interfaces inherited from interface fedora.common.Constants
Constants.FedoraHome
 
Field Summary
 
Fields inherited from interface fedora.common.Constants
ACTION, BDEF, BMECH, DATASTREAM, DC, DISSEMINATOR, ENVIRONMENT, FEDORA, FEDORA_HOME, FEDORA_SYSTEM_DEF_PID, FEDORA_SYSTEM_DEF_URI, HTTP_REQUEST, MODEL, OBJECT, RDF, RECOVERY, RELS_EXT, RESOURCE, SUBJECT, TUCANA, VIEW, XSD
 
Constructor Summary
Pluggable()
          Creates a Pluggable with no parameters.
Pluggable(java.util.Map parameters)
          Creates a Pluggable with name-value pairs from the supplied Map.
 
Method Summary
 java.lang.String getHelp()
          Gets an explanation of how this component is to be configured via parameters.
 java.lang.String[] getOptionalParameters()
          Gets the names of optional parameters for this component.
 java.lang.String getParameterHelp(java.lang.String name)
          Gets a short explanation of how to use a named parameter.
 java.lang.String[] getRequiredModuleRoles()
          Gets the names of the roles that are required by this Pluggable.
 java.lang.String[] getRequiredParameters()
          Gets the names of required parameters for this component.
 
Methods inherited from class fedora.server.Parameterized
getParameter, getParameter, getParameters, parameterNames, setParameter, setParameters
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Pluggable

public Pluggable()
Creates a Pluggable with no parameters.


Pluggable

public Pluggable(java.util.Map parameters)
Creates a Pluggable with name-value pairs from the supplied Map.

Parameters:
parameters - The map from which to derive the name-value pairs.
Method Detail

getRequiredParameters

public java.lang.String[] getRequiredParameters()
Gets the names of required parameters for this component.

Returns:
String[] The required parameter names.

getOptionalParameters

public java.lang.String[] getOptionalParameters()
Gets the names of optional parameters for this component.

Returns:
String[] The required parameter names.

getParameterHelp

public java.lang.String getParameterHelp(java.lang.String name)
Gets a short explanation of how to use a named parameter.

Parameters:
name - The name of the parameter.
Returns:
String The explanation, null if no help is available or the parameter is unknown.

getHelp

public java.lang.String getHelp()
Gets an explanation of how this component is to be configured via parameters. This should not include the information available via getParameterHelp, but is more intended as an overall explanation or an explanation of those parameters whose names might be dynamic.


getRequiredModuleRoles

public java.lang.String[] getRequiredModuleRoles()
Gets the names of the roles that are required by this Pluggable.

By default, no roles need to be fulfilled.

Returns:
The roles.