org.apache.forrest.conf.ForrestConfModule.java Source code

Java tutorial

Introduction

Here is the source code for org.apache.forrest.conf.ForrestConfModule.java

Source

/*
 * 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.
 */
package org.apache.forrest.conf;

import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.util.Enumeration;
import java.util.Iterator;
import java.util.Map;
import java.util.SortedSet;
import java.util.StringTokenizer;
import java.util.TreeSet;

import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;

import org.apache.avalon.framework.activity.Initializable;
import org.apache.avalon.framework.configuration.Configuration;
import org.apache.avalon.framework.configuration.ConfigurationException;
import org.apache.avalon.framework.service.ServiceException;
import org.apache.avalon.framework.service.ServiceManager;
import org.apache.avalon.framework.service.Serviceable;
import org.apache.avalon.framework.thread.ThreadSafe;
import org.apache.cocoon.components.modules.input.DefaultsModule;
import org.apache.cocoon.components.modules.input.InputModule;
import org.apache.commons.lang.SystemUtils;
import org.apache.excalibur.source.Source;
import org.apache.excalibur.source.SourceNotFoundException;
import org.apache.excalibur.source.SourceResolver;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import org.xml.sax.SAXException;

/**
 * Input module for accessing the base properties used in Forrest. The main
 * values are the locations of the <b>source </b> directories and of the
 * <b>forrest </b> directories. The values are gotten using the ForrestConfUtils
 * class.
 */
