loci.poi.poifs.filesystem

Class POIFSDocument

java.lang.Object

loci.poi.poifs.filesystem.POIFSDocument

All Implemented Interfaces:

POIFSViewable, BATManaged, BlockWritable

public class POIFSDocument
extends Object
implements BATManaged, BlockWritable, POIFSViewable

This class manages a document in the POIFS filesystem.

Author:

Marc Johnson (mjohnson at apache dot org)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	POIFSDocument.BigBlockStore
private class	POIFSDocument.SmallBlockStore

Field Summary

Fields

Modifier and Type	Field and Description
private POIFSDocument.BigBlockStore	_big_store
private DocumentProperty	_property
private int	_size
private POIFSDocument.SmallBlockStore	_small_store
private int	bigBlockSize

Constructor Summary

Constructors

Constructor and Description
POIFSDocument(String name, int size, POIFSDocumentPath path, POIFSWriterListener writer, int blockSize) Constructor
POIFSDocument(String name, ListManagedBlock[] blocks, int length, int size) Constructor from small blocks
POIFSDocument(String name, RandomAccessInputStream stream, int size) Constructor
POIFSDocument(String name, RawDataBlock[] blocks, int length) Constructor from large blocks
POIFSDocument(String name, SmallDocumentBlock[] blocks, int length) Constructor from small blocks

Method Summary

Methods

Modifier and Type	Method and Description
int	countBlocks() Return the number of BigBlock's this instance uses
DocumentBlock[]	getBigBlocks()
int	getBigBlockSize()
(package private) DocumentProperty	getDocumentProperty() Get the DocumentProperty
String	getShortDescription() Provides a short description of the object, to be used when a POIFSViewable object has not provided its contents.
int	getSize()
BlockWritable[]	getSmallBlocks() return the array of SmallDocumentBlocks used
Object[]	getViewableArray() Get an array of objects, some of which may implement POIFSViewable
Iterator	getViewableIterator() Get an Iterator of objects, some of which may implement POIFSViewable
boolean	preferArray() Give viewers a hint as to whether to call getViewableArray or getViewableIterator
(package private) void	read(byte[] buffer, int offset, RandomAccessInputStream stream) read data from the internal stores
void	setStartBlock(int index) Set the start block for this instance
void	writeBlocks(OutputStream stream) Write the storage to an OutputStream

Methods inherited from class java.lang.Object

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

Field Detail

_property

private DocumentProperty _property

_size

private int _size

_small_store

private POIFSDocument.SmallBlockStore _small_store

_big_store

private POIFSDocument.BigBlockStore _big_store

bigBlockSize

private int bigBlockSize

Constructor Detail

POIFSDocument

public POIFSDocument(String name,
             RawDataBlock[] blocks,
             int length)
              throws IOException

Constructor from large blocks

Parameters:

name - the name of the POIFSDocument

blocks - the big blocks making up the POIFSDocument

length - the actual length of the POIFSDocument

Throws:

IOException

POIFSDocument

public POIFSDocument(String name,
             SmallDocumentBlock[] blocks,
             int length)

Constructor from small blocks

Parameters:

name - the name of the POIFSDocument

blocks - the small blocks making up the POIFSDocument

length - the actual length of the POIFSDocument

POIFSDocument

public POIFSDocument(String name,
             ListManagedBlock[] blocks,
             int length,
             int size)
              throws IOException

Constructor from small blocks

Parameters:

name - the name of the POIFSDocument

blocks - the small blocks making up the POIFSDocument

length - the actual length of the POIFSDocument

Throws:

IOException

POIFSDocument

public POIFSDocument(String name,
             RandomAccessInputStream stream,
             int size)
              throws IOException

Constructor

Parameters:

name - the name of the POIFSDocument

stream - the InputStream we read data from

Throws:

IOException - thrown on read errors

POIFSDocument

public POIFSDocument(String name,
             int size,
             POIFSDocumentPath path,
             POIFSWriterListener writer,
             int blockSize)
              throws IOException

Constructor

Parameters:

name - the name of the POIFSDocument

size - the length of the POIFSDocument

path - the path of the POIFSDocument

writer - the writer who will eventually write the document contents

Throws:

IOException - thrown on read errors

Method Detail

getSmallBlocks

public BlockWritable[] getSmallBlocks()

return the array of SmallDocumentBlocks used

Returns:

array of SmallDocumentBlocks; may be empty, cannot be null

getBigBlocks

public DocumentBlock[] getBigBlocks()

getSize

public int getSize()

Returns:

size of the document

getBigBlockSize

public int getBigBlockSize()

read

void read(byte[] buffer,
        int offset,
        RandomAccessInputStream stream)

read data from the internal stores

Parameters:

buffer - the buffer to write to

offset - the offset into our storage to read from

getDocumentProperty

DocumentProperty getDocumentProperty()

Get the DocumentProperty

Returns:

the instance's DocumentProperty

writeBlocks

public void writeBlocks(OutputStream stream)
                 throws IOException

Write the storage to an OutputStream

Specified by:

writeBlocks in interface BlockWritable

Parameters:

stream - the OutputStream to which the stored data should be written

Throws:

IOException - on problems writing to the specified stream

countBlocks

public int countBlocks()

Return the number of BigBlock's this instance uses

Specified by:

countBlocks in interface BATManaged

Returns:

count of BigBlock instances

setStartBlock

public void setStartBlock(int index)

Set the start block for this instance

Specified by:

setStartBlock in interface BATManaged

Parameters:

index - index into the array of blocks making up the filesystem

getViewableArray

public Object[] getViewableArray()

Get an array of objects, some of which may implement POIFSViewable

Specified by:

getViewableArray in interface POIFSViewable

Returns:

an array of Object; may not be null, but may be empty

getViewableIterator

public Iterator getViewableIterator()

Get an Iterator of objects, some of which may implement POIFSViewable

Specified by:

getViewableIterator in interface POIFSViewable

Returns:

an Iterator; may not be null, but may have an empty back end store

preferArray

public boolean preferArray()

Give viewers a hint as to whether to call getViewableArray or getViewableIterator

Specified by:

preferArray in interface POIFSViewable

Returns:

true if a viewer should call getViewableArray, false if a viewer should call getViewableIterator

getShortDescription

public String getShortDescription()

Provides a short description of the object, to be used when a POIFSViewable object has not provided its contents.

Specified by:

getShortDescription in interface POIFSViewable

Returns:

short description