org.apache.fop.render.afp.modca

Class Document


public final class Document
extends AbstractNamedAFPObject

The document is the highest level of the MO:DCA data-stream document component hierarchy. Documents can be made up of pages, and the pages, which are at the intermediate level, can be made up of objects. Objects are at the lowest level, and can be bar codes, graphics, images, and presentation text. At each level of the hierarchy certain sets of MO:DCA data structures, called structured fields, are permissible. The document, pages and objects are bounded by structured fields that define their beginnings and their ends. These structured fields, called begin-end pairs, provide an envelope for the data-stream components. This feature enables a processor of the data stream that is not fully compliant with the architecture to bypass those objects that are beyond its scope, and to process the data stream to the best of its abilities. A presentation document is one that has been formatted and is intended for presentation, usually on a printer or display device. A data stream containing a presentation document should produce the same document content in the same format on different printers or display devices dependent, however, on the capabilities of each of the printers or display devices. A presentation document can reference resources that are to be included as part of the document to be presented.

Field Summary

Fields inherited from class org.apache.fop.render.afp.modca.AbstractNamedAFPObject

_name, _nameBytes

Fields inherited from class org.apache.fop.render.afp.modca.AbstractAFPObject

log

Constructor Summary

Document()
Default constructor for the document object.
Document(String name)
Constructor for the document object.

Method Summary

void
addPage(PageObject page)
Adds a page to the document.
void
addPageGroup(PageGroup pageGroup)
Adds a PageGroup to the document.
void
endDocument()
Method to mark the end of the page group.
boolean
isComplete()
Returns an indication if the page group is complete
void
writeDataStream(OutputStream os)
Accessor method to write the AFP datastream for document.

Methods inherited from class org.apache.fop.render.afp.modca.AbstractAFPObject

writeDataStream, writeObjectList

Constructor Details

Document

public Document()
Default constructor for the document object.

Document

public Document(String name)
Constructor for the document object.
Parameters:
name - The name of the document

Method Details

addPage

public void addPage(PageObject page)
Adds a page to the document.
Parameters:
page - - the Page object

addPageGroup

public void addPageGroup(PageGroup pageGroup)
Adds a PageGroup to the document.
Parameters:
pageGroup - the PageGroup object

endDocument

public void endDocument()
Method to mark the end of the page group.

isComplete

public boolean isComplete()
Returns an indication if the page group is complete

writeDataStream

public void writeDataStream(OutputStream os)
            throws IOException
Accessor method to write the AFP datastream for document.
Overrides:
writeDataStream in interface AbstractAFPObject
Parameters:
os - The stream to write to

Copyright 1999-2007 The Apache Software Foundation. All Rights Reserved.