org.dspace.content

Class Item

java.lang.Object

org.dspace.content.DSpaceObject

org.dspace.content.Item

public class Item
extends DSpaceObject

Class representing an item in DSpace.

This class holds in memory the item Dublin Core metadata, the bundles in the item, and the bitstreams in those bundles. When modifying the item, if you modify the Dublin Core or the "in archive" flag, you must call update for the changes to be written to the database. Creating, adding or removing bundles or bitstreams has immediate effect in the database.

Version:

$Revision$

Author:

Robert Tansley, Martin Hald

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ANY Wild card for Dublin Core metadata qualifiers/languages

Method Summary

Methods

Modifier and Type	Method and Description
void	addBundle(Bundle b) Add an existing bundle to this item.
void	addDC(java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String value) Deprecated.
void	addDC(java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String[] values) Deprecated.
void	addMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String value) Add a single metadata field.
void	addMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String[] values) Add metadata fields.
void	addMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String[] values, java.lang.String[] authorities, int[] confidences) Add metadata fields.
void	addMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang, java.lang.String value, java.lang.String authority, int confidence) Add a single metadata field.
void	adjustBundleBitstreamPolicies(Collection c)
void	adjustItemPolicies(Collection c)
boolean	canEdit() return TRUE if context's user can edit item, false otherwise
void	clearDC(java.lang.String element, java.lang.String qualifier, java.lang.String lang) Deprecated.
void	clearMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang) Clear metadata values.
Bundle	createBundle(java.lang.String name) Create a bundle in this item, with immediate effect
Bitstream	createSingleBitstream(java.io.InputStream is) Convenience method, calls createSingleBitstream() with name "ORIGINAL"
Bitstream	createSingleBitstream(java.io.InputStream is, java.lang.String name) Create a single bitstream in a new bundle.
void	decache() Remove item and all its sub-structure from the context cache.
boolean	equals(java.lang.Object obj) Return true if other is the same Item as this object, false otherwise
static Item	find(Context context, int id) Get an item from the database.
static ItemIterator	findAll(Context context) Get all the items in the archive.
static ItemIterator	findAllUnfiltered(Context context) Get all "final" items in the archive, both archived ("in archive" flag) or withdrawn items are included.
static ItemIterator	findByAuthorityValue(Context context, java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String value) Find all the items in the archive with a given authority key value in the indicated metadata field.
static ItemIterator	findByMetadataField(Context context, java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String value) Returns an iterator of Items possessing the passed metadata field, or only those matching the passed value, if value is not Item.ANY
static ItemIterator	findBySubmitter(Context context, EPerson eperson) Find all the items in the archive by a given submitter.
DSpaceObject	getAdminObject(int action) Return the dspace object where an ADMIN action right is sufficient to grant the initial authorize check.
Bundle[]	getBundles() Get the bundles in this item.
Bundle[]	getBundles(java.lang.String name) Get the bundles matching a bundle name (name corresponds roughly to type)
Collection[]	getCollections() Get the collections this item is in.
Collection[]	getCollectionsNotLinked() Get the collections this item is not in.
Community[]	getCommunities() Get the communities this item is in.
DCValue[]	getDC(java.lang.String element, java.lang.String qualifier, java.lang.String lang) Deprecated.
java.lang.String	getHandle() Get the Handle of the object.
int	getID() Get the internal ID of this item.
java.util.Date	getLastModified() Get the date the item was last modified, or the current date if last_modified is null
DCValue[]	getMetadata(java.lang.String mdString) Retrieve metadata field values from a given metadata string of the form .[.|.*]
DCValue[]	getMetadata(java.lang.String schema, java.lang.String element, java.lang.String qualifier, java.lang.String lang) Get metadata for the item in a chosen schema.
java.lang.String	getName() Get a proper name for the object.
Bitstream[]	getNonInternalBitstreams() Get all non-internal bitstreams in the item.
Collection	getOwningCollection() Get the owning Collection for the item
DSpaceObject	getParentObject() Return the dspace object that "own" the current object in the hierarchy.
EPerson	getSubmitter() Get the e-person that originally submitted this item
int	getType() return type found in Constants
int	hashCode()
boolean	hasUploadedFiles() Check the bundle ORIGINAL to see if there are any uploaded files
void	inheritCollectionDefaultPolicies(Collection c) remove all policies on an item and its contents, and replace them with the DEFAULT_ITEM_READ and DEFAULT_BITSTREAM_READ policies belonging to the collection.
boolean	isArchived() Find out if the item is part of the main archive
boolean	isDiscoverable() Find out if the item is discoverable
boolean	isIn(Collection collection) See whether this Item is contained by a given Collection.
boolean	isOwningCollection(Collection c) Return true if this Collection 'owns' this item
boolean	isWithdrawn() Find out if the item has been withdrawn
void	move(Collection from, Collection to) Moves the item from one collection to another one
void	move(Collection from, Collection to, boolean inheritDefaultPolicies) Moves the item from one collection to another one
void	reinstate() Reinstate a withdrawn item
void	removeBundle(Bundle b) Remove a bundle.
void	removeDSpaceLicense() Remove just the DSpace license from an item This is useful to update the current DSpace license, in case the user must accept the DSpace license again (either the item was rejected, or resumed after saving)
void	removeGroupPolicies(Group g) remove all of the policies for item's bitstreams and bundles that belong to a given Group
void	removeLicenses() Remove all licenses from an item - it was rejected
void	replaceAllBitstreamPolicies(java.util.List<ResourcePolicy> newpolicies) remove all of the policies for item's bitstreams and bundles and replace them with a new list of policies
void	replaceAllItemPolicies(java.util.List<ResourcePolicy> newpolicies) remove all of the policies for item and replace them with a new list of policies
void	setArchived(boolean isArchived) Set the "is_archived" flag.
void	setDiscoverable(boolean discoverable) Set the "discoverable" flag.
void	setOwningCollection(Collection c) Set the owning Collection for the item
void	setSubmitter(EPerson sub) Set the e-person that originally submitted this item.
void	update() Update the item "in archive" flag and Dublin Core metadata in the database
void	updateLastModified() Method that updates the last modified date of the item
void	withdraw() Withdraw the item from the archive.

