fedora.server.access
Class DefaultAccess

java.lang.Object
  fedora.server.Parameterized
      fedora.server.Pluggable
          fedora.server.Module
              fedora.server.access.DefaultAccess

All Implemented Interfaces:

Constants, Access

public class DefaultAccess
extends Module
implements Access

Title: DefaultAccess.java

Description: The Access Module, providing support for the Fedora Access subsystem.

Version:

$Id: DefaultAccess.java 6124 2007-09-17 21:11:59Z cwilper $

Author:

rlw@virginia.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

DefaultAccess(java.util.Map moduleParameters, Server server, java.lang.String role)
Creates and initializes the Access Module.

Method Summary

RepositoryInfo	describeRepository(Context context) Gets information that describes the repository.
FieldSearchResult	findObjects(Context context, java.lang.String[] resultFields, int maxResults, FieldSearchQuery query) Lists the specified fields of each object matching the given criteria.
MIMETypedStream	getDatastreamDissemination(Context context, java.lang.String PID, java.lang.String dsID, java.util.Date asOfDateTime)
MIMETypedStream	getDissemination(Context context, java.lang.String PID, java.lang.String bDefPID, java.lang.String methodName, Property[] userParms, java.util.Date asOfDateTime) Disseminates the content produced by executing the specified method of the associated Behavior Mechanism object of the specified digital object.
java.lang.String[]	getObjectHistory(Context context, java.lang.String PID) Gets the change history of an object by returning a list of timestamps that correspond to modification dates of components.
ObjectProfile	getObjectProfile(Context context, java.lang.String PID, java.util.Date asOfDateTime) Gets object profile
void	initModule() Initializes the module.
DatastreamDef[]	listDatastreams(Context context, java.lang.String PID, java.util.Date asOfDateTime)
ObjectMethodsDef[]	listMethods(Context context, java.lang.String PID, java.util.Date asOfDateTime) Gets a list of all Behavior Definition object PIDs and method names associated with the specified digital object.
void	postInitModule() Second stage of Module initialization.
FieldSearchResult	resumeFindObjects(Context context, java.lang.String sessionToken) Resumes an in-progress listing of object fields.

Methods inherited from class fedora.server.Module

getRole, getServer, shutdownModule

Methods inherited from class fedora.server.Pluggable

getHelp, getOptionalParameters, getParameterHelp, getRequiredModuleRoles, getRequiredParameters

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

DefaultAccess

public DefaultAccess(java.util.Map moduleParameters,
                     Server server,
                     java.lang.String role)
              throws ModuleInitializationException

Creates and initializes the Access Module. When the server is starting up, this is invoked as part of the initialization process.

Parameters:

moduleParameters - A pre-loaded Map of name-value pairs comprising the intended configuration of this Module.

server - The Server instance.

role - The role this module fulfills, a java class name.

Throws:

ModuleInitializationException - If initilization values are invalid or initialization fails for some other reason.

Method Detail

initModule

public void initModule()
                throws ModuleInitializationException

Initializes the module.

Overrides:

initModule in class Module

Throws:

ModuleInitializationException - If the module cannot be initialized.

postInitModule

public void postInitModule()
                    throws ModuleInitializationException

Description copied from class: Module

Second stage of Module initialization. This is guaranteed to run after all Module's initModule() methods have run.

Overrides:

postInitModule in class Module

Throws:

ModuleInitializationException - If initialization values are invalid or initialization fails for some other reason.

getDissemination

public MIMETypedStream getDissemination(Context context,
                                        java.lang.String PID,
                                        java.lang.String bDefPID,
                                        java.lang.String methodName,
                                        Property[] userParms,
                                        java.util.Date asOfDateTime)
                                 throws ServerException

Disseminates the content produced by executing the specified method of the associated Behavior Mechanism object of the specified digital object.

Specified by:

getDissemination in interface Access

Parameters:

context - The context of this request.

PID - The persistent identifier of the digital object.

bDefPID - The persistent identifier of the Behavior Definition object.

methodName - The name of the method to be executed.

userParms - An array of user-supplied method parameters consisting of name/value pairs.

asOfDateTime - The versioning datetime stamp.

Returns:

A MIME-typed stream containing the result of the dissemination.

Throws:

ServerException - If any type of error occurred fulfilling the request.

listMethods

public ObjectMethodsDef[] listMethods(Context context,
                                      java.lang.String PID,
                                      java.util.Date asOfDateTime)
                               throws ServerException

Description copied from interface: Access

Gets a list of all Behavior Definition object PIDs and method names associated with the specified digital object.

Specified by:

listMethods in interface Access

Parameters:

context - The context of this request.

PID - The persistent identifier of the digital object

asOfDateTime - The versioning datetime stamp

Returns:

An array of all methods associated with the specified digital object.

Throws:

ServerException - If any type of error occurred fulfilling the request.

listDatastreams

public DatastreamDef[] listDatastreams(Context context,
                                       java.lang.String PID,
                                       java.util.Date asOfDateTime)
                                throws ServerException

Specified by:

listDatastreams in interface Access

Throws:

ServerException

getObjectProfile

public ObjectProfile getObjectProfile(Context context,
                                      java.lang.String PID,
                                      java.util.Date asOfDateTime)
                               throws ServerException

Description copied from interface: Access

Gets object profile

Specified by:

getObjectProfile in interface Access

Parameters:

context - The context of this request.

PID - The persistent identifier of the digital object

asOfDateTime - The versioning datetime stamp

Returns:

An array of all methods associated with the specified digital object.

Throws:

ServerException - If any type of error occurred fulfilling the request.

findObjects

public FieldSearchResult findObjects(Context context,
                                     java.lang.String[] resultFields,
                                     int maxResults,
                                     FieldSearchQuery query)
                              throws ServerException

Lists the specified fields of each object matching the given criteria.

Specified by:

findObjects in interface Access

Parameters:

context - the context of this request

resultFields - the names of the fields to return

maxResults - the maximum number of results to return at a time

query - the query

Returns:

the results of te field search

Throws:

ServerException - If any type of error occurred fulfilling the request.

resumeFindObjects

public FieldSearchResult resumeFindObjects(Context context,
                                           java.lang.String sessionToken)
                                    throws ServerException

Resumes an in-progress listing of object fields.

Specified by:

resumeFindObjects in interface Access

Parameters:

context - the context of this request

sessionToken - the token of the session in which the remaining results can be obtained

Returns:

the next set of results from the initial field search

Throws:

ServerException - If any type of error occurred fulfilling the request.

describeRepository

public RepositoryInfo describeRepository(Context context)
                                  throws ServerException

Gets information that describes the repository.

Specified by:

describeRepository in interface Access

Parameters:

context - the context of this request

Returns:

information that describes the repository.

Throws:

ServerException - If any type of error occurred fulfilling the request.

getObjectHistory

public java.lang.String[] getObjectHistory(Context context,
                                           java.lang.String PID)
                                    throws ServerException

Gets the change history of an object by returning a list of timestamps that correspond to modification dates of components. This currently includes changes to datastreams and disseminators.

Specified by:

getObjectHistory in interface Access

Parameters:

context - The context of this request.

PID - The persistent identifier of the digitla object.

Returns:

An Array containing the list of timestamps indicating when changes were made to the object.

Throws:

ServerException - If any type of error occurred fulfilling the request.

getDatastreamDissemination

public MIMETypedStream getDatastreamDissemination(Context context,
                                                  java.lang.String PID,
                                                  java.lang.String dsID,
                                                  java.util.Date asOfDateTime)
                                           throws ServerException

Specified by:

getDatastreamDissemination in interface Access

Throws:

ServerException