org.dspace.content.packager

Class RoleDisseminator

java.lang.Object

org.dspace.content.packager.RoleDisseminator

All Implemented Interfaces:

PackageDisseminator

public class RoleDisseminator
extends java.lang.Object
implements PackageDisseminator

Plugin to export all Group and EPerson objects in XML, perhaps for reloading.

Author:

Mark Wood

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CAN_LOGIN
static java.lang.String	DSPACE_ROLES
static org.jdom.Namespace	DSROLES_NS DSpace Roles XML Namespace in JDOM form.
static java.lang.String	EMAIL
static java.lang.String	EPERSON
static java.lang.String	EPERSONS
static java.lang.String	FIRST_NAME
static java.lang.String	GROUP
static java.lang.String	GROUP_TYPE_ADMIN
static java.lang.String	GROUP_TYPE_SUBMIT
static java.lang.String	GROUP_TYPE_WORKFLOW_STEP_1
static java.lang.String	GROUP_TYPE_WORKFLOW_STEP_2
static java.lang.String	GROUP_TYPE_WORKFLOW_STEP_3
static java.lang.String	GROUPS
static java.lang.String	ID
static java.lang.String	LANGUAGE
static java.lang.String	LAST_NAME
static java.lang.String	MEMBER
static java.lang.String	MEMBER_GROUP
static java.lang.String	MEMBER_GROUPS
static java.lang.String	MEMBERS
static java.lang.String	NAME
static java.lang.String	NETID
static java.lang.String	PASSWORD_DIGEST
static java.lang.String	PASSWORD_HASH
static java.lang.String	PASSWORD_SALT
static java.lang.String	REQUIRE_CERTIFICATE
static java.lang.String	SELF_REGISTERED
static java.lang.String	TYPE

Constructor Summary

Constructors

Constructor and Description
RoleDisseminator()

Method Summary

Methods

Modifier and Type	Method and Description
void	disseminate(Context context, DSpaceObject object, PackageParameters params, java.io.File pkgFile) Export the object (Item, Collection, or Community) as a "package" on the indicated OutputStream.
java.util.List<java.io.File>	disseminateAll(Context context, DSpaceObject dso, PackageParameters params, java.io.File pkgFile) Recursively export one or more DSpace Objects as a series of packages.
java.lang.String	getMIMEType(PackageParameters params) Identifies the MIME-type of this package, e.g.
java.lang.String	getParameterHelp() Returns a user help string which should describe the additional valid command-line options that this packager implementation will accept when using the -o or --option flags with the Packager script.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DSROLES_NS

public static final org.jdom.Namespace DSROLES_NS

DSpace Roles XML Namespace in JDOM form.

DSPACE_ROLES

public static final java.lang.String DSPACE_ROLES

See Also:

Constant Field Values

ID

public static final java.lang.String ID

See Also:

Constant Field Values

GROUPS

public static final java.lang.String GROUPS

See Also:

Constant Field Values

GROUP

public static final java.lang.String GROUP

See Also:

Constant Field Values

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

MEMBERS

public static final java.lang.String MEMBERS

See Also:

Constant Field Values

MEMBER

public static final java.lang.String MEMBER

See Also:

Constant Field Values

MEMBER_GROUPS

public static final java.lang.String MEMBER_GROUPS

See Also:

Constant Field Values

MEMBER_GROUP

public static final java.lang.String MEMBER_GROUP

See Also:

Constant Field Values

EPERSONS

public static final java.lang.String EPERSONS

See Also:

Constant Field Values

EPERSON

public static final java.lang.String EPERSON

See Also:

Constant Field Values

EMAIL

public static final java.lang.String EMAIL

See Also:

Constant Field Values

NETID

public static final java.lang.String NETID

See Also:

Constant Field Values

FIRST_NAME

public static final java.lang.String FIRST_NAME

See Also:

Constant Field Values

LAST_NAME

public static final java.lang.String LAST_NAME

See Also:

Constant Field Values

LANGUAGE

public static final java.lang.String LANGUAGE

See Also:

Constant Field Values

PASSWORD_HASH

public static final java.lang.String PASSWORD_HASH

See Also:

Constant Field Values

PASSWORD_DIGEST

public static final java.lang.String PASSWORD_DIGEST

See Also:

Constant Field Values

PASSWORD_SALT

public static final java.lang.String PASSWORD_SALT

See Also:

Constant Field Values

CAN_LOGIN

public static final java.lang.String CAN_LOGIN

See Also:

Constant Field Values

