net.cnri.repository.bdbje

Class BdbjeRepository

java.lang.Object

net.cnri.repository.AbstractRepository

net.cnri.repository.bdbje.BdbjeRepository

All Implemented Interfaces:

DirectRepository, Repository

public class BdbjeRepository
extends AbstractRepository
implements DirectRepository

Digital Object repository built on top of a Berkeley DB JE environment.

Constructor Summary

Constructors

Constructor and Description
BdbjeRepository(java.io.File base)
BdbjeRepository(java.io.File base, com.sleepycat.je.Durability durability)
BdbjeRepository(java.io.File base, com.sleepycat.je.EnvironmentConfig envConfig)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close the repository and release all resources.
void	createDataElement(java.lang.String handle, java.lang.String name) Creates a new data element with the given name in this digital object.
DigitalObject	createDigitalObject(java.lang.String handle) Creates a new digital object with the given identifier in this repository.
void	deleteAttribute(java.lang.String handle, java.lang.String elementName, java.lang.String name) Deletes a particular attribute.
void	deleteAttributes(java.lang.String handle, java.lang.String elementName, java.util.List<java.lang.String> names) Deletes multiple attributes.
void	deleteDataElement(java.lang.String handle, java.lang.String name) Deletes any data element of the given name.
java.lang.String	getAttribute(java.lang.String handle, java.lang.String elementName, java.lang.String name) Returns the value for a particular attribute
java.util.Map<java.lang.String,java.lang.String>	getAttributes(java.lang.String handle, java.lang.String elementName) Returns a Map view of the attributes of the digital object or data element.
DigitalObject	getDigitalObject(java.lang.String handle) Returns the digital object with the given identifier from this repository.
java.io.File	getFile(java.lang.String handle, java.lang.String elementName) Returns a file for the data of the data element.
DigitalObject	getOrCreateDigitalObject(java.lang.String handle) Returns the digital object with the given identifier from this repository, which is created if it does not exist.
long	getSize(java.lang.String handle, java.lang.String elementName) Returns the number of bytes of data in this data element.
CloseableIterator<java.util.Map.Entry<java.lang.String,java.lang.String>>	listAttributes(java.lang.String handle, java.lang.String elementName) Returns a CloseableIterator view of the attributes of the digital object or data element.
CloseableIterator<java.lang.String>	listDataElementNames(java.lang.String handle) Provides a CloseableIterator view of the names of the data elements in this digital object.
CloseableIterator<java.lang.String>	listHandles() Provides a CloseableIterator view of the identifiers for digital objects accessible through this repository.
CloseableIterator<DigitalObject>	listObjects() Provides a CloseableIterator view of the digital objects accessible through this repository.
java.io.InputStream	read(java.lang.String handle, java.lang.String elementName) Provides access to the data as an InputStream.
CloseableIterator<DigitalObject>	search(Query q) Provides a CloseableIterator view of the digital objects accessible through this repository under search bounds defined in the Query object with default parameters.
CloseableIterator<java.lang.String>	searchHandles(Query q) Provides a CloseableIterator view of the digital objects handles accessible through this repository under search bounds defined in the Query object with default parameters.
void	setAttribute(java.lang.String handle, java.lang.String elementName, java.lang.String name, java.lang.String value) Sets a particular attribute.
void	setAttributes(java.lang.String handle, java.lang.String elementName, java.util.Map<java.lang.String,java.lang.String> attributes) Sets the value of multiple attributes.
java.lang.String	toString()
boolean	verifyDataElement(java.lang.String handle, java.lang.String name) Verifies whether a data element with the given name exists within this digital object
boolean	verifyDigitalObject(java.lang.String handle) Verifies whether a digital object with the given identifier can be accessed via this repository.
long	write(java.lang.String handle, java.lang.String elementName, java.io.InputStream data, boolean append) Writes new data into the data element.

Methods inherited from class net.cnri.repository.AbstractRepository

deleteDigitalObject, getHandle, search, search, searchHandles, searchHandles, searchMapping

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.cnri.repository.Repository

deleteDigitalObject, getHandle, search, search, searchHandles, searchHandles, searchMapping

Constructor Detail

BdbjeRepository

public BdbjeRepository(java.io.File base)
                throws InternalException

Throws:

InternalException

BdbjeRepository

public BdbjeRepository(java.io.File base,
               com.sleepycat.je.Durability durability)
                throws InternalException

Throws:

InternalException

BdbjeRepository

public BdbjeRepository(java.io.File base,
               com.sleepycat.je.EnvironmentConfig envConfig)
                throws InternalException

Throws:

InternalException

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

verifyDigitalObject

