|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PreservationArcRepositoryClient
Implements the Facade pattern to shield off the methods in JMSArcRepositoryClient not to be used by the bit preservation system.
Method Summary | |
---|---|
BatchStatus |
batch(FileBatchJob job,
java.lang.String replicaId,
java.lang.String... args)
Runs a batch batch job on each file in the ArcRepository. |
void |
close()
Call on shutdown to release external resources. |
java.io.File |
correct(java.lang.String replicaId,
java.lang.String checksum,
java.io.File file,
java.lang.String credentials)
Method for correcting a file in a replica. |
BitarchiveRecord |
get(java.lang.String arcfile,
long index)
Gets a single ARC record out of the ArcRepository. |
java.io.File |
getAllChecksums(java.lang.String replicaId)
Retrieves all the checksum from the replica through a GetAllChecksumMessage. |
java.io.File |
getAllFilenames(java.lang.String replicaId)
Retrieves the names of all the files in the replica through a GetAllFilenamesMessage. |
java.lang.String |
getChecksum(java.lang.String replicaId,
java.lang.String filename)
Retrieves the checksum of a specific file. |
void |
getFile(java.lang.String arcfilename,
Replica replica,
java.io.File toFile)
Retrieves a file from an ArcRepository and places it in a local file. |
java.io.File |
removeAndGetFile(java.lang.String fileName,
java.lang.String replicaId,
java.lang.String checksum,
java.lang.String credentials)
Remove a file from one part of the ArcRepository, retrieveing a copy for security purposes. |
void |
store(java.io.File file)
Store the given file in the ArcRepository. |
void |
updateAdminChecksum(java.lang.String filename,
java.lang.String checksum)
Updates the checksum kept in the ArcRepository for a given file. |
void |
updateAdminData(java.lang.String fileName,
java.lang.String replicaId,
ReplicaStoreState newval)
Updates the administrative data in the ArcRepository for a given file and bitarchive replica. |
Method Detail |
---|
void close()
BitarchiveRecord get(java.lang.String arcfile, long index) throws ArgumentNotValid
arcfile
- The name of a file containing the desired record.index
- The offset of the desired record in the file
ArgumentNotValid
- If the get operation failed.void getFile(java.lang.String arcfilename, Replica replica, java.io.File toFile)
arcfilename
- Name of the arcfile to retrieve.replica
- The bitarchive to retrieve the data from.toFile
- Filename of a place where the file fetched can be put.
IOFailure
- if there are problems getting a reply or the file
could not be found.void store(java.io.File file) throws IOFailure, ArgumentNotValid
file
- A file to be stored. Must exist.
IOFailure
- thrown if store is unsuccesful, or failed to clean
up files after the store operation.
ArgumentNotValid
- if file parameter is null or file is not an
existing file.BatchStatus batch(FileBatchJob job, java.lang.String replicaId, java.lang.String... args)
job
- An object that implements the FileBatchJob interface. The
initialize() method will be called before processing and the finish()
method will be called afterwards. The process() method will be called
with each File entry. An optional function postProcess() allows handling
the combined results of the batchjob, e.g. summing the results, sorting,
etc.replicaId
- The archive to execute the job on.args
- The arguments for the batchjob.
void updateAdminData(java.lang.String fileName, java.lang.String replicaId, ReplicaStoreState newval)
fileName
- The name of a file stored in the ArcRepository.replicaId
- The id if the replica that the administrative
data for fileName is wrong for.newval
- What the administrative data will be updated to.void updateAdminChecksum(java.lang.String filename, java.lang.String checksum)
filename
- The name of a file stored in the ArcRepository.checksum
- The new checksum.java.io.File removeAndGetFile(java.lang.String fileName, java.lang.String replicaId, java.lang.String checksum, java.lang.String credentials)
fileName
- The name of the file to remove.replicaId
- The replica id from which to remove the file.checksum
- The checksum of the file to be removed.credentials
- A string that shows that the user is allowed to
perform this operation.
java.io.File getAllChecksums(java.lang.String replicaId)
replicaId
- The id of the replica from which the checksums should
be retrieved.
GetAllChecksumsMessage
java.lang.String getChecksum(java.lang.String replicaId, java.lang.String filename)
replicaId
- The name of the replica to send the message.filename
- The name of the file for whom the checksum should be
retrieved.
java.io.File getAllFilenames(java.lang.String replicaId)
replicaId
- The id of the replica from which the list of filenames
should be retrieved.
GetAllFilenamesMessage
java.io.File correct(java.lang.String replicaId, java.lang.String checksum, java.io.File file, java.lang.String credentials)
replicaId
- The identification of the replica.file
- The new file to replace the old one.credentials
- The password for allowing to remove a file entry in
the archive.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |