org.openpdf.renderer.action.PdfObjectParseUtil Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of openpdf-renderer Show documentation
PDF renderer implementation supporting the subset of PDF 1.4 specification.
The newest version!
package org.openpdf.renderer.action;

import java.io.IOException;

import org.openpdf.renderer.PDFDestination;
import org.openpdf.renderer.PDFObject;
import org.openpdf.renderer.PDFParseException;

/*****************************************************************************
 * Utility class for parsing values from a PDFObject
 *
 * @author  Katja Sondermann
 * @since 08.07.2009
 ****************************************************************************/
public class PdfObjectParseUtil {
	
	/*************************************************************************
	 * Parse a String value with the given key from parent object. If it's mandatory
	 * and not available, an exception will be thrown.
	 * @param key
	 * @param parent
	 * @param mandatory
	 * @return String - can be null if not mandatory
	 * @throws IOException - in case of a parsing error 
	 ************************************************************************/
	public static String parseStringFromDict(String key, PDFObject parent, boolean mandatory) throws IOException{
		PDFObject val = parent;
		while (val.getType() == PDFObject.DICTIONARY) {
			val = val.getDictRef(key);
			if(val == null){
				if(mandatory){
					throw new PDFParseException(key + "value could not be parsed : " + parent.toString());	
				}
				return null;
			}
		}
		return val.getStringValue();
	}

	/*************************************************************************
	 * Parse a Boolean value with the given key from parent object. If it's mandatory
	 * and not available, an exception will be thrown.
	 * @param key
	 * @param parent
	 * @param mandatory
	 * @return boolean - false if not available and not mandatory
	 * @throws IOException 
	 ************************************************************************/
	public static boolean parseBooleanFromDict(String key, PDFObject parent, boolean mandatory) throws IOException{
		PDFObject val = parent.getDictRef(key);
		if(val == null){
			if(mandatory){
				throw new PDFParseException(key + "value could not be parsed : " + parent.toString());	
			}
			return false;
		}
		return val.getBooleanValue();
	}
	
	/*************************************************************************
	 * Parse a integer value with the given key from parent object. If it's mandatory
	 * and not available, an exception will be thrown.
	 * @param key
	 * @param parent
	 * @param mandatory
	 * @return int - returns "0" in case the value is not a number
	 * @throws IOException 
	 ************************************************************************/
	public static int parseIntegerFromDict(String key, PDFObject parent, boolean mandatory) throws IOException{
		PDFObject val = parent.getDictRef(key);
		if(val == null){
			if(mandatory){
				throw new PDFParseException(key + "value could not be parsed : " + parent.toString());	
			}
			return 0;
		}
		return val.getIntValue();
	}
	
	/*************************************************************************
	 * Parse a destination object
	 * @param key
	 * @param parent
	 * @param root
	 * @param mandatory
	 * @return PDFDestination  - can be null if not mandatory
	 * @throws IOException
	 ************************************************************************/
	public static PDFDestination parseDestination(String key, PDFObject parent, PDFObject root, boolean mandatory) throws IOException{
		PDFObject destObj = parent.getDictRef(key);
		if (destObj == null) {
			if(mandatory){
				throw new PDFParseException("Error parsing destination " + parent);
			}
			return null;
		}
		return PDFDestination.getDestination(destObj, root);

	}
}