org.dspace.content.service

Interface BitstreamService

All Superinterfaces:

DSpaceObjectLegacySupportService<Bitstream>, DSpaceObjectService<Bitstream>

All Known Implementing Classes:

BitstreamServiceImpl

public interface BitstreamService
extends DSpaceObjectService<Bitstream>, DSpaceObjectLegacySupportService<Bitstream>

Service interface class for the Bitstream object. The implementation of this class is responsible for all business logic calls for the Bitstream object and is autowired by spring

Author:

kevinvandevelde at atmire.com

Method Summary

Methods

Modifier and Type	Method and Description
int	countBitstreamsWithoutPolicy(Context context)
Long	countByStoreNumber(Context context, Integer storeNumber)
int	countDeletedBitstreams(Context context)
int	countTotal(Context context)
Bitstream	create(Context context, Bundle bundle, InputStream is) Create a new bitstream, with a new ID.
Bitstream	create(Context context, InputStream is) Create a new bitstream, with a new ID.
void	expunge(Context context, Bitstream bitstream) Remove a bitstream that has been set to "deleted" from the database
List<Bitstream>	findAll(Context context)
List<Bitstream>	findBitstreamsWithNoRecentChecksum(Context context)
Iterator<Bitstream>	findByStoreNumber(Context context, Integer storeNumber)
List<Bitstream>	findDeletedBitstreams(Context context) Retrieve all bitstreams with the deleted flag set to true
List<Bitstream>	findDuplicateInternalIdentifier(Context context, Bitstream bitstream)
Bitstream	getBitstreamByName(Item item, String bundleName, String bitstreamName)
Iterator<Bitstream>	getCollectionBitstreams(Context context, Collection collection)
Iterator<Bitstream>	getCommunityBitstreams(Context context, Community community)
Bitstream	getFirstBitstream(Item item, String bundleName)
BitstreamFormat	getFormat(Context context, Bitstream bitstream)
String	getFormatDescription(Context context, Bitstream bitstream) Get the description of the format - either the user's or the description of the format defined by the system.
Iterator<Bitstream>	getItemBitstreams(Context context, Item item)
List<Bitstream>	getNotReferencedBitstreams(Context context)
boolean	isRegisteredBitstream(Bitstream bitstream) Determine if this bitstream is registered (available elsewhere on filesystem than in assetstore).
Bitstream	register(Context context, Bundle bundle, int assetstore, String bitstreamPath) Register a new bitstream, with a new ID.
Bitstream	register(Context context, int assetstore, String bitstreamPath) Register a new bitstream, with a new ID.
InputStream	retrieve(Context context, Bitstream bitstream) Retrieve the contents of the bitstream
void	setFormat(Context context, Bitstream bitstream, BitstreamFormat bitstreamFormat) Set the format of the bitstream.
void	setUserFormatDescription(Context context, Bitstream bitstream, String desc) Set the user's format description.

Methods inherited from interface org.dspace.content.service.DSpaceObjectService

addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, clearMetadata, delete, find, getAdminObject, getIdentifiers, getMetadata, getMetadata, getMetadata, getMetadata, getMetadataByMetadataString, getMetadataFirstValue, getName, getParentObject, getSupportsTypeConstant, getTypeText, removeMetadataValues, setMetadataSingleValue, update, updateLastModified

Methods inherited from interface org.dspace.content.service.DSpaceObjectLegacySupportService

findByIdOrLegacyId, findByLegacyId, getSupportsTypeConstant

Method Detail

findAll

List<Bitstream> findAll(Context context)
                        throws SQLException

Throws:

SQLException

create

Bitstream create(Context context,
               InputStream is)
                 throws IOException,
                        SQLException

Create a new bitstream, with a new ID. The checksum and file size are calculated. No authorization checks are made in this method. The newly created bitstream has the "unknown" format.

Parameters:

context - DSpace context object

is - the bits to put in the bitstream

Returns:

the newly created bitstream

Throws:

IOException - if IO error

SQLException - if database error

create

Bitstream create(Context context,
               Bundle bundle,
               InputStream is)
                 throws IOException,
                        SQLException,
                        AuthorizeException

Create a new bitstream, with a new ID. The checksum and file size are calculated. The newly created bitstream has the "unknown" format.

Parameters:

context - DSpace context object

bundle - The bundle in which our bitstream should be added.

is - the bits to put in the bitstream

Returns:

the newly created bitstream

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

register

Bitstream register(Context context,
                 Bundle bundle,
                 int assetstore,
                 String bitstreamPath)
                   throws IOException,
                          SQLException,
                          AuthorizeException

Register a new bitstream, with a new ID. The checksum and file size are calculated. The newly created bitstream has the "unknown" format.

Parameters:

context - DSpace context object

bundle - The bundle in which our bitstream should be added.

assetstore - corresponds to an assetstore in dspace.cfg

bitstreamPath - the path and filename relative to the assetstore

Returns:

the newly registered bitstream

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

register

