com.lowagie.text.Document Maven / Gradle / Ivy
/*
* $Id: Document.java,v 1.84 2004/12/27 07:10:01 blowagie Exp $
* $Name: $
*
* Copyright 1999, 2000, 2001, 2002 by Bruno Lowagie.
*
* The contents of this file are subject to the Mozilla Public License Version 1.1
* (the "License"); you may not use this file except in compliance with the License.
* You may obtain a copy of the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
* for the specific language governing rights and limitations under the License.
*
* The Original Code is 'iText, a free JAVA-PDF library'.
*
* The Initial Developer of the Original Code is Bruno Lowagie. Portions created by
* the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.
* All Rights Reserved.
* Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer
* are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.
*
* Contributor(s): all the names of the contributors are added in the source code
* where applicable.
*
* Alternatively, the contents of this file may be used under the terms of the
* LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the
* provisions of LGPL are applicable instead of those above. If you wish to
* allow use of your version of this file only under the terms of the LGPL
* License and not to allow others to use your version of this file under
* the MPL, indicate your decision by deleting the provisions above and
* replace them with the notice and other provisions required by the LGPL.
* If you do not delete the provisions above, a recipient may use your version
* of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the MPL as stated above or under the terms of the GNU
* Library General Public License as published by the Free Software Foundation;
* either version 2 of the License, or any later version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more
* details.
*
* If you didn't download this code from the following link, you should check if
* you aren't using an obsolete version:
* http://www.lowagie.com/iText/
*/
package com.lowagie.text;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.Date;
/**
* A generic Document class.
*
* All kinds of Text-elements can be added to a HTMLDocument.
* The Document signals all the listeners when an element
* has been added.
*
* Remark:
*
* - Once a document is created you can add some meta information.
*
- You can also set the headers/footers.
*
- You have to open the document before you can write content.
*
- You can only write content (no more meta-formation!) once a document is opened.
*
- When you change the header/footer on a certain page, this will be effective starting on the next page.
*
- Ater closing the document, every listener (as well as its
OutputStream) is closed too.
*
* Example:
*
* // creation of the document with a certain size and certain margins
* Document document = new Document(PageSize.A4, 50, 50, 50, 50);
* try {
* // creation of the different writers
* HtmlWriter.getInstance(document, System.out);
* PdfWriter.getInstance(document, new FileOutputStream("text.pdf"));
*
* // we add some meta information to the document
* document.addAuthor("Bruno Lowagie");
* document.addSubject("This is the result of a Test.");
*
* // we define a header and a footer
* HeaderFooter header = new HeaderFooter(new Phrase("This is a header."), false);
* HeaderFooter footer = new HeaderFooter(new Phrase("This is page "), new Phrase("."));
* footer.setAlignment(Element.ALIGN_CENTER);
* document.setHeader(header);
* document.setFooter(footer);
* // we open the document for writing
* document.open();
* document.add(new Paragraph("Hello world"));
* }
* catch(DocumentException de) {
* System.err.println(de.getMessage());
* }
* document.close();
* Document-object.
*/
public Document() {
this(PageSize.A4);
}
/**
* Constructs a new Document-object.
*
* @param pageSize the pageSize
*/
public Document(Rectangle pageSize) {
this(pageSize, 36, 36, 36, 36);
}
/**
* Constructs a new Document-object.
*
* @param pageSize the pageSize
* @param marginLeft the margin on the left
* @param marginRight the margin on the right
* @param marginTop the margin on the top
* @param marginBottom the margin on the bottom
*/
public Document(Rectangle pageSize, float marginLeft, float marginRight, float marginTop, float marginBottom) {
this.pageSize = pageSize;
this.marginLeft = marginLeft;
this.marginRight = marginRight;
this.marginTop = marginTop;
this.marginBottom = marginBottom;
}
// listener methods
/**
* Adds a DocListener to the Document.
*
* @param listener the new DocListener.
*/
public void addDocListener(DocListener listener) {
listeners.add(listener);
}
/**
* Removes a DocListener from the Document.
*
* @param listener the DocListener that has to be removed.
*/
public void removeDocListener(DocListener listener) {
listeners.remove(listener);
}
// methods implementing the DocListener interface
/** Adds an Element to the Document.
*
* @param element the Element to add
* @return true if the element was added, false if not
* @throws DocumentException when a document isn't open yet, or has been closed
*/
public boolean add(Element element) throws DocumentException {
if (close) {
throw new DocumentException("The document has been closed. You can't add any Elements.");
}
int type = element.type();
if (open) {
if (! (type == Element.CHUNK ||
type == Element.PHRASE ||
type == Element.PARAGRAPH ||
type == Element.TABLE ||
type == Element.PTABLE ||
type == Element.MULTI_COLUMN_TEXT ||
type == Element.ANCHOR ||
type == Element.ANNOTATION ||
type == Element.CHAPTER ||
type == Element.SECTION ||
type == Element.LIST ||
type == Element.LISTITEM ||
type == Element.RECTANGLE ||
type == Element.JPEG ||
type == Element.IMGRAW ||
type == Element.IMGTEMPLATE ||
type == Element.GRAPHIC)) {
throw new DocumentException("The document is open; you can only add Elements with content.");
}
}
else {
if (! (type == Element.HEADER ||
type == Element.TITLE ||
type == Element.SUBJECT ||
type == Element.KEYWORDS ||
type == Element.AUTHOR ||
type == Element.PRODUCER ||
type == Element.CREATOR ||
type == Element.CREATIONDATE)) {
throw new DocumentException("The document is not open yet; you can only add Meta information.");
}
}
boolean success = false;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
success |= listener.add(element);
}
return success;
}
/**
* Opens the document.
*
* Once the document is opened, you can't write any Header- or Meta-information
* anymore. You have to open the document before you can begin to add content
* to the body of the document.
*/
public void open() {
if (! close) {
open = true;
}
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setPageSize(pageSize);
listener.setMargins(marginLeft, marginRight, marginTop, marginBottom);
listener.open();
}
}
/**
* Sets the pagesize.
*
* @param pageSize the new pagesize
* @return a boolean
*/
public boolean setPageSize(Rectangle pageSize) {
this.pageSize = pageSize;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setPageSize(pageSize);
}
return true;
}
/**
* Sets the Watermark.
*
* @param watermark the watermark to add
* @return true if the element was added, false if not.
*/
public boolean add(Watermark watermark) {
this.watermark = watermark;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.add(watermark);
}
return true;
}
/**
* Removes the Watermark.
*/
public void removeWatermark() {
this.watermark = null;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.removeWatermark();
}
}
/**
* Sets the margins.
*
* @param marginLeft the margin on the left
* @param marginRight the margin on the right
* @param marginTop the margin on the top
* @param marginBottom the margin on the bottom
* @return a boolean
*/
public boolean setMargins(float marginLeft,float marginRight,float marginTop,float marginBottom) {
this.marginLeft = marginLeft;
this.marginRight = marginRight;
this.marginTop = marginTop;
this.marginBottom = marginBottom;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setMargins(marginLeft, marginRight, marginTop, marginBottom);
}
return true;
}
/**
* Signals that an new page has to be started.
*
* @return true if the page was added, false if not.
* @throws DocumentException when a document isn't open yet, or has been closed
*/
public boolean newPage() throws DocumentException {
if (!open || close) {
return false;
}
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.newPage();
}
return true;
}
/**
* Changes the header of this document.
*
* @param header the new header
*/
public void setHeader(HeaderFooter header) {
this.header = header;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setHeader(header);
}
}
/**
* Resets the header of this document.
*/
public void resetHeader() {
this.header = null;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.resetHeader();
}
}
/**
* Changes the footer of this document.
*
* @param footer the new footer
*/
public void setFooter(HeaderFooter footer) {
this.footer = footer;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setFooter(footer);
}
}
/**
* Resets the footer of this document.
*/
public void resetFooter() {
this.footer = null;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.resetFooter();
}
}
/**
* Sets the page number to 0.
*/
public void resetPageCount() {
pageN = 0;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.resetPageCount();
}
}
/**
* Sets the page number.
*
* @param pageN the new page number
*/
public void setPageCount(int pageN) {
this.pageN = pageN;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setPageCount(pageN);
}
}
/**
* Returns the current page number.
*
* @return the current page number
*/
public int getPageNumber() {
return this.pageN;
}
/**
* Closes the document.
*
* Once all the content has been written in the body, you have to close
* the body. After that nothing can be written to the body anymore.
*/
public void close() {
if (! close) {
open = false;
close = true;
}
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.close();
}
}
// methods concerning the header or some meta information
/**
* Adds a user defined header to the document.
*
* @param name the name of the header
* @param content the content of the header
* @return true if successful, false otherwise
*/
public boolean addHeader(String name, String content) {
try {
return add(new Header(name, content));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the title to a Document.
*
* @param title the title
* @return true if successful, false otherwise
*/
public boolean addTitle(String title) {
try {
return add(new Meta(Element.TITLE, title));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the subject to a Document.
*
* @param subject the subject
* @return true if successful, false otherwise
*/
public boolean addSubject(String subject) {
try {
return add(new Meta(Element.SUBJECT, subject));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the keywords to a Document.
*
* @param keywords adds the keywords to the document
* @return true if successful, false otherwise
*/
public boolean addKeywords(String keywords) {
try {
return add(new Meta(Element.KEYWORDS, keywords));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the author to a Document.
*
* @param author the name of the author
* @return true if successful, false otherwise
*/
public boolean addAuthor(String author) {
try {
return add(new Meta(Element.AUTHOR, author));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the creator to a Document.
*
* @param creator the name of the creator
* @return true if successful, false otherwise
*/
public boolean addCreator(String creator) {
try {
return add(new Meta(Element.CREATOR, creator));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the producer to a Document.
*
* @return true if successful, false otherwise
*/
public boolean addProducer() {
try {
return add(new Meta(Element.PRODUCER, "iText by lowagie.com"));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
/**
* Adds the current date and time to a Document.
*
* @return true if successful, false otherwise
*/
public boolean addCreationDate() {
try {
return add(new Meta(Element.CREATIONDATE, new Date().toString()));
}
catch(DocumentException de) {
throw new ExceptionConverter(de);
}
}
// methods to get the layout of the document.
/**
* Returns the left margin.
*
* @return the left margin
*/
public float leftMargin() {
return marginLeft;
}
/**
* Return the right margin.
*
* @return the right margin
*/
public float rightMargin() {
return marginRight;
}
/**
* Returns the top margin.
*
* @return the top margin
*/
public float topMargin() {
return marginTop;
}
/**
* Returns the bottom margin.
*
* @return the bottom margin
*/
public float bottomMargin() {
return marginBottom;
}
/**
* Returns the lower left x-coordinate.
*
* @return the lower left x-coordinate
*/
public float left() {
return pageSize.left(marginLeft);
}
/**
* Returns the upper right x-coordinate.
*
* @return the upper right x-coordinate
*/
public float right() {
return pageSize.right(marginRight);
}
/**
* Returns the upper right y-coordinate.
*
* @return the upper right y-coordinate
*/
public float top() {
return pageSize.top(marginTop);
}
/**
* Returns the lower left y-coordinate.
*
* @return the lower left y-coordinate
*/
public float bottom() {
return pageSize.bottom(marginBottom);
}
/**
* Returns the lower left x-coordinate considering a given margin.
*
* @param margin a margin
* @return the lower left x-coordinate
*/
public float left(float margin) {
return pageSize.left(marginLeft + margin);
}
/**
* Returns the upper right x-coordinate, considering a given margin.
*
* @param margin a margin
* @return the upper right x-coordinate
*/
public float right(float margin) {
return pageSize.right(marginRight + margin);
}
/**
* Returns the upper right y-coordinate, considering a given margin.
*
* @param margin a margin
* @return the upper right y-coordinate
*/
public float top(float margin) {
return pageSize.top(marginTop + margin);
}
/**
* Returns the lower left y-coordinate, considering a given margin.
*
* @param margin a margin
* @return the lower left y-coordinate
*/
public float bottom(float margin) {
return pageSize.bottom(marginBottom + margin);
}
/**
* Gets the pagesize.
* @return the page size
*/
public Rectangle getPageSize()
{
return this.pageSize;
}
/** Checks if the document is open.
* @return true if the document is open
*/
public boolean isOpen() {
return open;
}
/** Gets the iText version.
* @return iText version
*/
public static String getVersion() {
return ITEXT_VERSION;
}
/**
* Adds a JavaScript onLoad function to the HTML body tag
*
* @param code the JavaScript code to be executed on load of the HTML page
*/
public void setJavaScript_onLoad(String code) {
this.javaScript_onLoad = code;
}
/**
* Gets the JavaScript onLoad command.
* @return the JavaScript onLoad command
*/
public String getJavaScript_onLoad() {
return this.javaScript_onLoad;
}
/**
* Adds a JavaScript onUnLoad function to the HTML body tag
*
* @param code the JavaScript code to be executed on unload of the HTML page
*/
public void setJavaScript_onUnLoad(String code) {
this.javaScript_onUnLoad = code;
}
/**
* Gets the JavaScript onUnLoad command.
* @return the JavaScript onUnLoad command
*/
public String getJavaScript_onUnLoad() {
return this.javaScript_onUnLoad;
}
/**
* Adds a style class to the HTML body tag
*
* @param htmlStyleClass the style class for the HTML body tag
*/
public void setHtmlStyleClass(String htmlStyleClass) {
this.htmlStyleClass = htmlStyleClass;
}
/**
* Gets the style class of the HTML body tag
*
* @return the style class of the HTML body tag
*/
public String getHtmlStyleClass() {
return this.htmlStyleClass;
}
/**
* @see com.lowagie.text.DocListener#clearTextWrap()
*/
public void clearTextWrap() throws DocumentException {
if (open && !close) {
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.clearTextWrap();
}
}
}
/**
* Set the margin mirroring. It will mirror margins for odd/even pages.
*
* Note: it will not work with {@link Table}.
* @param marginMirroring true to mirror the margins
* @return always true
*/
public boolean setMarginMirroring(boolean marginMirroring) {
this.marginMirroring = marginMirroring;
DocListener listener;
for (Iterator iterator = listeners.iterator(); iterator.hasNext(); ) {
listener = (DocListener) iterator.next();
listener.setMarginMirroring(marginMirroring);
}
return true;
}
/**
* Gets the margin mirroring flag.
* @return the margin mirroring flag
*/
public boolean isMarginMirroring() {
return marginMirroring;
}
}