com.itextpdf.text.pdf

Class SimpleBookmark

java.lang.Object

com.itextpdf.text.pdf.SimpleBookmark

All Implemented Interfaces:

SimpleXMLDocHandler

public final class SimpleBookmark
extends Object
implements SimpleXMLDocHandler

Bookmark processing in a simple way. It has some limitations, mainly the only action types supported are GoTo, GoToR, URI and Launch.

The list structure is composed by a number of HashMap, keyed by strings, one HashMap for each bookmark. The element values are all strings with the exception of the key "Kids" that has another list for the child bookmarks.

All the bookmarks have a "Title" with the bookmark title and optionally a "Style" that can be "bold", "italic" or a combination of both. They can also have a "Color" key with a value of three floats with values in the range 0.0 to 1.0 separated by spaces. The key "Open" can have the values "true" or "false" and signals the open status of the children. It's "true" by default.

The actions and the parameters can be:

• "Action" = "GoTo" - "Page" | "Named"
  • "Page" = "3 XYZ 70 400 null" - page number followed by a destination (/XYZ is also accepted)
  • "Named" = "named_destination"
• "Action" = "GoToR" - "Page" | "Named" | "NamedN", "File", ["NewWindow"]
  • "Page" = "3 XYZ 70 400 null" - page number followed by a destination (/XYZ is also accepted)
  • "Named" = "named_destination_as_a_string"
  • "NamedN" = "named_destination_as_a_name"
  • "File" - "the_file_to_open"
  • "NewWindow" - "true" or "false"
• "Action" = "URI" - "URI"
  • "URI" = "http://sf.net" - URI to jump to
• "Action" = "Launch" - "File"
  • "File" - "the_file_to_open_or_execute"

Author:

Paulo Soares

Method Summary

Modifier and Type	Method and Description
static void	eliminatePages(List<HashMap<String,Object>> list, int[] pageRange) Removes the bookmark entries for a number of page ranges.
void	endDocument() Called after the document is parsed.
void	endElement(String tag) Called when an end tag is found.
static void	exportToXML(List<HashMap<String,Object>> list, OutputStream out, String encoding, boolean onlyASCII) Exports the bookmarks to XML.
static void	exportToXML(List<HashMap<String,Object>> list, Writer wrt, String encoding, boolean onlyASCII) Exports the bookmarks to XML.
static void	exportToXMLNode(List<HashMap<String,Object>> list, Writer out, int indent, boolean onlyASCII) Exports the bookmarks to XML.
static List<HashMap<String,Object>>	getBookmark(PdfReader reader) Gets a List with the bookmarks.
static List<HashMap<String,Object>>	getBookmark(PdfReader reader, PdfDictionary outline, boolean includeRoot) Gets a List with the bookmarks that are children of outline.
static List<HashMap<String,Object>>	importFromXML(InputStream in) Import the bookmarks from XML.
static List<HashMap<String,Object>>	importFromXML(Reader in) Import the bookmarks from XML.
static Object[]	iterateOutlines(PdfWriter writer, PdfIndirectReference parent, List<HashMap<String,Object>> kids, boolean namedAsNames)
static void	shiftPageNumbers(List<HashMap<String,Object>> list, int pageShift, int[] pageRange) For the pages in range add the pageShift to the page number.
void	startDocument() Called when the document starts to be parsed.
void	startElement(String tag, Map<String,String> h) Called when a start tag is found.
void	text(String str) Called when a text element is found.

Methods inherited from class java.lang.Object

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

Method Detail

getBookmark

public static List<HashMap<String,Object>> getBookmark(PdfReader reader)

Gets a List with the bookmarks. It returns null if the document doesn't have any bookmarks.

Parameters:

reader - the document

Returns:

a List with the bookmarks or null if the document doesn't have any

getBookmark

public static List<HashMap<String,Object>> getBookmark(PdfReader reader,
                                                       PdfDictionary outline,
                                                       boolean includeRoot)

Gets a List with the bookmarks that are children of outline. It returns null if the document doesn't have any bookmarks.

Parameters:

reader - the document

outline - the outline dictionary to get bookmarks from

includeRoot - indicates if to include outline parameter itself into returned list of bookmarks

Returns:

a List with the bookmarks or null if the document doesn't have any