public boolean verifyDigitalObject(java.lang.String handle)
                            throws RepositoryException

Description copied from interface: Repository

Verifies whether a digital object with the given identifier can be accessed via this repository.

Specified by:

verifyDigitalObject in interface Repository

Overrides:

verifyDigitalObject in class AbstractRepository

Parameters:

handle - an identifier for a digital object

Returns:

whether a digital object with that identifier can be accessed via this repository

Throws:

RepositoryException

createDigitalObject

public DigitalObject createDigitalObject(java.lang.String handle)
                                  throws CreationException,
                                         RepositoryException

Description copied from interface: Repository

Creates a new digital object with the given identifier in this repository. Passing null requests that the repository assign a new unique identifier; this method will throw UnsupportedOperationException if the given repository does not support that functionality.

Specified by:

createDigitalObject in interface Repository

Parameters:

handle - the identifier for the new digital object, or null to request that the repository assign a new unique identifier.

Returns:

the newly-created digital object

Throws:

CreationException - if an object with the given identifier already exists within the repository

RepositoryException

getOrCreateDigitalObject

public DigitalObject getOrCreateDigitalObject(java.lang.String handle)
                                       throws RepositoryException

Description copied from interface: Repository

Returns the digital object with the given identifier from this repository, which is created if it does not exist.

Specified by:

getOrCreateDigitalObject in interface Repository

Overrides:

getOrCreateDigitalObject in class AbstractRepository

Parameters:

handle - the identifier for the digital object

Returns:

the digital object

Throws:

RepositoryException

getDigitalObject

public DigitalObject getDigitalObject(java.lang.String handle)
                               throws RepositoryException

Description copied from interface: Repository

Returns the digital object with the given identifier from this repository.

Specified by:

getDigitalObject in interface Repository

Parameters:

handle - the identifier for the digital object

Returns:

the digital object, or null if no such object can be accessed through this repository

Throws:

RepositoryException

listHandles

public CloseableIterator<java.lang.String> listHandles()
                                                throws RepositoryException

Description copied from interface: Repository

Provides a CloseableIterator view of the identifiers for digital objects accessible through this repository.

Specified by:

listHandles in interface Repository

Overrides:

listHandles in class AbstractRepository

Throws:

RepositoryException

listObjects

public CloseableIterator<DigitalObject> listObjects()
                                             throws RepositoryException

Description copied from interface: Repository

Provides a CloseableIterator view of the digital objects accessible through this repository.

Specified by:

listObjects in interface Repository

Overrides:

listObjects in class AbstractRepository

Throws:

RepositoryException

search

public CloseableIterator<DigitalObject> search(Query q)
                                        throws RepositoryException

Description copied from interface: Repository

Provides a CloseableIterator view of the digital objects accessible through this repository under search bounds defined in the Query object with default parameters.

Specified by:

search in interface Repository

Overrides:

search in class AbstractRepository

Parameters:

q - the query to perform

Returns:

a CloseableIterator over the results. Some implementations may return QueryResults.

Throws:

RepositoryException

searchHandles

public CloseableIterator<java.lang.String> searchHandles(Query q)
                                                  throws RepositoryException

Description copied from interface: Repository

Provides a CloseableIterator view of the digital objects handles accessible through this repository under search bounds defined in the Query object with default parameters.

Specified by:

searchHandles in interface Repository

Overrides:

searchHandles in class AbstractRepository

Parameters:

q - the query to perform

Returns:

a CloseableIterator over the results. Some implementations may return QueryResults.

Throws:

RepositoryException

close

public void close()

Description copied from interface: Repository

Close the repository and release all resources.

Specified by:

close in interface Repository

getAttributes

public java.util.Map<java.lang.String,java.lang.String> getAttributes(java.lang.String handle,
                                                             java.lang.String elementName)
                                                               throws RepositoryException

Description copied from interface: DirectRepository

Returns a Map view of the attributes of the digital object or data element.

Specified by:

getAttributes in interface DirectRepository

Returns:

a Map view of the attributes of the digital object or data element.

Throws:

RepositoryException

listAttributes

public CloseableIterator<java.util.Map.Entry<java.lang.String,java.lang.String>> listAttributes(java.lang.String handle,
                                                                                       java.lang.String elementName)
                                                                                         throws RepositoryException

Description copied from interface: DirectRepository

Returns a CloseableIterator view of the attributes of the digital object or data element.

Specified by:

listAttributes in interface DirectRepository

Returns:

a CloseableIterator view of the attributes of the digital object or data element.

Throws:

RepositoryException

getAttribute

public java.lang.String getAttribute(java.lang.String handle,
                            java.lang.String elementName,
                            java.lang.String name)
                              throws RepositoryException

