| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You under the Apache License, Version 2.0 |
| * (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.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| /* $Id$ */ |
| |
| package org.apache.fop.apps; |
| |
| import java.io.File; |
| import java.io.IOException; |
| import java.net.MalformedURLException; |
| import java.net.URI; |
| import java.net.URISyntaxException; |
| import java.util.HashMap; |
| import java.util.Map; |
| |
| import org.xml.sax.SAXException; |
| |
| import org.apache.avalon.framework.configuration.Configuration; |
| import org.apache.avalon.framework.configuration.ConfigurationException; |
| import org.apache.avalon.framework.configuration.DefaultConfigurationBuilder; |
| import org.apache.commons.logging.Log; |
| import org.apache.commons.logging.LogFactory; |
| |
| import org.apache.xmlgraphics.image.GraphicsConstants; |
| import org.apache.xmlgraphics.image.loader.spi.ImageImplRegistry; |
| import org.apache.xmlgraphics.image.loader.util.Penalty; |
| |
| import org.apache.fop.fonts.FontManagerConfigurator; |
| import org.apache.fop.hyphenation.HyphenationTreeCache; |
| import org.apache.fop.util.LogUtil; |
| |
| /** |
| * FopFactory configurator |
| */ |
| public class FopFactoryConfigurator { |
| |
| /** Defines if FOP should use an alternative rule to determine text indents */ |
| public static final boolean DEFAULT_BREAK_INDENT_INHERITANCE = false; |
| |
| /** Defines if FOP should validate the user config strictly */ |
| public static final boolean DEFAULT_STRICT_USERCONFIG_VALIDATION = true; |
| |
| /** Defines if FOP should use strict validation for FO and user config */ |
| public static final boolean DEFAULT_STRICT_FO_VALIDATION = true; |
| |
| /** Defines the default page-width */ |
| public static final String DEFAULT_PAGE_WIDTH = "8.26in"; |
| |
| /** Defines the default page-height */ |
| public static final String DEFAULT_PAGE_HEIGHT = "11in"; |
| |
| /** Defines the default source resolution (72dpi) for FOP */ |
| public static final float DEFAULT_SOURCE_RESOLUTION = GraphicsConstants.DEFAULT_DPI; //dpi |
| |
| /** Defines the default target resolution (72dpi) for FOP */ |
| public static final float DEFAULT_TARGET_RESOLUTION = GraphicsConstants.DEFAULT_DPI; //dpi |
| |
| /** Defines the default complex script support */ |
| public static final boolean DEFAULT_COMPLEX_SCRIPT_FEATURES = true; |
| |
| private static final String PREFER_RENDERER = "prefer-renderer"; |
| |
| /** logger instance */ |
| private final Log log = LogFactory.getLog(FopFactoryConfigurator.class); |
| |
| /** Fop factory */ |
| private FopFactory factory = null; |
| |
| /** Fop factory configuration */ |
| private Configuration cfg = null; |
| |
| /** The base URI of the configuration file **/ |
| private URI baseURI = null; |
| |
| /** |
| * Default constructor |
| * @param factory fop factory |
| */ |
| public FopFactoryConfigurator(FopFactory factory) { |
| super(); |
| this.factory = factory; |
| } |
| |
| /** |
| * Initializes user agent settings from the user configuration |
| * file, if present: baseURL, resolution, default page size,... |
| * @param factory fop factory |
| * @throws FOPException fop exception |
| */ |
| public void configure(FopFactory factory) throws FOPException { // CSOK: MethodLength |
| // strict configuration |
| if (cfg.getChild("strict-configuration", false) != null) { |
| try { |
| factory.setStrictUserConfigValidation( |
| cfg.getChild("strict-configuration").getValueAsBoolean()); |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, false); |
| } |
| } |
| boolean strict = factory.validateUserConfigStrictly(); |
| if (log.isDebugEnabled()) { |
| log.debug("Initializing FopFactory Configuration" |
| + "with " + (strict ? "strict" : "permissive") + " validation"); |
| } |
| |
| if (cfg.getChild("accessibility", false) != null) { |
| try { |
| this.factory.setAccessibility( |
| cfg.getChild("accessibility").getValueAsBoolean()); |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, strict); |
| } |
| } |
| |
| // strict fo validation |
| if (cfg.getChild("strict-validation", false) != null) { |
| try { |
| factory.setStrictValidation( |
| cfg.getChild("strict-validation").getValueAsBoolean()); |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, strict); |
| } |
| } |
| |
| // base definitions for relative path resolution |
| if (cfg.getChild("base", false) != null) { |
| String path = cfg.getChild("base").getValue(null); |
| if (baseURI != null) { |
| path = baseURI.resolve(path).normalize().toString(); |
| } |
| try { |
| factory.setBaseURL(path); |
| } catch (MalformedURLException mfue) { |
| LogUtil.handleException(log, mfue, strict); |
| } |
| } |
| if (cfg.getChild("hyphenation-base", false) != null) { |
| String path = cfg.getChild("hyphenation-base").getValue(null); |
| if (baseURI != null) { |
| path = baseURI.resolve(path).normalize().toString(); |
| } |
| try { |
| factory.setHyphenBaseURL(path); |
| } catch (MalformedURLException mfue) { |
| LogUtil.handleException(log, mfue, strict); |
| } |
| } |
| |
| /** |
| * Read configuration elements hyphenation-pattern, |
| * construct a map ll_CC => filename, and set it on the factory |
| */ |
| Configuration[] hyphPatConfig = cfg.getChildren("hyphenation-pattern"); |
| if (hyphPatConfig.length != 0) { |
| Map/*<String,String>*/ hyphPatNames = new HashMap/*<String,String>*/(); |
| for (int i = 0; i < hyphPatConfig.length; ++i) { |
| String lang, country, filename; |
| StringBuffer error = new StringBuffer(); |
| String location = hyphPatConfig[i].getLocation(); |
| |
| lang = hyphPatConfig[i].getAttribute("lang", null); |
| if (lang == null) { |
| addError("The lang attribute of a hyphenation-pattern configuration" |
| + " element must exist (" + location + ")", error); |
| } else if (!lang.matches("[a-zA-Z]{2}")) { |
| addError("The lang attribute of a hyphenation-pattern configuration" |
| + " element must consist of exactly two letters (" |
| + location + ")", error); |
| } |
| lang = lang.toLowerCase(); |
| |
| country = hyphPatConfig[i].getAttribute("country", null); |
| if ("".equals(country)) { |
| country = null; |
| } |
| if (country != null) { |
| if (!country.matches("[a-zA-Z]{2}")) { |
| addError("The country attribute of a hyphenation-pattern configuration" |
| + " element must consist of exactly two letters (" |
| + location + ")", error); |
| } |
| country = country.toUpperCase(); |
| } |
| |
| filename = hyphPatConfig[i].getValue(null); |
| if (filename == null) { |
| addError("The value of a hyphenation-pattern configuration" |
| + " element may not be empty (" + location + ")", error); |
| } |
| |
| if (error.length() != 0) { |
| LogUtil.handleError(log, error.toString(), strict); |
| continue; |
| } |
| |
| String llccKey = HyphenationTreeCache.constructLlccKey(lang, country); |
| hyphPatNames.put(llccKey, filename); |
| if (log.isDebugEnabled()) { |
| log.debug("Using hyphenation pattern filename " + filename |
| + " for lang=\"" + lang + "\"" |
| + (country != null ? ", country=\"" + country + "\"" : "")); |
| } |
| } |
| factory.setHyphPatNames(hyphPatNames); |
| } |
| |
| // renderer options |
| if (cfg.getChild("source-resolution", false) != null) { |
| factory.setSourceResolution( |
| cfg.getChild("source-resolution").getValueAsFloat( |
| FopFactoryConfigurator.DEFAULT_SOURCE_RESOLUTION)); |
| if (log.isDebugEnabled()) { |
| log.debug("source-resolution set to: " + factory.getSourceResolution() |
| + "dpi (px2mm=" + factory.getSourcePixelUnitToMillimeter() + ")"); |
| } |
| } |
| if (cfg.getChild("target-resolution", false) != null) { |
| factory.setTargetResolution( |
| cfg.getChild("target-resolution").getValueAsFloat( |
| FopFactoryConfigurator.DEFAULT_TARGET_RESOLUTION)); |
| if (log.isDebugEnabled()) { |
| log.debug("target-resolution set to: " + factory.getTargetResolution() |
| + "dpi (px2mm=" + factory.getTargetPixelUnitToMillimeter() |
| + ")"); |
| } |
| } |
| if (cfg.getChild("break-indent-inheritance", false) != null) { |
| try { |
| factory.setBreakIndentInheritanceOnReferenceAreaBoundary( |
| cfg.getChild("break-indent-inheritance").getValueAsBoolean()); |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, strict); |
| } |
| } |
| Configuration pageConfig = cfg.getChild("default-page-settings"); |
| if (pageConfig.getAttribute("height", null) != null) { |
| factory.setPageHeight( |
| pageConfig.getAttribute("height", FopFactoryConfigurator.DEFAULT_PAGE_HEIGHT)); |
| if (log.isInfoEnabled()) { |
| log.info("Default page-height set to: " + factory.getPageHeight()); |
| } |
| } |
| if (pageConfig.getAttribute("width", null) != null) { |
| factory.setPageWidth( |
| pageConfig.getAttribute("width", FopFactoryConfigurator.DEFAULT_PAGE_WIDTH)); |
| if (log.isInfoEnabled()) { |
| log.info("Default page-width set to: " + factory.getPageWidth()); |
| } |
| } |
| |
| // prefer Renderer over IFDocumentHandler |
| if (cfg.getChild(PREFER_RENDERER, false) != null) { |
| try { |
| factory.getRendererFactory().setRendererPreferred( |
| cfg.getChild(PREFER_RENDERER).getValueAsBoolean()); |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, strict); |
| } |
| } |
| |
| // configure complex script support |
| Configuration csConfig = cfg.getChild("complex-scripts"); |
| if (csConfig != null) { |
| this.factory.setComplexScriptFeaturesEnabled |
| (!csConfig.getAttributeAsBoolean ( "disabled", false )); |
| } |
| |
| // configure font manager |
| new FontManagerConfigurator(cfg, baseURI).configure(factory.getFontManager(), strict); |
| |
| // configure image loader framework |
| configureImageLoading(cfg.getChild("image-loading", false), strict); |
| } |
| |
| private static void addError(String message, StringBuffer error) { |
| if (error.length() != 0) { |
| error.append(". "); |
| } |
| error.append(message); |
| } |
| |
| private void configureImageLoading(Configuration parent, boolean strict) throws FOPException { |
| if (parent == null) { |
| return; |
| } |
| ImageImplRegistry registry = factory.getImageManager().getRegistry(); |
| Configuration[] penalties = parent.getChildren("penalty"); |
| try { |
| for (int i = 0, c = penalties.length; i < c; i++) { |
| Configuration penaltyCfg = penalties[i]; |
| String className = penaltyCfg.getAttribute("class"); |
| String value = penaltyCfg.getAttribute("value"); |
| Penalty p = null; |
| if (value.toUpperCase().startsWith("INF")) { |
| p = Penalty.INFINITE_PENALTY; |
| } else { |
| try { |
| p = Penalty.toPenalty(Integer.parseInt(value)); |
| } catch (NumberFormatException nfe) { |
| LogUtil.handleException(log, nfe, strict); |
| } |
| } |
| if (p != null) { |
| registry.setAdditionalPenalty(className, p); |
| } |
| } |
| } catch (ConfigurationException e) { |
| LogUtil.handleException(log, e, strict); |
| } |
| } |
| |
| /** |
| * Set the user configuration. |
| * @param userConfigFile the configuration file |
| * @throws IOException if an I/O error occurs |
| * @throws SAXException if a parsing error occurs |
| */ |
| public void setUserConfig(File userConfigFile) throws SAXException, IOException { |
| try { |
| DefaultConfigurationBuilder cfgBuilder = new DefaultConfigurationBuilder(); |
| setUserConfig(cfgBuilder.buildFromFile(userConfigFile)); |
| } catch (ConfigurationException e) { |
| throw new FOPException(e); |
| } |
| } |
| |
| /** |
| * Set the user configuration from an URI. |
| * @param uri the URI to the configuration file |
| * @throws IOException if an I/O error occurs |
| * @throws SAXException if a parsing error occurs |
| */ |
| public void setUserConfig(String uri) throws SAXException, IOException { |
| try { |
| DefaultConfigurationBuilder cfgBuilder = new DefaultConfigurationBuilder(); |
| setUserConfig(cfgBuilder.build(uri)); |
| } catch (ConfigurationException e) { |
| throw new FOPException(e); |
| } |
| } |
| |
| /** |
| * Set the user configuration. |
| * @param cfg avalon configuration |
| * @throws FOPException if a configuration problem occurs |
| */ |
| public void setUserConfig(Configuration cfg) throws FOPException { |
| this.cfg = cfg; |
| setBaseURI(); |
| configure(this.factory); |
| } |
| |
| /** |
| * Get the avalon user configuration. |
| * @return the user configuration |
| */ |
| public Configuration getUserConfig() { |
| return this.cfg; |
| } |
| |
| /** |
| * @return the baseURI |
| */ |
| public URI getBaseURI() { |
| return baseURI; |
| } |
| |
| /** |
| * @param baseURI the baseURI to set |
| */ |
| public void setBaseURI(URI baseURI) { |
| this.baseURI = baseURI; |
| } |
| |
| private void setBaseURI() throws FOPException { |
| String loc = cfg.getLocation(); |
| try { |
| if (loc != null && loc.startsWith("file:")) { |
| baseURI = new URI(loc); |
| baseURI = baseURI.resolve(".").normalize(); |
| } |
| if (baseURI == null) { |
| baseURI = new File(System.getProperty("user.dir")).toURI(); |
| } |
| } catch (URISyntaxException e) { |
| throw new FOPException(e); |
| } |
| } |
| |
| } |