public class ForrestConfModule extends DefaultsModule
        implements InputModule, Initializable, ThreadSafe, Serviceable {
    private AntProperties filteringProperties;

    private String forrestHome, projectHome, contextHome;

    private SourceResolver m_resolver;

    public Object getAttribute(String name, Configuration modeConf, Map objectModel) throws ConfigurationException {
        String original;
        String attributeValue;

        try {
            original = super.getAttributeValues(name, modeConf, objectModel)[0].toString();
            attributeValue = this.getAttributeValues(name, modeConf, objectModel)[0].toString();
        } catch (NullPointerException npe) {
            original = "(not defined in forrest.xconf)";
            attributeValue = filteringProperties.getProperty(name);
            if (attributeValue == null) {
                String error = "Unable to get attribute value for " + name + "\n" + "Please make sure you defined "
                        + name + " in either forrest.properties.xml in $PROJECT_HOME "
                        + "or in the default.forrest.properties.xml of the plugin "
                        + "that is requesting this property." + "\n"
                        + "If you see this message, then most of the time you have spotted a plugin bug "
                        + "(i.e. forgot to define the plugin's default property). Please report to our mailing list.";
                throw new ConfigurationException(error);
            }
        }

        if (debugging()) {
            debug(" - Requested:" + name);
            debug(" - Unfiltered:" + original);
            debug(" - Given:" + attributeValue);
        }

        return attributeValue;
    }

    public Object[] getAttributeValues(String name, Configuration modeConf, Map objectModel)
            throws ConfigurationException {
        Object[] attributeValues = super.getAttributeValues(name, modeConf, objectModel);
        for (int i = 0; i < attributeValues.length; i++) {
            if (null != attributeValues[i])
                attributeValues[i] = filteringProperties.filter(attributeValues[i].toString());
            else
                attributeValues[i] = filteringProperties.filter(filteringProperties.getProperty(name));
        }

        return attributeValues;
    }

    public Iterator getAttributeNames(Configuration modeConf, Map objectModel) throws ConfigurationException {

        SortedSet matchset = new TreeSet();
        Enumeration enumeration = filteringProperties.keys();
        while (enumeration.hasMoreElements()) {
            String key = (String) enumeration.nextElement();
            matchset.add(key);
        }
        Iterator iterator = super.getAttributeNames(modeConf, objectModel);
        while (iterator.hasNext())
            matchset.add(iterator.next());
        return matchset.iterator();
    }

    public void initialize() throws Exception {

        // add all homes important to forrest to the properties
        setHomes();

        loadSystemProperties(filteringProperties);

        // NOTE: the first values set get precedence, as in AntProperties

        String forrestPropertiesStringURI;

        try {
            // get forrest.properties and load the values
            forrestPropertiesStringURI = projectHome + SystemUtils.FILE_SEPARATOR + "forrest.properties";
            filteringProperties = loadAntPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);

            // get the values from local.forrest.properties.xml
            forrestPropertiesStringURI = projectHome + SystemUtils.FILE_SEPARATOR + "local.forrest.properties.xml";
            filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);

            // get the values from project forrest.properties.xml
            forrestPropertiesStringURI = projectHome + SystemUtils.FILE_SEPARATOR + "forrest.properties.xml";
            filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);

            // get the values from user forrest.properties.xml
            String userHome = filteringProperties.getProperty("user.home");
            if (userHome != null) {
                forrestPropertiesStringURI = userHome + SystemUtils.FILE_SEPARATOR + "forrest.properties.xml";
                filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);
            }

            // get the values from global forrest.properties.xml
            String globalHome = filteringProperties.getProperty("global.home");
            if (globalHome != null) {
                forrestPropertiesStringURI = globalHome + SystemUtils.FILE_SEPARATOR + "forrest.properties.xml";
                filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);
            }

            // get the values from default.forrest.properties.xml
            forrestPropertiesStringURI = contextHome + SystemUtils.FILE_SEPARATOR
                    + "default.forrest.properties.xml";
            filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);

            // Load plugin default properties
            String strPluginList = filteringProperties.getProperty("project.required.plugins");
            if (strPluginList != null) {
                StringTokenizer st = new StringTokenizer(strPluginList, ",");
                while (st.hasMoreTokens()) {
                    forrestPropertiesStringURI = ForrestConfUtils.getPluginDir(st.nextToken().trim());
                    forrestPropertiesStringURI = forrestPropertiesStringURI + SystemUtils.FILE_SEPARATOR
                            + "default.plugin.properties.xml";
                    filteringProperties = loadXMLPropertiesFromURI(filteringProperties, forrestPropertiesStringURI);
                }
            }

            // get default-forrest.properties and load the values
            String defaultForrestPropertiesStringURI = contextHome + SystemUtils.FILE_SEPARATOR
                    + "default-forrest.properties";
            filteringProperties = loadAntPropertiesFromURI(filteringProperties, defaultForrestPropertiesStringURI);
        } finally {
            ForrestConfUtils.aliasSkinProperties(filteringProperties);
            if (debugging())
                debug("Loaded project properties:" + filteringProperties);
        }
    }

    /**
     * Sets all forrest related home locations such as - forrestHome -
     * projectHome - contextHome
     * 
     * @throws Exception
     */
    private void setHomes() throws Exception {
        forrestHome = ForrestConfUtils.getForrestHome();
        projectHome = ForrestConfUtils.getProjectHome();
        contextHome = ForrestConfUtils.getContextHome();

        filteringProperties = new AntProperties();

        filteringProperties.setProperty("forrest.home", forrestHome);
        filteringProperties.setProperty("project.home", projectHome);
        filteringProperties.setProperty("context.home", contextHome);
    }

    /**
     * Load system properties
     */
    private void loadSystemProperties(AntProperties props) {
        for (Enumeration e = System.getProperties().propertyNames(); e.hasMoreElements();) {
            String propName = (String) e.nextElement();
            if (propName.startsWith("forrest.") || propName.startsWith("project.") || propName.endsWith(".home")) {
                String systemPropValue = System.getProperty(propName);
                if (systemPropValue != null) {
                    props.setProperty(propName, systemPropValue);
                }
            }
        }
    }

    /**
     * @param antPropertiesStringURI
     * @throws MalformedURLException
     * @throws IOException
     * @throws SourceNotFoundException
     */
    private AntProperties loadAntPropertiesFromURI(AntProperties precedingProperties, String antPropertiesStringURI)
            throws MalformedURLException, IOException, SourceNotFoundException {

        Source source = null;
        InputStream in = null;
        try {
            source = m_resolver.resolveURI(antPropertiesStringURI);
            if (debugging())
                debug("Searching for forrest.properties in" + source.getURI());
            if (source.exists()) {
                in = source.getInputStream();
                filteringProperties = new AntProperties(precedingProperties);
                filteringProperties.load(in);

                if (debugging())
                    debug("Loaded:" + antPropertiesStringURI + filteringProperties.toString());
            }

        } finally {
            if (source != null) {
                m_resolver.release(source);
            }
            if (in != null) {
                try {
                    in.close();
                } catch (IOException e) {
                }
            }
        }

        return filteringProperties;
    }

    /**
     * @param propertiesStringURI
     * @throws IOException
     * @throws MalformedURLException
     * @throws MalformedURLException
     * @throws IOException
     * @throws ParserConfigurationException
     * @throws SAXException
     * @throws SourceNotFoundException
     */
    private AntProperties loadXMLPropertiesFromURI(AntProperties precedingProperties, String propertiesStringURI)
            throws MalformedURLException, IOException, ParserConfigurationException, SAXException {

        Source source = null;
        InputStream in = null;
        try {
            source = m_resolver.resolveURI(propertiesStringURI);
            if (debugging())
                debug("Searching for forrest.properties.xml in " + source.getURI());
            if (source.exists()) {

                DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
                DocumentBuilder builder = factory.newDocumentBuilder();
                Document document = builder.parse(source.getURI());

                NodeList nl = document.getElementsByTagName("property");
                if (nl != null && nl.getLength() > 0) {
                    for (int i = 0; i < nl.getLength(); i++) {
                        Element el = (Element) nl.item(i);
                        filteringProperties.setProperty(el.getAttribute("name"), el.getAttribute("value"));
                    }
                }

                if (debugging())
                    debug("Loaded:" + propertiesStringURI + filteringProperties.toString());
            } else if (debugging())
                debug("Unable to find " + source.getURI() + ", ignoring.");

        } finally {
            if (source != null) {
                m_resolver.release(source);
            }
            if (in != null) {
                try {
                    in.close();
                } catch (IOException e) {
                }
            }
        }

        return filteringProperties;
    }

    public void service(ServiceManager manager) throws ServiceException {
        m_resolver = (SourceResolver) manager.lookup(SourceResolver.ROLE);
    }

    /**
     * Rocked science
     */
    private final boolean debugging() {
        return getLogger().isDebugEnabled();
    }

    /**
     * Rocked science
     * 
     * @param debugString
     */
    private final void debug(String debugString) {
        getLogger().debug(debugString);
    }

}