Methods inherited from class org.dspace.content.DSpaceObject

addDetails, clearDetails, find, getDetails, getTypeText

Methods inherited from class java.lang.Object

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

Field Detail

ANY

public static final java.lang.String ANY

Wild card for Dublin Core metadata qualifiers/languages

See Also:

Constant Field Values

Method Detail

find

public static Item find(Context context,
        int id)
                 throws java.sql.SQLException

Get an item from the database. The item, its Dublin Core metadata, and the bundle and bitstream metadata are all loaded into memory.

Parameters:

context - DSpace context object

id - Internal ID of the item

Returns:

the item, or null if the internal ID is invalid.

Throws:

java.sql.SQLException

findAll

public static ItemIterator findAll(Context context)
                            throws java.sql.SQLException

Get all the items in the archive. Only items with the "in archive" flag set are included. The order of the list is indeterminate.

Parameters:

context - DSpace context object

Returns:

an iterator over the items in the archive.

Throws:

java.sql.SQLException

findAllUnfiltered

public static ItemIterator findAllUnfiltered(Context context)
                                      throws java.sql.SQLException

Get all "final" items in the archive, both archived ("in archive" flag) or withdrawn items are included. The order of the list is indeterminate.

Parameters:

context - DSpace context object

Returns:

an iterator over the items in the archive.

Throws:

java.sql.SQLException

findBySubmitter

public static ItemIterator findBySubmitter(Context context,
                           EPerson eperson)
                                    throws java.sql.SQLException

Find all the items in the archive by a given submitter. The order is indeterminate. Only items with the "in archive" flag set are included.

Parameters:

context - DSpace context object

eperson - the submitter

Returns:

an iterator over the items submitted by eperson

Throws:

java.sql.SQLException

getID

public int getID()

Get the internal ID of this item. In general, this shouldn't be exposed to users

Specified by:

getID in class DSpaceObject

