FlowContainerUtils (DSpace XML-UI (Manakin) :: API and Core Aspects 1.6.0-rc2 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.dspace.app.xmlui.aspect.administrative
Class FlowContainerUtils

java.lang.Object
  org.dspace.app.xmlui.aspect.administrative.FlowContainerUtils

public class FlowContainerUtils
extends Object
extends Object

Utility methods to processes actions on Communities and Collections.

Author:: scott phillips

Field Summary
`static String`	`ROLE_ADMIN` Possible Collection roles
`static String`	`ROLE_DEFAULT_READ`
`static String`	`ROLE_SUBMIT`
`static String`	`ROLE_WF_STEP1`
`static String`	`ROLE_WF_STEP2`
`static String`	`ROLE_WF_STEP3`

Constructor Summary
`FlowContainerUtils()`

Method Summary
`static FlowResult`	`changeCollectionDefaultReadToAnonymous(Context context, int collectionID)` Change the default read priveleges to the anonymous group.
`static String`	`checkXMLFragment(String value)` Check whether this metadata value is a proper XML fragment.
`static int`	`createCollectionDefaultReadGroup(Context context, int collectionID)` Change default privleges from the anonymous group to a new group that will be created and approrpate privleges assigned.
`static String`	`escapeXMLEntities(String value)` Sanatize any XML that was inputed by the user, this will clean up any unescaped characters so that they can be stored as proper XML.
`static int`	`getCollectionDefaultRead(Context context, int collectionID)` Look up the id of a group authorized for one of the given roles.
`static int`	`getCollectionRole(Context context, int collectionID, String roleName)` Look up the id of a group authorized for one of the given roles.
`static int`	`getCommunityRole(Context context, int communityID, String roleName)` Look up the id of a group authorized for one of the given roles.
`static int`	`getTemplateItemID(Context context, int collectionID)` Look up the id of the template item for a given collection.
`static FlowResult`	`processCreateCollection(Context context, int communityID, org.apache.cocoon.environment.Request request)` Create a new collection
`static FlowResult`	`processCreateCommunity(Context context, int communityID, org.apache.cocoon.environment.Request request)` Create a new community
`static FlowResult`	`processDeleteCollection(Context context, int collectionID)` Delete collection itself
`static FlowResult`	`processDeleteCollectionRole(Context context, int collectionID, String roleName, int groupID)` Delete one of collection's roles
`static FlowResult`	`processDeleteCommunity(Context context, int communityID)` Delete community itself
`static FlowResult`	`processDeleteCommunityRole(Context context, int communityID, String roleName, int groupID)` Delete one of a community's roles
`static FlowResult`	`processDeleteTemplateItem(Context context, int collectionID)` Delete a collection's template item (which is not a member of the collection).
`static FlowResult`	`processEditCollection(Context context, int collectionID, boolean deleteLogo, org.apache.cocoon.environment.Request request)` Process the collection metadata edit form.
`static FlowResult`	`processEditCommunity(Context context, int communityID, boolean deleteLogo, org.apache.cocoon.environment.Request request)` Process the community metadata edit form.
`static FlowResult`	`processReimportCollection(Context context, int collectionID, org.apache.cocoon.environment.Request request)` Purge the collection of all items, then run a fresh harvest cycle.
`static FlowResult`	`processRunCollectionHarvest(Context context, int collectionID, org.apache.cocoon.environment.Request request)` Use the collection's harvest settings to immediately perform a harvest cycle.
`static FlowResult`	`processSetupCollectionHarvesting(Context context, int collectionID, org.apache.cocoon.environment.Request request)` Process the collection harvesting options form.
`static FlowResult`	`testOAISettings(Context context, org.apache.cocoon.environment.Request request)` Test the supplied OAI settings.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

ROLE_ADMIN

public static final String ROLE_ADMIN

Possible Collection roles

See Also:: Constant Field Values

ROLE_WF_STEP1

public static final String ROLE_WF_STEP1

See Also:: Constant Field Values

ROLE_WF_STEP2

public static final String ROLE_WF_STEP2

See Also:: Constant Field Values

ROLE_WF_STEP3

public static final String ROLE_WF_STEP3

See Also:: Constant Field Values

ROLE_SUBMIT

public static final String ROLE_SUBMIT

See Also:: Constant Field Values

ROLE_DEFAULT_READ

public static final String ROLE_DEFAULT_READ

See Also:: Constant Field Values

Constructor Detail

FlowContainerUtils

public FlowContainerUtils()

Method Detail

processEditCollection

public static FlowResult processEditCollection(Context context,
                                               int collectionID,
                                               boolean deleteLogo,
                                               org.apache.cocoon.environment.Request request)
                                        throws SQLException,
                                               IOException,
                                               AuthorizeException

Process the collection metadata edit form.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; deleteLogo - Determines if the logo should be deleted along with the metadata editing action.; request - the Cocoon request object
Returns:: A process result's object.
Throws:: SQLException; IOException; AuthorizeException

processSetupCollectionHarvesting

public static FlowResult processSetupCollectionHarvesting(Context context,
                                                          int collectionID,
                                                          org.apache.cocoon.environment.Request request)
                                                   throws SQLException,
                                                          IOException,
                                                          AuthorizeException

Process the collection harvesting options form.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; request - the Cocoon request object
Returns:: A process result's object.
Throws:: SQLException; IOException; AuthorizeException

processRunCollectionHarvest

public static FlowResult processRunCollectionHarvest(Context context,
                                                     int collectionID,
                                                     org.apache.cocoon.environment.Request request)
                                              throws SQLException,
                                                     IOException,
                                                     AuthorizeException,
                                                     CrosswalkException,
                                                     ParserConfigurationException,
                                                     SAXException,
                                                     TransformerException

Use the collection's harvest settings to immediately perform a harvest cycle.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; request - the Cocoon request object
Returns:: A process result's object.
Throws:: TransformerException; SAXException; ParserConfigurationException; CrosswalkException; SQLException; IOException; AuthorizeException

processReimportCollection

public static FlowResult processReimportCollection(Context context,
                                                   int collectionID,
                                                   org.apache.cocoon.environment.Request request)
                                            throws SQLException,
                                                   IOException,
                                                   AuthorizeException,
                                                   CrosswalkException,
                                                   ParserConfigurationException,
                                                   SAXException,
                                                   TransformerException,
                                                   BrowseException

Purge the collection of all items, then run a fresh harvest cycle.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; request - the Cocoon request object
Returns:: A process result's object.
Throws:: TransformerException; SAXException; ParserConfigurationException; CrosswalkException; BrowseException; SQLException; IOException; AuthorizeException

testOAISettings

public static FlowResult testOAISettings(Context context,
                                         org.apache.cocoon.environment.Request request)

Test the supplied OAI settings.

Parameters:: context -; request -
Returns:

getTemplateItemID

public static int getTemplateItemID(Context context,
                                    int collectionID)
                             throws SQLException,
                                    AuthorizeException,
                                    IOException

Look up the id of the template item for a given collection.

Parameters:: context - The current DSpace context.; collectionID - The collection id.
Returns:: The id of the template item.
Throws:: IOException; SQLException; AuthorizeException

getCollectionRole

public static int getCollectionRole(Context context,
                                    int collectionID,
                                    String roleName)
                             throws SQLException,
                                    AuthorizeException,
                                    IOException

Look up the id of a group authorized for one of the given roles. If no group is currently authorized to preform this role then a new group will be created and assigned the role.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; roleName - ADMIN, WF_STEP1, WF_STEP2, WF_STEP3, SUBMIT, DEFAULT_READ.
Returns:: The id of the group associated with that particular role, or -1 if the role was not found.
Throws:: SQLException; AuthorizeException; IOException

processDeleteCollectionRole

public static FlowResult processDeleteCollectionRole(Context context,
                                                     int collectionID,
                                                     String roleName,
                                                     int groupID)
                                              throws SQLException,
                                                     UIException,
                                                     IOException,
                                                     AuthorizeException

Delete one of collection's roles

Parameters:: context - The current DSpace context.; collectionID - The collection id.; roleName - ADMIN, WF_STEP1, WF_STEP2, WF_STEP3, SUBMIT, DEFAULT_READ.; groupID - The id of the group associated with this role.
Returns:: A process result's object.
Throws:: SQLException; UIException; IOException; AuthorizeException

getCollectionDefaultRead

public static int getCollectionDefaultRead(Context context,
                                           int collectionID)
                                    throws SQLException,
                                           AuthorizeException

Look up the id of a group authorized for one of the given roles. If no group is currently authorized to preform this role then a new group will be created and assigned the role.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; roleName - ADMIN, WF_STEP1, WF_STEP2, WF_STEP3, SUBMIT, DEFAULT_READ.
Returns:: The id of the group associated with that particular role.
Throws:: SQLException; AuthorizeException

createCollectionDefaultReadGroup

public static int createCollectionDefaultReadGroup(Context context,
                                                   int collectionID)
                                            throws SQLException,
                                                   AuthorizeException,
                                                   UIException

Change default privleges from the anonymous group to a new group that will be created and approrpate privleges assigned. The id of this new group will be returned.

Parameters:: context - The current DSpace context.; collectionID - The collection id.
Returns:: The group ID of the new group.
Throws:: SQLException; AuthorizeException; UIException

changeCollectionDefaultReadToAnonymous

public static FlowResult changeCollectionDefaultReadToAnonymous(Context context,
                                                                int collectionID)
                                                         throws SQLException,
                                                                AuthorizeException,
                                                                UIException

Change the default read priveleges to the anonymous group. If getCollectionDefaultRead() returns -1 or the anonymous group then nothing is done.

Parameters:: context - The current DSpace context.; collectionID - The collection id.
Returns:: A process result's object.
Throws:: SQLException; AuthorizeException; UIException

processDeleteCollection

public static FlowResult processDeleteCollection(Context context,
                                                 int collectionID)
                                          throws SQLException,
                                                 AuthorizeException,
                                                 IOException

Delete collection itself

Parameters:: context - The current DSpace context.; collectionID - The collection id.
Returns:: A process result's object.
Throws:: SQLException; AuthorizeException; IOException

processCreateCollection

public static FlowResult processCreateCollection(Context context,
                                                 int communityID,
                                                 org.apache.cocoon.environment.Request request)
                                          throws SQLException,
                                                 AuthorizeException,
                                                 IOException

Create a new collection

Parameters:: context - The current DSpace context.; communityID - The id of the parent community.
Returns:: A process result's object.
Throws:: SQLException; AuthorizeException; IOException

processCreateCommunity

public static FlowResult processCreateCommunity(Context context,
                                                int communityID,
                                                org.apache.cocoon.environment.Request request)
                                         throws AuthorizeException,
                                                IOException,
                                                SQLException

Create a new community

Parameters:: context - The current DSpace context.; communityID - The id of the parent community (-1 for a top-level community).
Returns:: A process result's object.
Throws:: AuthorizeException; IOException; SQLException

processEditCommunity

public static FlowResult processEditCommunity(Context context,
                                              int communityID,
                                              boolean deleteLogo,
                                              org.apache.cocoon.environment.Request request)
                                       throws AuthorizeException,
                                              IOException,
                                              SQLException

Process the community metadata edit form.

Parameters:: context - The current DSpace context.; communityID - The community id.; deleteLogo - Determines if the logo should be deleted along with the metadata editing action.; request - the Cocoon request object
Returns:: A process result's object.
Throws:: AuthorizeException; IOException; SQLException

processDeleteCommunity

public static FlowResult processDeleteCommunity(Context context,
                                                int communityID)
                                         throws SQLException,
                                                AuthorizeException,
                                                IOException

Delete community itself

Parameters:: context - The current DSpace context.; communityID - The community id.
Returns:: A process result's object.
Throws:: SQLException; AuthorizeException; IOException

getCommunityRole

public static int getCommunityRole(Context context,
                                   int communityID,
                                   String roleName)
                            throws SQLException,
                                   AuthorizeException,
                                   IOException

Look up the id of a group authorized for one of the given roles. If no group is currently authorized to perform this role then a new group will be created and assigned the role.

Parameters:: context - The current DSpace context.; collectionID - The collection id.; roleName - ADMIN.
Returns:: The id of the group associated with that particular role, or -1 if the role was not found.
Throws:: SQLException; AuthorizeException; IOException

processDeleteCommunityRole

public static FlowResult processDeleteCommunityRole(Context context,
                                                    int communityID,
                                                    String roleName,
                                                    int groupID)
                                             throws SQLException,
                                                    UIException,
                                                    IOException,
                                                    AuthorizeException

Delete one of a community's roles

Parameters:: context - The current DSpace context.; communityID - The community id.; roleName - ADMIN.; groupID - The id of the group associated with this role.
Returns:: A process result's object.
Throws:: SQLException; UIException; IOException; AuthorizeException

processDeleteTemplateItem

public static FlowResult processDeleteTemplateItem(Context context,
                                                   int collectionID)
                                            throws SQLException,
                                                   AuthorizeException,
                                                   IOException

Delete a collection's template item (which is not a member of the collection).

Parameters:: context -; collectionID -
Returns:
Throws:: SQLException; AuthorizeException; IOException

checkXMLFragment

public static String checkXMLFragment(String value)

Check whether this metadata value is a proper XML fragment. If the value is not then an error message will be returned that might (sometimes not) tell the user how to correct the problem.

Parameters:: value - The metadat's value
Returns:: An error string of the problem or null if there is no problem with the metadata's value.

escapeXMLEntities

public static String escapeXMLEntities(String value)

Sanatize any XML that was inputed by the user, this will clean up any unescaped characters so that they can be stored as proper XML. These are errors that in general we want to take care of on behalf of the user.

Parameters:: value - The unsantized value
Returns:: A sanatized value