REQUIRE_CERTIFICATE

public static final java.lang.String REQUIRE_CERTIFICATE

See Also:

Constant Field Values

SELF_REGISTERED

public static final java.lang.String SELF_REGISTERED

See Also:

Constant Field Values

GROUP_TYPE_ADMIN

public static final java.lang.String GROUP_TYPE_ADMIN

See Also:

Constant Field Values

GROUP_TYPE_SUBMIT

public static final java.lang.String GROUP_TYPE_SUBMIT

See Also:

Constant Field Values

GROUP_TYPE_WORKFLOW_STEP_1

public static final java.lang.String GROUP_TYPE_WORKFLOW_STEP_1

See Also:

Constant Field Values

GROUP_TYPE_WORKFLOW_STEP_2

public static final java.lang.String GROUP_TYPE_WORKFLOW_STEP_2

See Also:

Constant Field Values

GROUP_TYPE_WORKFLOW_STEP_3

public static final java.lang.String GROUP_TYPE_WORKFLOW_STEP_3

See Also:

Constant Field Values

Constructor Detail

RoleDisseminator

public RoleDisseminator()

Method Detail

disseminate

public void disseminate(Context context,
               DSpaceObject object,
               PackageParameters params,
               java.io.File pkgFile)
                 throws PackageException,
                        CrosswalkException,
                        AuthorizeException,
                        java.sql.SQLException,
                        java.io.IOException

Description copied from interface: PackageDisseminator

Export the object (Item, Collection, or Community) as a "package" on the indicated OutputStream. Package is any serialized representation of the item, at the discretion of the implementing class. It does not have to include content bitstreams.

Use the params parameter list to adjust the way the package is made, e.g. including a "metadataOnly" parameter might make the package a bare manifest in XML instead of a Zip file including manifest and contents.

Throws an exception of the chosen object is not acceptable or there is a failure creating the package.

Specified by:

disseminate in interface PackageDisseminator

Parameters:

context - DSpace context.

object - DSpace object (item, collection, etc)

params - Properties-style list of options specific to this packager

pkgFile - File where export package should be written

Throws:

PackageValidationException - if package cannot be created or there is a fatal error in creating it.

PackageException

CrosswalkException

AuthorizeException

java.sql.SQLException

java.io.IOException

disseminateAll

public java.util.List<java.io.File> disseminateAll(Context context,
                                          DSpaceObject dso,
                                          PackageParameters params,
                                          java.io.File pkgFile)
                                            throws PackageException,
                                                   CrosswalkException,
                                                   AuthorizeException,
                                                   java.sql.SQLException,
                                                   java.io.IOException

Description copied from interface: PackageDisseminator

Recursively export one or more DSpace Objects as a series of packages. This method will export the given DSpace Object as well as all referenced DSpaceObjects (e.g. child objects) into a series of packages. The initial object is exported to the location specified by the pkgFile. All other generated packages are recursively exported to the same directory.

Package is any serialized representation of the item, at the discretion of the implementing class. It does not have to include content bitstreams.

Use the params parameter list to adjust the way the package is made, e.g. including a "metadataOnly" parameter might make the package a bare manifest in XML instead of a Zip file including manifest and contents.

Throws an exception of the initial object is not acceptable or there is a failure creating the packages.

A packager may choose not to implement disseminateAll, or simply forward the call to disseminate if it is unable to support recursive dissemination.

Specified by:

disseminateAll in interface PackageDisseminator

Parameters:

context - DSpace context.

dso - initial DSpace object

params - Properties-style list of options specific to this packager

pkgFile - File where initial package should be written. All other packages will be written to the same directory as this File.

Returns:

List of all package Files which were successfully disseminated

Throws:

PackageValidationException - if package cannot be created or there is a fatal error in creating it.

PackageException

CrosswalkException

AuthorizeException

java.sql.SQLException

java.io.IOException

getMIMEType

public java.lang.String getMIMEType(PackageParameters params)

Description copied from interface: PackageDisseminator

Identifies the MIME-type of this package, e.g. "application/zip". Required when sending the package via HTTP, to provide the Content-Type header.

Specified by:

getMIMEType in interface PackageDisseminator

Returns:

the MIME type (content-type header) of the package to be returned

getParameterHelp

public java.lang.String getParameterHelp()

Returns a user help string which should describe the additional valid command-line options that this packager implementation will accept when using the -o or --option flags with the Packager script.

Specified by:

getParameterHelp in interface PackageDisseminator

Returns:

a string describing additional command-line options available with this packager