Returns:

the internal identifier

getHandle

public java.lang.String getHandle()

Description copied from class: DSpaceObject

Get the Handle of the object. This may return null

Specified by:

getHandle in class DSpaceObject

Returns:

Handle of the object, or null if it doesn't have one

See Also:

DSpaceObject.getHandle()

isArchived

public boolean isArchived()

Find out if the item is part of the main archive

Returns:

true if the item is in the main archive

isWithdrawn

public boolean isWithdrawn()

Find out if the item has been withdrawn

Returns:

true if the item has been withdrawn

isDiscoverable

public boolean isDiscoverable()

Find out if the item is discoverable

Returns:

true if the item is discoverable

getLastModified

public java.util.Date getLastModified()

Get the date the item was last modified, or the current date if last_modified is null

Returns:

the date the item was last modified, or the current date if the column is null.

updateLastModified

public void updateLastModified()

Method that updates the last modified date of the item

Specified by:

updateLastModified in class DSpaceObject

setArchived

public void setArchived(boolean isArchived)

Set the "is_archived" flag. This is public and only WorkflowItem.archive() should set this.

Parameters:

isArchived - new value for the flag

setDiscoverable

public void setDiscoverable(boolean discoverable)

Set the "discoverable" flag. This is public and only

Parameters:

discoverable - new value for the flag

setOwningCollection

public void setOwningCollection(Collection c)

Set the owning Collection for the item

Parameters:

c - Collection

getOwningCollection

public Collection getOwningCollection()
                               throws java.sql.SQLException

Get the owning Collection for the item

Returns:

Collection that is the owner of the item

Throws:

java.sql.SQLException

getDC

@Deprecated
public DCValue[] getDC(java.lang.String element,
                         java.lang.String qualifier,
                         java.lang.String lang)

Deprecated.

Get Dublin Core metadata for the item. Passing in a null value for qualifier or lang only matches Dublin Core fields where that qualifier or languages is actually null. Passing in Item.ANY retrieves all metadata fields with any value for the qualifier or language, including null

Examples:

Return values of the unqualified "title" field, in any language. Qualified title fields (e.g. "title.uniform") are NOT returned:

item.getDC( "title", null, Item.ANY );

Return all US English values of the "title" element, with any qualifier (including unqualified):

item.getDC( "title", Item.ANY, "en_US" );

The ordering of values of a particular element/qualifier/language combination is significant. When retrieving with wildcards, values of a particular element/qualifier/language combinations will be adjacent, but the overall ordering of the combinations is indeterminate.

Parameters:

element - the Dublin Core element. Item.ANY matches any element. null doesn't really make sense as all DC must have an element.

qualifier - the qualifier. null means unqualified, and Item.ANY means any qualifier (including unqualified.)

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means only values with no language are returned, and Item.ANY means values with any country code or no country code are returned.

Returns:

Dublin Core fields that match the parameters

getMetadata

public DCValue[] getMetadata(java.lang.String schema,
                    java.lang.String element,
                    java.lang.String qualifier,
                    java.lang.String lang)

Get metadata for the item in a chosen schema. See MetadataSchema for more information about schemas. Passing in a null value for qualifier or lang only matches metadata fields where that qualifier or languages is actually null. Passing in Item.ANY retrieves all metadata fields with any value for the qualifier or language, including null

Examples:

Return values of the unqualified "title" field, in any language. Qualified title fields (e.g. "title.uniform") are NOT returned:

item.getMetadata("dc", "title", null, Item.ANY );

Return all US English values of the "title" element, with any qualifier (including unqualified):

