Package org.eclipse.birt.core.archive
Class FolderArchive
java.lang.Object
org.eclipse.birt.core.archive.FolderArchive
- All Implemented Interfaces:
IDocArchiveReader,IDocArchiveWriter
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidclose()This function must be called after the reader is used.createOutputStream(String relativePath) createRandomAccessStream(String relativePath) Create a random access stream in the archive and return it.booleandropStream(String relativePath) Delete a stream from the archive.booleanvoidfinish()This function must be called after the writer is used.voidflush()This function flushs all the buffers in the writerGet archive filegetInputStream(String relativePath) getName()getOutputStream(String relativePath) returns a sequential access file.voidThis function must be called before the writer is used.booleanisOpen()get all the stream in the archive file.listStreams(String relativeStoragePath) try to lock the streamvoidopen()This functiona must be called before the reader is used.openRandomAccessStream(String relativePath) voidsetStreamSorter(IStreamSorter streamSorter) Set the stream sorter (if needed).voidunlock the stream locked by the object.
-
Constructor Details
-
FolderArchive
- Parameters:
absolute- fileName the archive file name- Throws:
IOException
-
-
Method Details
-
initialize
Description copied from interface:IDocArchiveWriterThis function must be called before the writer is used. initialize the document archive.- Specified by:
initializein interfaceIDocArchiveWriter- Throws:
IOException
-
getName
- Specified by:
getNamein interfaceIDocArchiveReader- Specified by:
getNamein interfaceIDocArchiveWriter- Returns:
- the archive name
-
createRandomAccessStream
Description copied from interface:IDocArchiveWriterCreate a random access stream in the archive and return it.- Specified by:
createRandomAccessStreamin interfaceIDocArchiveWriter- Parameters:
relativePath- - relative path to report archive path. The path is based on Unix syntax, with the root of the archive denoted by "/". The initial "/" character can be skipped.- Returns:
- RAOutputStream
- Throws:
IOException
-
openRandomAccessStream
- Specified by:
openRandomAccessStreamin interfaceIDocArchiveWriter- Throws:
IOException
-
createOutputStream
- Specified by:
createOutputStreamin interfaceIDocArchiveWriter- Throws:
IOException
-
getOutputStream
- Specified by:
getOutputStreamin interfaceIDocArchiveWriter- Throws:
IOException
-
getInputStream
- Specified by:
getInputStreamin interfaceIDocArchiveReader- Specified by:
getInputStreamin interfaceIDocArchiveWriter- Throws:
IOException
-
dropStream
Description copied from interface:IDocArchiveWriterDelete a stream from the archive. Note: Not all of the derived classes support this function. E.g. FileArchiveWriter doesn't support it.- Specified by:
dropStreamin interfaceIDocArchiveWriter- Parameters:
relativePath- - the relative path of the stream- Returns:
- whether the operation was successful
-
exists
- Specified by:
existsin interfaceIDocArchiveReader- Specified by:
existsin interfaceIDocArchiveWriter- Parameters:
relativePath- - the relative stream path in the archive. The relative path is based on Unix syntax, with the root of the archive denoted by "/". The initial "/" character can be skipped.- Returns:
- a list of strings representing the underlying stream names. The return values are in the relative path format too.
-
setStreamSorter
Description copied from interface:IDocArchiveWriterSet the stream sorter (if needed). The stream sorter will be used to sort the streams. If no stream sorter is set, the streams will be written in random order.- Specified by:
setStreamSorterin interfaceIDocArchiveWriter- Parameters:
streamSorter- - the stream sorter
-
finish
Description copied from interface:IDocArchiveWriterThis function must be called after the writer is used. finalizes the socument archive. This may involve compressing the archive to a single file. This also closes and finishes using the archive.- Specified by:
finishin interfaceIDocArchiveWriter- Throws:
IOException
-
open
Description copied from interface:IDocArchiveReaderThis functiona must be called before the reader is used. initialize the document archive. For example, the index stream mey be read into memory.- Specified by:
openin interfaceIDocArchiveReader- Throws:
IOException
-
getStream
Description copied from interface:IDocArchiveReaderreturns a sequential access file.- Specified by:
getStreamin interfaceIDocArchiveReader- Parameters:
relativePath- - the relative stream path in the archive. The relative path is based on Unix syntax, with the root of the archive denoted by "/". The initial "/" character can be skipped. Used mainly for sequential streams in report.- Returns:
- RAInputStream
- Throws:
IOException
-
listStreams
- Specified by:
listStreamsin interfaceIDocArchiveReader- Specified by:
listStreamsin interfaceIDocArchiveWriter- Parameters:
relativeStoragePath- - the relative stream path in the archive. The relative path is based on Unix syntax, with the root of the archive denoted by "/". The initial "/" character can be skipped.- Returns:
- a list of strings representing the underlying stream names. The return values are in the relative path format too.
- Throws:
IOException
-
listAllStreams
Description copied from interface:IDocArchiveWriterget all the stream in the archive file.- Specified by:
listAllStreamsin interfaceIDocArchiveReader- Specified by:
listAllStreamsin interfaceIDocArchiveWriter- Returns:
- Throws:
IOException
-
close
Description copied from interface:IDocArchiveReaderThis function must be called after the reader is used. close the archive.- Specified by:
closein interfaceIDocArchiveReader- Throws:
IOException
-
isOpen
public boolean isOpen() -
flush
Description copied from interface:IDocArchiveWriterThis function flushs all the buffers in the writer- Specified by:
flushin interfaceIDocArchiveWriter- Throws:
IOException
-
lock
Description copied from interface:IDocArchiveWritertry to lock the stream- Specified by:
lockin interfaceIDocArchiveReader- Specified by:
lockin interfaceIDocArchiveWriter- Returns:
- the locker.
- Throws:
IOException
-
unlock
Description copied from interface:IDocArchiveWriterunlock the stream locked by the object.- Specified by:
unlockin interfaceIDocArchiveReader- Specified by:
unlockin interfaceIDocArchiveWriter- Parameters:
lock- object returned by the lock().
-
getArchiveFile
Description copied from interface:IDocArchiveWriterGet archive file- Specified by:
getArchiveFilein interfaceIDocArchiveWriter- Returns:
-