eliminatePages

public static void eliminatePages(List<HashMap<String,Object>> list,
                                  int[] pageRange)

Removes the bookmark entries for a number of page ranges. The page ranges consists of a number of pairs with the start/end page range. The page numbers are inclusive.

Parameters:

list - the bookmarks

pageRange - the page ranges, always in pairs.

shiftPageNumbers

public static void shiftPageNumbers(List<HashMap<String,Object>> list,
                                    int pageShift,
                                    int[] pageRange)

For the pages in range add the pageShift to the page number. The page ranges consists of a number of pairs with the start/end page range. The page numbers are inclusive.

Parameters:

list - the bookmarks

pageShift - the number to add to the pages in range

pageRange - the page ranges, always in pairs. It can be null to include all the pages

iterateOutlines

public static Object[] iterateOutlines(PdfWriter writer,
                                       PdfIndirectReference parent,
                                       List<HashMap<String,Object>> kids,
                                       boolean namedAsNames)
                                throws IOException

Throws:

IOException

exportToXMLNode

public static void exportToXMLNode(List<HashMap<String,Object>> list,
                                   Writer out,
                                   int indent,
                                   boolean onlyASCII)
                            throws IOException

Exports the bookmarks to XML. Only of use if the generation is to be include in some other XML document.

Parameters:

list - the bookmarks

out - the export destination. The writer is not closed

indent - the indentation level. Pretty printing significant only. Use -1 for no indents.

onlyASCII - codes above 127 will always be escaped with &#nn; if true, whatever the encoding

Throws:

IOException - on error

Since:

5.0.1 (generic type in signature)

exportToXML

public static void exportToXML(List<HashMap<String,Object>> list,
                               OutputStream out,
                               String encoding,
                               boolean onlyASCII)
                        throws IOException

Exports the bookmarks to XML. The DTD for this XML is:

Parameters:

list - the bookmarks

out - the export destination. The stream is not closed

encoding - the encoding according to IANA conventions

onlyASCII - codes above 127 will always be escaped with &#nn; if true, whatever the encoding

Throws:

IOException - on error

Since:

5.0.1 (generic type in signature)

exportToXML

public static void exportToXML(List<HashMap<String,Object>> list,
                               Writer wrt,
                               String encoding,
                               boolean onlyASCII)
                        throws IOException

Exports the bookmarks to XML.

Parameters:

list - the bookmarks

wrt - the export destination. The writer is not closed

encoding - the encoding according to IANA conventions

onlyASCII - codes above 127 will always be escaped with &#nn; if true, whatever the encoding

Throws:

IOException - on error

Since:

5.0.1 (generic type in signature)

importFromXML

public static List<HashMap<String,Object>> importFromXML(InputStream in)
                                                  throws IOException

Import the bookmarks from XML.

Parameters:

in - the XML source. The stream is not closed

Returns:

the bookmarks

Throws:

IOException - on error

importFromXML

public static List<HashMap<String,Object>> importFromXML(Reader in)
                                                  throws IOException

Import the bookmarks from XML.

Parameters:

in - the XML source. The reader is not closed

Returns:

the bookmarks

Throws:

IOException - on error

endDocument

public void endDocument()

Description copied from interface: SimpleXMLDocHandler

Called after the document is parsed.

Specified by:

endDocument in interface SimpleXMLDocHandler

endElement

public void endElement(String tag)

Description copied from interface: SimpleXMLDocHandler

Called when an end tag is found.

Specified by:

endElement in interface SimpleXMLDocHandler

Parameters:

tag - the tag name

startDocument

public void startDocument()

Description copied from interface: SimpleXMLDocHandler

Called when the document starts to be parsed.

Specified by:

startDocument in interface SimpleXMLDocHandler

startElement

public void startElement(String tag,
                         Map<String,String> h)

Description copied from interface: SimpleXMLDocHandler

Called when a start tag is found.

Specified by:

startElement in interface SimpleXMLDocHandler

Parameters:

tag - the tag name

h - the tag's attributes

text

public void text(String str)

Description copied from interface: SimpleXMLDocHandler

Called when a text element is found.

Specified by:

text in interface SimpleXMLDocHandler

Parameters:

str - the text element, probably a fragment.