item.getMetadata("dc, "title", Item.ANY, "en_US" );

The ordering of values of a particular element/qualifier/language combination is significant. When retrieving with wildcards, values of a particular element/qualifier/language combinations will be adjacent, but the overall ordering of the combinations is indeterminate.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the element name. Item.ANY matches any element. null doesn't really make sense as all metadata must have an element.

qualifier - the qualifier. null means unqualified, and Item.ANY means any qualifier (including unqualified.)

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means only values with no language are returned, and Item.ANY means values with any country code or no country code are returned.

Returns:

metadata fields that match the parameters

getMetadata

public DCValue[] getMetadata(java.lang.String mdString)

Retrieve metadata field values from a given metadata string of the form .[.|.*]

Parameters:

mdString - The metadata string of the form .[.|.*]

addDC

@Deprecated
public void addDC(java.lang.String element,
                    java.lang.String qualifier,
                    java.lang.String lang,
                    java.lang.String[] values)

Deprecated.

Add Dublin Core metadata fields. These are appended to existing values. Use clearDC to remove values. The ordering of values passed in is maintained.

Parameters:

element - the Dublin Core element

qualifier - the Dublin Core qualifier, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

values - the values to add.

addDC

@Deprecated
public void addDC(java.lang.String element,
                    java.lang.String qualifier,
                    java.lang.String lang,
                    java.lang.String value)

Deprecated.

Add a single Dublin Core metadata field. This is appended to existing values. Use clearDC to remove values.

Parameters:

element - the Dublin Core element

qualifier - the Dublin Core qualifier, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

value - the value to add.

addMetadata

public void addMetadata(java.lang.String schema,
               java.lang.String element,
               java.lang.String qualifier,
               java.lang.String lang,
               java.lang.String[] values)

Add metadata fields. These are appended to existing values. Use clearDC to remove values. The ordering of values passed in is maintained.

If metadata authority control is available, try to get authority values. The authority confidence depends on whether authority is required or not.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the metadata element name

qualifier - the metadata qualifier name, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

values - the values to add.

addMetadata

public void addMetadata(java.lang.String schema,
               java.lang.String element,
               java.lang.String qualifier,
               java.lang.String lang,
               java.lang.String[] values,
               java.lang.String[] authorities,
               int[] confidences)

Add metadata fields. These are appended to existing values. Use clearDC to remove values. The ordering of values passed in is maintained.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the metadata element name

qualifier - the metadata qualifier name, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

values - the values to add.

authorities - the external authority key for this value (or null)

confidences - the authority confidence (default 0)

addMetadata

public void addMetadata(java.lang.String schema,
               java.lang.String element,
               java.lang.String qualifier,
               java.lang.String lang,
               java.lang.String value)

Add a single metadata field. This is appended to existing values. Use clearDC to remove values.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the metadata element name

qualifier - the metadata qualifier, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

value - the value to add.

addMetadata

public void addMetadata(java.lang.String schema,
               java.lang.String element,
               java.lang.String qualifier,
               java.lang.String lang,
               java.lang.String value,
               java.lang.String authority,
               int confidence)

Add a single metadata field. This is appended to existing values. Use clearDC to remove values.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the metadata element name

qualifier - the metadata qualifier, or null for unqualified

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means the value has no language (for example, a date).

value - the value to add.

authority - the external authority key for this value (or null)

confidence - the authority confidence (default 0)

clearDC

@Deprecated
public void clearDC(java.lang.String element,
                      java.lang.String qualifier,
                      java.lang.String lang)

Deprecated.

Clear Dublin Core metadata values. As with getDC above, passing in null only matches fields where the qualifier or language is actually null.Item.ANY will match any element, qualifier or language, including null. Thus, item.clearDC(Item.ANY, Item.ANY, Item.ANY) will remove all Dublin Core metadata associated with an item.

Parameters:

element - the Dublin Core element to remove, or Item.ANY

qualifier - the qualifier. null means unqualified, and Item.ANY means any qualifier (including unqualified.)

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means only values with no language are removed, and Item.ANY means values with any country code or no country code are removed.

clearMetadata

public void clearMetadata(java.lang.String schema,
                 java.lang.String element,
                 java.lang.String qualifier,
                 java.lang.String lang)

Clear metadata values. As with getDC above, passing in null only matches fields where the qualifier or language is actually null.Item.ANY will match any element, qualifier or language, including null. Thus, item.clearDC(Item.ANY, Item.ANY, Item.ANY) will remove all Dublin Core metadata associated with an item.

Parameters:

schema - the schema for the metadata field. Must match the name of an existing metadata schema.

element - the Dublin Core element to remove, or Item.ANY

qualifier - the qualifier. null means unqualified, and Item.ANY means any qualifier (including unqualified.)

lang - the ISO639 language code, optionally followed by an underscore and the ISO3166 country code. null means only values with no language are removed, and Item.ANY means values with any country code or no country code are removed.

getSubmitter

public EPerson getSubmitter()
                     throws java.sql.SQLException

Get the e-person that originally submitted this item

Returns:

the submitter

Throws:

java.sql.SQLException

setSubmitter

public void setSubmitter(EPerson sub)

Set the e-person that originally submitted this item. This is a public method since it is handled by the WorkspaceItem class in the ingest package. update must be called to write the change to the database.

Parameters:

sub - the submitter

isIn

public boolean isIn(Collection collection)
             throws java.sql.SQLException

See whether this Item is contained by a given Collection.

Parameters:

collection -

Returns:

true if collection contains this Item.

Throws:

java.sql.SQLException

getCollections

public Collection[] getCollections()
                            throws java.sql.SQLException

Get the collections this item is in. The order is indeterminate.

Returns:

the collections this item is in, if any.

Throws:

java.sql.SQLException

getCommunities

public Community[] getCommunities()
                           throws java.sql.SQLException

Get the communities this item is in. Returns an unordered array of the communities that house the collections this item is in, including parent communities of the owning collections.

Returns:

the communities this item is in.

Throws:

java.sql.SQLException

getBundles

public Bundle[] getBundles()
                    throws java.sql.SQLException

Get the bundles in this item.

Returns:

the bundles in an unordered array

Throws:

java.sql.SQLException

getBundles

public Bundle[] getBundles(java.lang.String name)
                    throws java.sql.SQLException

Get the bundles matching a bundle name (name corresponds roughly to type)

Parameters:

name - name of bundle (ORIGINAL/TEXT/THUMBNAIL)

Returns:

the bundles in an unordered array

Throws:

java.sql.SQLException

createBundle

public Bundle createBundle(java.lang.String name)
                    throws java.sql.SQLException,
                           AuthorizeException

Create a bundle in this item, with immediate effect

Parameters:

name - bundle name (ORIGINAL/TEXT/THUMBNAIL)

Returns:

the newly created bundle

Throws:

java.sql.SQLException

AuthorizeException

addBundle

public void addBundle(Bundle b)
               throws java.sql.SQLException,
                      AuthorizeException

Add an existing bundle to this item. This has immediate effect.

Parameters:

b - the bundle to add

Throws:

java.sql.SQLException

AuthorizeException

removeBundle

public void removeBundle(Bundle b)
                  throws java.sql.SQLException,
                         AuthorizeException,
                         java.io.IOException

Remove a bundle. This may result in the bundle being deleted, if the bundle is orphaned.

Parameters:

b - the bundle to remove

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

createSingleBitstream

public Bitstream createSingleBitstream(java.io.InputStream is,
                              java.lang.String name)
                                throws AuthorizeException,
                                       java.io.IOException,
                                       java.sql.SQLException

Create a single bitstream in a new bundle. Provided as a convenience method for the most common use.

Parameters:

is - the stream to create the new bitstream from

name - is the name of the bundle (ORIGINAL, TEXT, THUMBNAIL)

Returns:

Bitstream that is created

Throws:

AuthorizeException

java.io.IOException

java.sql.SQLException

createSingleBitstream

public Bitstream createSingleBitstream(java.io.InputStream is)
                                throws AuthorizeException,
                                       java.io.IOException,
                                       java.sql.SQLException

Convenience method, calls createSingleBitstream() with name "ORIGINAL"

Parameters:

is - InputStream

Returns:

created bitstream

Throws:

AuthorizeException

java.io.IOException

java.sql.SQLException

getNonInternalBitstreams

public Bitstream[] getNonInternalBitstreams()
                                     throws java.sql.SQLException

Get all non-internal bitstreams in the item. This is mainly used for auditing for provenance messages and adding format.* DC values. The order is indeterminate.

Returns:

non-internal bitstreams.

Throws:

java.sql.SQLException

removeDSpaceLicense

public void removeDSpaceLicense()
                         throws java.sql.SQLException,
                                AuthorizeException,
                                java.io.IOException

Remove just the DSpace license from an item This is useful to update the current DSpace license, in case the user must accept the DSpace license again (either the item was rejected, or resumed after saving)

This method is used by the org.dspace.submit.step.LicenseStep class

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

removeLicenses

public void removeLicenses()
                    throws java.sql.SQLException,
                           AuthorizeException,
                           java.io.IOException

Remove all licenses from an item - it was rejected

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

update

public void update()
            throws java.sql.SQLException,
                   AuthorizeException

Update the item "in archive" flag and Dublin Core metadata in the database

Specified by:

update in class DSpaceObject

Throws:

java.sql.SQLException

AuthorizeException

withdraw

public void withdraw()
              throws java.sql.SQLException,
                     AuthorizeException,
                     java.io.IOException

Withdraw the item from the archive. It is kept in place, and the content and metadata are not deleted, but it is not publicly accessible.

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

reinstate

public void reinstate()
               throws java.sql.SQLException,
                      AuthorizeException,
                      java.io.IOException

Reinstate a withdrawn item

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

decache

public void decache()
             throws java.sql.SQLException

Remove item and all its sub-structure from the context cache. Useful in batch processes where a single context has a long, multi-item lifespan

Throws:

java.sql.SQLException

equals

public boolean equals(java.lang.Object obj)

Return true if other is the same Item as this object, false otherwise

Overrides:

equals in class java.lang.Object

Parameters:

obj - object to compare to

Returns:

true if object passed in represents the same item as this object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

isOwningCollection

public boolean isOwningCollection(Collection c)

Return true if this Collection 'owns' this item

Parameters:

c - Collection

Returns:

true if this Collection owns this item

getType

public int getType()

return type found in Constants

Specified by:

getType in class DSpaceObject

Returns:

int Constants.ITEM

replaceAllItemPolicies

public void replaceAllItemPolicies(java.util.List<ResourcePolicy> newpolicies)
                            throws java.sql.SQLException,
                                   AuthorizeException

remove all of the policies for item and replace them with a new list of policies

Parameters:

newpolicies - - this will be all of the new policies for the item and its contents

Throws:

java.sql.SQLException

AuthorizeException

replaceAllBitstreamPolicies

public void replaceAllBitstreamPolicies(java.util.List<ResourcePolicy> newpolicies)
                                 throws java.sql.SQLException,
                                        AuthorizeException

remove all of the policies for item's bitstreams and bundles and replace them with a new list of policies

Parameters:

newpolicies - - this will be all of the new policies for the bundle and bitstream contents

Throws:

java.sql.SQLException

AuthorizeException

removeGroupPolicies

public void removeGroupPolicies(Group g)
                         throws java.sql.SQLException

remove all of the policies for item's bitstreams and bundles that belong to a given Group

Parameters:

g - Group referenced by policies that needs to be removed

Throws:

java.sql.SQLException

inheritCollectionDefaultPolicies

public void inheritCollectionDefaultPolicies(Collection c)
                                      throws java.sql.SQLException,
                                             AuthorizeException

remove all policies on an item and its contents, and replace them with the DEFAULT_ITEM_READ and DEFAULT_BITSTREAM_READ policies belonging to the collection.

Parameters:

c - Collection

Throws:

java.sql.SQLException - if an SQL error or if no default policies found. It's a bit draconian, but default policies must be enforced.

AuthorizeException

adjustBundleBitstreamPolicies

public void adjustBundleBitstreamPolicies(Collection c)
                                   throws java.sql.SQLException,
                                          AuthorizeException

Throws:

java.sql.SQLException

AuthorizeException

adjustItemPolicies

public void adjustItemPolicies(Collection c)
                        throws java.sql.SQLException,
                               AuthorizeException

Throws:

java.sql.SQLException

AuthorizeException

move

public void move(Collection from,
        Collection to)
          throws java.sql.SQLException,
                 AuthorizeException,
                 java.io.IOException

Moves the item from one collection to another one

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

move

public void move(Collection from,
        Collection to,
        boolean inheritDefaultPolicies)
          throws java.sql.SQLException,
                 AuthorizeException,
                 java.io.IOException

Moves the item from one collection to another one

Throws:

java.sql.SQLException

AuthorizeException

java.io.IOException

hasUploadedFiles

public boolean hasUploadedFiles()
                         throws java.sql.SQLException

Check the bundle ORIGINAL to see if there are any uploaded files

Returns:

true if there is a bundle named ORIGINAL with one or more bitstreams inside

Throws:

java.sql.SQLException

getCollectionsNotLinked

public Collection[] getCollectionsNotLinked()
                                     throws java.sql.SQLException

Get the collections this item is not in.

Returns:

the collections this item is not in, if any.

Throws:

java.sql.SQLException

canEdit

public boolean canEdit()
                throws java.sql.SQLException

return TRUE if context's user can edit item, false otherwise

Returns:

boolean true = current user can edit item

Throws:

java.sql.SQLException

getName

public java.lang.String getName()

Description copied from class: DSpaceObject

Get a proper name for the object. This may return null. Name should be suitable for display in a user interface.

Specified by:

getName in class DSpaceObject

Returns:

Name for the object, or null if it doesn't have one

findByMetadataField

public static ItemIterator findByMetadataField(Context context,
                               java.lang.String schema,
                               java.lang.String element,
                               java.lang.String qualifier,
                               java.lang.String value)
                                        throws java.sql.SQLException,
                                               AuthorizeException,
                                               java.io.IOException

Returns an iterator of Items possessing the passed metadata field, or only those matching the passed value, if value is not Item.ANY

Parameters:

context - DSpace context object

schema - metadata field schema

element - metadata field element

qualifier - metadata field qualifier

value - field value or Item.ANY to match any value

Returns:

an iterator over the items matching that authority value

Throws:

SQLException, - AuthorizeException, IOException

java.sql.SQLException

AuthorizeException

java.io.IOException

getAdminObject

public DSpaceObject getAdminObject(int action)
                            throws java.sql.SQLException

Description copied from class: DSpaceObject

Return the dspace object where an ADMIN action right is sufficient to grant the initial authorize check.

Default behaviour is ADMIN right on the object grant right on all other action on the object itself. Subclass should override this method as needed.

Overrides:

getAdminObject in class DSpaceObject

Parameters:

action - ID of action being attempted, from org.dspace.core.Constants. The ADMIN action is not a valid parameter for this method, an IllegalArgumentException should be thrown

Returns:

the dspace object, if any, where an ADMIN action is sufficient to grant the original action

Throws:

java.sql.SQLException

getParentObject

public DSpaceObject getParentObject()
                             throws java.sql.SQLException

Description copied from class: DSpaceObject

Return the dspace object that "own" the current object in the hierarchy. Note that this method has a meaning slightly different from the getAdminObject because it is independent of the action but it is in a way related to it. It defines the "first" dspace object OTHER then the current one, where allowed ADMIN actions imply allowed ADMIN actions on the object self.

Overrides:

getParentObject in class DSpaceObject

Returns:

the dspace object that "own" the current object in the hierarchy

Throws:

java.sql.SQLException

findByAuthorityValue

public static ItemIterator findByAuthorityValue(Context context,
                                java.lang.String schema,
                                java.lang.String element,
                                java.lang.String qualifier,
                                java.lang.String value)
                                         throws java.sql.SQLException,
                                                AuthorizeException,
                                                java.io.IOException

Find all the items in the archive with a given authority key value in the indicated metadata field.

Parameters:

context - DSpace context object

schema - metadata field schema

element - metadata field element

qualifier - metadata field qualifier

value - the value of authority key to look for

Returns:

an iterator over the items matching that authority value

Throws:

SQLException, - AuthorizeException, IOException

java.sql.SQLException

AuthorizeException

java.io.IOException