Bitstream register(Context context,
                 int assetstore,
                 String bitstreamPath)
                   throws IOException,
                          SQLException,
                          AuthorizeException

Register a new bitstream, with a new ID. The checksum and file size are calculated. The newly created bitstream has the "unknown" format.

Parameters:

context - DSpace context object

assetstore - corresponds to an assetstore in dspace.cfg

bitstreamPath - the path and filename relative to the assetstore

Returns:

the newly registered bitstream

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

setUserFormatDescription

void setUserFormatDescription(Context context,
                            Bitstream bitstream,
                            String desc)
                              throws SQLException

Set the user's format description. This implies that the format of the bitstream is uncertain, and the format is set to "unknown."

Parameters:

context - DSpace context object

bitstream - DSpace bitstream

desc - the user's description of the format

Throws:

SQLException - if database error

getFormatDescription

String getFormatDescription(Context context,
                          Bitstream bitstream)
                            throws SQLException

Get the description of the format - either the user's or the description of the format defined by the system.

Parameters:

context - DSpace context object

bitstream - DSpace bitstream

Returns:

a description of the format.

Throws:

SQLException - if database error

setFormat

void setFormat(Context context,
             Bitstream bitstream,
             BitstreamFormat bitstreamFormat)
               throws SQLException

Set the format of the bitstream. If the user has supplied a type description, it is cleared. Passing in null sets the type of this bitstream to "unknown".

Parameters:

context - DSpace context object

bitstream - DSpace bitstream

bitstreamFormat - the format of this bitstream, or null for unknown

Throws:

SQLException - if database error

retrieve

InputStream retrieve(Context context,
                   Bitstream bitstream)
                     throws IOException,
                            SQLException,
                            AuthorizeException

Retrieve the contents of the bitstream

Parameters:

context - DSpace context object

bitstream - DSpace bitstream

Returns:

a stream from which the bitstream can be read.

Throws:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

isRegisteredBitstream

boolean isRegisteredBitstream(Bitstream bitstream)

Determine if this bitstream is registered (available elsewhere on filesystem than in assetstore). More about registered items: https://wiki.duraspace.org/display/DSDOC3x/Registering+(not+Importing)+Bitstreams+via+Simple+Archive+Format

Parameters:

bitstream - DSpace bitstream

Returns:

true if the bitstream is registered, false otherwise

findDeletedBitstreams

List<Bitstream> findDeletedBitstreams(Context context)
                                      throws SQLException

Retrieve all bitstreams with the deleted flag set to true

Parameters:

context - the dspace context

Returns:

a list of all bitstreams that have been "deleted"

Throws:

SQLException - if database error

expunge

void expunge(Context context,
           Bitstream bitstream)
             throws SQLException,
                    AuthorizeException

Remove a bitstream that has been set to "deleted" from the database

Parameters:

context - the dspace context

bitstream - the bitstream to deleted from the database

Throws:

SQLException - if database error

AuthorizeException - if authorization error

findDuplicateInternalIdentifier

List<Bitstream> findDuplicateInternalIdentifier(Context context,
                                              Bitstream bitstream)
                                                throws SQLException

Throws:

SQLException

getItemBitstreams

Iterator<Bitstream> getItemBitstreams(Context context,
                                    Item item)
                                      throws SQLException

Throws:

SQLException

getCollectionBitstreams

Iterator<Bitstream> getCollectionBitstreams(Context context,
                                          Collection collection)
                                            throws SQLException

Throws:

SQLException

getCommunityBitstreams

Iterator<Bitstream> getCommunityBitstreams(Context context,
                                         Community community)
                                           throws SQLException

Throws:

SQLException

findBitstreamsWithNoRecentChecksum

List<Bitstream> findBitstreamsWithNoRecentChecksum(Context context)
                                                   throws SQLException

Throws:

SQLException

getBitstreamByName

Bitstream getBitstreamByName(Item item,
                           String bundleName,
                           String bitstreamName)
                             throws SQLException

Throws:

SQLException

getFirstBitstream

Bitstream getFirstBitstream(Item item,
                          String bundleName)
                            throws SQLException

Throws:

SQLException

getFormat

BitstreamFormat getFormat(Context context,
                        Bitstream bitstream)
                          throws SQLException

Throws:

SQLException

findByStoreNumber

Iterator<Bitstream> findByStoreNumber(Context context,
                                    Integer storeNumber)
                                      throws SQLException

Throws:

SQLException

countByStoreNumber

Long countByStoreNumber(Context context,
                      Integer storeNumber)
                        throws SQLException

Throws:

SQLException

countTotal

int countTotal(Context context)
               throws SQLException

Throws:

SQLException

countDeletedBitstreams

int countDeletedBitstreams(Context context)
                           throws SQLException

Throws:

SQLException

countBitstreamsWithoutPolicy

int countBitstreamsWithoutPolicy(Context context)
                                 throws SQLException

Throws:

SQLException

getNotReferencedBitstreams

List<Bitstream> getNotReferencedBitstreams(Context context)
                                           throws SQLException

Throws:

SQLException