adds hyphenation (Carlos Villegas, Fotis Jannidis) and simple configuration support (F.J.)

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@193861 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 227 insertions, 0 deletions

diff --git a/src/org/apache/fop/configuration/ConfigurationReader.java b/src/org/apache/fop/configuration/ConfigurationReader.java
new file mode 100644
index 000000000..798a35698
--- /dev/null
+++ b/src/org/apache/fop/configuration/ConfigurationReader.java
@@ -0,0 +1,227 @@
+/*
+
+ ============================================================================
+                   The Apache Software License, Version 1.1
+ ============================================================================
+
+    Copyright (C) 1999 The Apache Software Foundation. All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without modifica-
+ tion, are permitted provided that the following conditions are met:
+
+ 1. Redistributions of  source code must  retain the above copyright  notice,
+    this list of conditions and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+ 3. The end-user documentation included with the redistribution, if any, must
+    include  the following  acknowledgment:  "This product includes  software
+    developed  by the  Apache Software Foundation  (http://www.apache.org/)."
+    Alternately, this  acknowledgment may  appear in the software itself,  if
+    and wherever such third-party acknowledgments normally appear.
+
+ 4. The names "Fop" and  "Apache Software Foundation"  must not be used to
+    endorse  or promote  products derived  from this  software without  prior
+    written permission. For written permission, please contact
+    apache@apache.org.
+
+ 5. Products  derived from this software may not  be called "Apache", nor may
+    "Apache" appear  in their name,  without prior written permission  of the
+    Apache Software Foundation.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
+ INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+ FITNESS  FOR A PARTICULAR  PURPOSE ARE  DISCLAIMED.  IN NO  EVENT SHALL  THE
+ APACHE SOFTWARE  FOUNDATION  OR ITS CONTRIBUTORS  BE LIABLE FOR  ANY DIRECT,
+ INDIRECT, INCIDENTAL, SPECIAL,  EXEMPLARY, OR CONSEQUENTIAL  DAMAGES (INCLU-
+ DING, BUT NOT LIMITED TO, PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ OF USE, DATA, OR  PROFITS; OR BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON
+ ANY  THEORY OF LIABILITY,  WHETHER  IN CONTRACT,  STRICT LIABILITY,  OR TORT
+ (INCLUDING  NEGLIGENCE OR  OTHERWISE) ARISING IN  ANY WAY OUT OF THE  USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+ This software  consists of voluntary contributions made  by many individuals
+ on  behalf of the Apache Software  Foundation and was  originally created by
+ James Tauber <jtauber@jtauber.com>. For more  information on the Apache
+ Software Foundation, please see <http://www.apache.org/>.
+
+ */
+
+package org.apache.fop.configuration;
+
+//sax
+import org.xml.sax.helpers.DefaultHandler;
+import org.xml.sax.XMLReader;
+import org.xml.sax.SAXException;
+import java.io.IOException;
+import org.xml.sax.InputSource;
+
+//fop
+import org.apache.fop.messaging.MessageHandler;
+import org.apache.fop.apps.FOPException;
+import org.apache.fop.configuration.AWTConfiguration;
+import org.apache.fop.configuration.PDFConfiguration;
+import org.apache.fop.configuration.StandardConfiguration;
+
+/**
+ *  entry class for reading configuration from file and creating a configuration
+ *  class. typical use looks like that: <br>
+ *
+ *  <code>ConfigurationReader reader = new ConfigurationReader ("config.xml","standard");
+ *     try {
+ *       reader.start();
+ *     } catch (org.apache.fop.apps.FOPException error) {
+ *       reader.dumpError(error);
+ *     }
+ *  </code>
+ *  Once the configuration has been setup, the information can be accessed with
+ *  the methods of StandardConfiguration.
+ */
+
+public class ConfigurationReader {
+    /** show a full dump on error */
+    private static boolean errorDump = false;
+
+    /** inputsource for configuration file  */
+    private InputSource filename;
+
+    private String role ;
+
+    /**
+     * creates a configuration reader
+     * @param filename the file which contains the configuration information
+     * @param role three values are recognized: awt, pdf, standard
+     */
+    public ConfigurationReader (InputSource filename, String role) {
+        this.filename = filename;
+        this.role = role;
+    }
+
+
+    /**
+      * intantiates parser and starts parsing of config file
+      */
+    public void start () throws FOPException {
+        XMLReader parser = createParser();
+
+        if (parser == null) {
+            MessageHandler.errorln("ERROR: Unable to create SAX parser");
+            System.exit(1);
+        }
+
+        // setting the parser features
+        try {
+            parser.setFeature("http://xml.org/sax/features/namespace-prefixes",
+                              false);
+        } catch (SAXException e) {
+            MessageHandler.errorln("You need a parser which supports SAX version 2");
+            if (errorDump) {
+                e.printStackTrace();
+            }
+            System.exit(1);
+        }
+        ConfigurationParser configurationParser = new ConfigurationParser();
+        parser.setContentHandler(configurationParser);
+
+        try {
+            parser.parse(filename);
+            if (role.equalsIgnoreCase("standard")) {
+                StandardConfiguration.setup(
+                  configurationParser.getConfiguration());
+            } else if (role.equalsIgnoreCase("pdf")) {
+                PDFConfiguration.setup(
+                  configurationParser.getConfiguration());
+            } else if (role.equalsIgnoreCase("awt")) {
+                AWTConfiguration.setup(
+                  configurationParser.getConfiguration());
+            }
+        } catch (SAXException e) {
+            if (e.getException() instanceof FOPException) {
+                dumpError(e.getException());
+                throw (FOPException) e.getException();
+            } else {
+                dumpError(e);
+                throw new FOPException(e.getMessage());
+            }
+        }
+        catch (IOException e) {
+            dumpError(e);
+            throw new FOPException(e.getMessage());
+        }
+    }
+
+
+    /**
+       * creates a SAX parser, using the value of org.xml.sax.parser
+       * defaulting to org.apache.xerces.parsers.SAXParser
+       *
+       * @return the created SAX parser
+       */
+    static XMLReader createParser() {
+        String parserClassName = System.getProperty("org.xml.sax.parser");
+        if (parserClassName == null) {
+            parserClassName = "org.apache.xerces.parsers.SAXParser";
+        }
+        if (errorDump) {
+            MessageHandler.logln( "configuration reader using SAX parser " +
+                                  parserClassName);
+        }
+
+        try {
+            return (XMLReader) Class.forName(
+                     parserClassName).newInstance();
+        } catch (ClassNotFoundException e) {
+            MessageHandler.errorln("Could not find " + parserClassName);
+            if (errorDump) {
+                e.printStackTrace();
+            }
+        }
+        catch (InstantiationException e) {
+            MessageHandler.errorln("Could not instantiate " +
+                                   parserClassName);
+            if (errorDump) {
+                e.printStackTrace();
+            }
+        }
+        catch (IllegalAccessException e) {
+            MessageHandler.errorln("Could not access " + parserClassName);
+            if (errorDump) {
+                e.printStackTrace();
+            }
+        }
+        catch (ClassCastException e) {
+            MessageHandler.errorln(parserClassName + " is not a SAX driver");
+            if (errorDump) {
+                e.printStackTrace();
+            }
+        }
+        return null;
+    }
+
+    /**
+       * Dumps an error
+       */
+    public void dumpError(Exception e) {
+        if (errorDump) {
+            if (e instanceof SAXException) {
+                e.printStackTrace();
+                if (((SAXException) e).getException() != null) {
+                    ((SAXException) e).getException().printStackTrace();
+                }
+            } else {
+                e.printStackTrace();
+            }
+        }
+    }
+
+    /**
+      *  long or short error messages
+      *
+      */
+    public void setDumpError(boolean dumpError) {
+        this.errorDump = errorDump;
+    }
+
+}