Description copied from interface: DirectRepository

Returns the value for a particular attribute

Specified by:

getAttribute in interface DirectRepository

name - the attribute name

Returns:

the attribute value

Throws:

RepositoryException

setAttributes

public void setAttributes(java.lang.String handle,
                 java.lang.String elementName,
                 java.util.Map<java.lang.String,java.lang.String> attributes)
                   throws RepositoryException

Description copied from interface: DirectRepository

Sets the value of multiple attributes. Attributes mapped to null will be deleted.

Specified by:

setAttributes in interface DirectRepository

attributes - the attributes to set, mapped to their new values

Throws:

RepositoryException

setAttribute

public void setAttribute(java.lang.String handle,
                java.lang.String elementName,
                java.lang.String name,
                java.lang.String value)
                  throws RepositoryException

Description copied from interface: DirectRepository

Sets a particular attribute.

Specified by:

setAttribute in interface DirectRepository

name - the attribute name

value - the attribute value; if null, the attribute will be deleted.

Throws:

RepositoryException

deleteAttributes

public void deleteAttributes(java.lang.String handle,
                    java.lang.String elementName,
                    java.util.List<java.lang.String> names)
                      throws RepositoryException

Description copied from interface: DirectRepository

Deletes multiple attributes.

Specified by:

deleteAttributes in interface DirectRepository

names - the names of the attributes to delete

Throws:

RepositoryException

deleteAttribute

public void deleteAttribute(java.lang.String handle,
                   java.lang.String elementName,
                   java.lang.String name)
                     throws RepositoryException

Description copied from interface: DirectRepository

Deletes a particular attribute.

Specified by:

deleteAttribute in interface DirectRepository

name - the name of the attribute to delete

Throws:

RepositoryException

verifyDataElement

public boolean verifyDataElement(java.lang.String handle,
                        java.lang.String name)
                          throws RepositoryException

Description copied from interface: DirectRepository

Verifies whether a data element with the given name exists within this digital object

Specified by:

verifyDataElement in interface DirectRepository

name - an identifier for a data element

Returns:

whether that data element exists

Throws:

RepositoryException

createDataElement

public void createDataElement(java.lang.String handle,
                     java.lang.String name)
                       throws CreationException,
                              RepositoryException

Description copied from interface: DirectRepository

Creates a new data element with the given name in this digital object.

Specified by:

createDataElement in interface DirectRepository

name - the identifier for the new data element

Throws:

CreationException - if a data element with the given name already exists

RepositoryException

deleteDataElement

public void deleteDataElement(java.lang.String handle,
                     java.lang.String name)
                       throws RepositoryException

Description copied from interface: DirectRepository

Deletes any data element of the given name.

Specified by:

deleteDataElement in interface DirectRepository

name - the identifier for the data element

Throws:

RepositoryException

listDataElementNames

public CloseableIterator<java.lang.String> listDataElementNames(java.lang.String handle)
                                                         throws RepositoryException

Description copied from interface: DirectRepository

Provides a CloseableIterator view of the names of the data elements in this digital object.

Specified by:

listDataElementNames in interface DirectRepository

Throws:

RepositoryException

read

public java.io.InputStream read(java.lang.String handle,
                       java.lang.String elementName)
                         throws RepositoryException

Description copied from interface: DirectRepository

Provides access to the data as an InputStream.

Specified by:

read in interface DirectRepository

Returns:

an InputStream providing access to the data

Throws:

RepositoryException

write

public long write(java.lang.String handle,
         java.lang.String elementName,
         java.io.InputStream data,
         boolean append)
           throws java.io.IOException,
                  RepositoryException

Description copied from interface: DirectRepository

Writes new data into the data element.

Specified by:

write in interface DirectRepository

data - an InputStream streaming the new data

append - whether to append the new data to the existing data

Returns:

the number of bytes of data written

Throws:

java.io.IOException

RepositoryException

getSize

public long getSize(java.lang.String handle,
           java.lang.String elementName)
             throws RepositoryException

Description copied from interface: DirectRepository

Returns the number of bytes of data in this data element.

Specified by:

getSize in interface DirectRepository

Returns:

the number of bytes of data in this data element

Throws:

RepositoryException

getFile

public java.io.File getFile(java.lang.String handle,
                   java.lang.String elementName)
                     throws RepositoryException

Description copied from interface: DirectRepository

Returns a file for the data of the data element. Reading or writing the file corresponds to reading and writing the data element. If the repository does not support files for data elements, returns null.

Specified by:

getFile in interface DirectRepository

Returns:

A file for the data of the data element, or null if the repository does not support files for data elements.

Throws:

RepositoryException