/*
* This program is free software; you can redistribute it and/or modify it under the
* terms of the GNU Lesser General Public License, version 2.1 as published by the Free Software
* Foundation.
*
* You should have received a copy of the GNU Lesser General Public License along with this
* program; if not, you can obtain a copy at http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
* or from the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the GNU Lesser General Public License for more details.
*
* Copyright (c) 2001 - 2013 Object Refinery Ltd, Pentaho Corporation and Contributors.. All rights reserved.
*/
package org.pentaho.reporting.engine.classic.core.modules.misc.datafactory;
import org.pentaho.reporting.engine.classic.core.DataFactory;
import org.pentaho.reporting.engine.classic.core.DataRow;
import org.pentaho.reporting.engine.classic.core.ReportDataFactoryException;
import javax.swing.table.TableModel;
import java.util.LinkedHashMap;
/**
* A NamedStaticDataFactory provides an query-aliasing facility to decouple the report definitions from the underlying
* datasource implentation. The reports no longer need to specify the raw-query (which is in fact just an implementation
* detail) and can use a symbolic name in the report definition instead.
*
* @author Thomas Morgner
*/
public class NamedStaticDataFactory extends StaticDataFactory {
private LinkedHashMap<String, String> querymappings;
/**
* Defaultconstructor.
*/
public NamedStaticDataFactory() {
querymappings = new LinkedHashMap<String, String>();
}
/**
* Checks whether the query would be executable by this datafactory. This performs a rough check, not a full query.
*
* @param query
* @param parameters
* @return
*/
public boolean isQueryExecutable( final String query, final DataRow parameters ) {
return querymappings.containsKey( query );
}
/**
* Adds an query-alias to this factory.
*
* @param alias
* the alias
* @param queryString
* the real query string that should be used when the alias is specified as query.
*/
public void setQuery( final String alias, final String queryString ) {
if ( queryString == null ) {
querymappings.remove( alias );
} else {
querymappings.put( alias, queryString );
}
}
/**
* Derives the factory. The derived factory does no longer share properties with its parent and changes to either
* factory will not be reflected in the other factory.
*
* @return the derived factory.
*/
public DataFactory derive() {
return clone();
}
/**
* Returns a clone of the factory.
*
* @return the clone.
*/
public NamedStaticDataFactory clone() {
final NamedStaticDataFactory nds = (NamedStaticDataFactory) super.clone();
nds.querymappings = (LinkedHashMap<String, String>) querymappings.clone();
return nds;
}
/**
* Queries a datasource. The string 'query' defines the name of the query. The Parameterset given here may contain
* more data than actually needed.
* <p/>
* The dataset may change between two calls, do not assume anything!
*
* @param query
* the alias-name of the query.
* @param parameters
* the set of parameters.
* @return the tablemodel.
*/
public TableModel queryData( final String query, final DataRow parameters ) throws ReportDataFactoryException {
if ( query == null ) {
throw new NullPointerException( "Query is null." ); //$NON-NLS-1$
}
final String realQuery = getQuery( query );
if ( realQuery == null ) {
throw new ReportDataFactoryException( "Query '" + query + "' is not recognized." ); //$NON-NLS-1$ //$NON-NLS-2$
}
return super.queryData( realQuery, parameters );
}
/**
* Returns the query for the given alias-name or null, if there is no such alias defined.
*
* @param name
* the alias name.
* @return the real query or null.
*/
public String getQuery( final String name ) {
return querymappings.get( name );
}
/**
* Returns all known alias-names.
*
* @return all alias-names as string-array.
*/
public String[] getQueryNames() {
return querymappings.keySet().toArray( new String[querymappings.size()] );
}
public String translateQuery( final String queryName ) {
return querymappings.get( queryName );
}
}