com.espertech.esperio.db.config.ConfigurationDBAdapter Maven / Gradle / Ivy
/**************************************************************************************
* Copyright (C) 2008 EsperTech, Inc. All rights reserved. *
* http://esper.codehaus.org *
* http://www.espertech.com *
* ---------------------------------------------------------------------------------- *
* The software in this package is published under the terms of the GPL license *
* a copy of which has been included with this distribution in the license.txt file. *
**************************************************************************************/
package com.espertech.esperio.db.config;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.w3c.dom.Document;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.io.*;
import java.net.URL;
import com.espertech.esper.client.ConfigurationDBRef;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
public class ConfigurationDBAdapter {
private static Log log = LogFactory.getLog(ConfigurationDBAdapter.class);
private Map jdbcConnections;
private List dmlQueries;
private List upsertQueries;
private Map executors;
public ConfigurationDBAdapter() {
jdbcConnections = new HashMap();
dmlQueries = new ArrayList();
upsertQueries = new ArrayList();
upsertQueries = new ArrayList();
executors = new HashMap();
}
public Map getJdbcConnections() {
return jdbcConnections;
}
public void setJdbcConnections(Map jdbcConnections) {
this.jdbcConnections = jdbcConnections;
}
public List getDmlQueries() {
return dmlQueries;
}
public void setDmlQueries(List dmlQueries) {
this.dmlQueries = dmlQueries;
}
public List getUpsertQueries() {
return upsertQueries;
}
public void setUpsertQueries(List upsertQueries) {
this.upsertQueries = upsertQueries;
}
public Map getExecutors() {
return executors;
}
public void setExecutors(Map executors) {
this.executors = executors;
}
/**
* Use the configuration specified in an application
* resource named esper.cfg.xml.
* @return Configuration initialized from the resource
* @throws RuntimeException thrown to indicate error reading configuration
*/
public ConfigurationDBAdapter configure() throws RuntimeException
{
configure('/' + "esperio.db.cfg.xml");
return this;
}
/**
* Use the ConfigurationDBAdapter specified in the given application
* resource. The format of the resource is defined in
* esper-configuration-2.0.xsd.
*
* The resource is found via getConfigurationInputStream(resource).
* That method can be overridden to implement an arbitrary lookup strategy.
*
* See getResourceAsStream for information on how the resource name is resolved.
* @param resource if the file name of the resource
* @return ConfigurationDBAdapter initialized from the resource
* @throws RuntimeException thrown to indicate error reading configuration
*/
public ConfigurationDBAdapter configure(String resource) throws RuntimeException
{
if (log.isInfoEnabled())
{
log.info( "Configuring from resource: " + resource );
}
InputStream stream = getConfigurationInputStream(resource );
ConfigurationDBAdapterParser.doConfigure(this, stream, resource );
return this;
}
/**
* Get the ConfigurationDBAdapter file as an InputStream. Might be overridden
* by subclasses to allow the ConfigurationDBAdapter to be located by some arbitrary
* mechanism.
*
* See getResourceAsStream for information on how the resource name is resolved.
* @param resource is the resource name
* @return input stream for resource
* @throws RuntimeException thrown to indicate error reading configuration
*/
protected static InputStream getConfigurationInputStream(String resource) throws RuntimeException
{
return getResourceAsStream(resource);
}
/**
* Use the ConfigurationDBAdapter specified by the given XML String.
* The format of the document obtained from the URL is defined in
* esper-configuration-2.0.xsd.
*
* @param xml XML string
* @return A ConfigurationDBAdapter configured via the file
* @throws RuntimeException is thrown when the URL could not be access
*/
public ConfigurationDBAdapter configureFromString(String xml) throws RuntimeException
{
if (log.isInfoEnabled())
{
log.info( "Configuring from string");
}
try {
InputSource source = new InputSource(new StringReader(xml));
DocumentBuilderFactory builderFactory = DocumentBuilderFactory.newInstance();
builderFactory.setNamespaceAware(true);
Document doc = builderFactory.newDocumentBuilder().parse(source);
ConfigurationDBAdapterParser.doConfigure(this, doc);
return this;
}
catch (IOException ioe) {
throw new RuntimeException("could not configure from String: " + ioe.getMessage(), ioe );
} catch (SAXException e) {
throw new RuntimeException("could not configure from String: " + e.getMessage(), e );
} catch (ParserConfigurationException e) {
throw new RuntimeException("could not configure from String: " + e.getMessage(), e );
}
}
/**
* Use the ConfigurationDBAdapter specified by the given URL.
* The format of the document obtained from the URL is defined in
* esper-configuration-2.0.xsd.
*
* @param url URL from which you wish to load the configuration
* @return A ConfigurationDBAdapter configured via the file
* @throws RuntimeException is thrown when the URL could not be access
*/
public ConfigurationDBAdapter configure(URL url) throws RuntimeException
{
if (log.isInfoEnabled())
{
log.info( "Configuring from url: " + url.toString() );
}
try {
ConfigurationDBAdapterParser.doConfigure(this, url.openStream(), url.toString());
return this;
}
catch (IOException ioe) {
throw new RuntimeException("could not configure from URL: " + url, ioe );
}
}
/**
* Returns an input stream from an application resource in the classpath.
*
* The method first removes the '/' character from the resource name if
* the first character is '/'.
*
* The lookup order is as follows:
*
* If a thread context class loader exists, use Thread.currentThread().getResourceAsStream
* to obtain an InputStream.
*
* If no input stream was returned, use the Configuration.class.getResourceAsStream.
* to obtain an InputStream.
*
* If no input stream was returned, use the Configuration.class.getClassLoader().getResourceAsStream.
* to obtain an InputStream.
*
* If no input stream was returned, throw an Exception.
*
* @param resource to get input stream for
* @return input stream for resource
*/
protected static InputStream getResourceAsStream(String resource)
{
String stripped = resource.startsWith("/") ?
resource.substring(1) : resource;
InputStream stream = null;
ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
if (classLoader!=null) {
stream = classLoader.getResourceAsStream( stripped );
}
if ( stream == null ) {
stream = ConfigurationDBAdapter.class.getResourceAsStream( resource );
}
if ( stream == null ) {
stream = ConfigurationDBAdapter.class.getClassLoader().getResourceAsStream( stripped );
}
if ( stream == null ) {
throw new RuntimeException( resource + " not found" );
}
return stream;
}
/**
* Use the ConfigurationDBAdapter specified in the given application
* file. The format of the file is defined in
* esper-configuration-2.0.xsd.
*
* @param configFile File from which you wish to load the configuration
* @return A ConfigurationDBAdapter configured via the file
* @throws RuntimeException when the file could not be found
*/
public ConfigurationDBAdapter configure(File configFile) throws RuntimeException
{
if (log.isDebugEnabled())
{
log.debug( "configuring from file: " + configFile.getName() );
}
try {
ConfigurationDBAdapterParser.doConfigure(this, new FileInputStream(configFile), configFile.toString());
}
catch (FileNotFoundException fnfe) {
throw new RuntimeException( "could not find file: " + configFile, fnfe );
}
return this;
}
}