/**
* Copyright (c) 2014 by the original author or authors.
*
* This code is free software; you can redistribute it and/or modify it under the terms of the
* GNU Lesser General Public License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* The above copyright notice and this permission notice shall be included in all copies or
* substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
* BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
package ch.sdi.core.impl.data.converter;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.ApplicationContext;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component;
import org.springframework.util.StringUtils;
import ch.sdi.core.annotations.SdiConverter;
import ch.sdi.core.exc.SdiException;
import ch.sdi.core.intf.FieldConverter;
import ch.sdi.core.intf.SdiMainProperties;
/**
* Retrieves the converters which are responsible to convert collected field values in the desired
* data type. Collector converters are derived from ch.sdi.core.intf.FieldConverter<T> and have the
* annotation ch.sdi.core.annotations.SdiConverter. The configuration determines which converter
* is responsible for which field during the collection phase (see SdiMainProperties.properties)
* <p>
*
* @version 1.0 (09.11.2014)
* @author Heri
*/
@Component
public class ConverterFactory
{
/** logger for this class */
private Logger myLog = LogManager.getLogger( ConverterFactory.class );
@Autowired
private ApplicationContext myAppCtxt;
/**
* Looks up the configured converters for the given collector fieldnames.
* <p>
* If for a particular field no configured is configured the standard ConverterString() (which
* does nothing) is returned.
* <p>
*
* @param aFieldnames
* @return a list of appropriate converters, ordered in the same order as the given fieldnames
* @throws SdiException if one of the configured converters cannot be found
*/
public List<FieldConverter<?>> getFieldConverters( Collection<String> aFieldnames ) throws SdiException
{
List<FieldConverter<?>> result = new ArrayList<FieldConverter<?>>();
for ( String fieldname : aFieldnames )
{
FieldConverter<?> converter = getConverterFor( fieldname );
myLog.trace( "Converter for field " + fieldname + ": " + converter.getClass().getSimpleName() );
result.add( converter );
}
return result;
}
/**
* Looks up the configured converter for a collector fieldname.
* <p>
* If the fieldname has no configured converter the standard ConverterString() (which does nothing) is
* returned.
* <p>
*
* @param aFieldname must not be empty
* @return the appropriate converter
* @throws SdiException if the configured converter cannot be found
*/
public FieldConverter<?> getConverterFor( String aFieldname ) throws SdiException
{
if ( !StringUtils.hasText( aFieldname ) )
{
throw new SdiException( "Given fieldname is empty!",
SdiException.EXIT_CODE_UNKNOWN_ERROR );
} // if !StringUtils.hasText( aFieldname )
myLog.debug( "Looking up converter for field " + aFieldname );
Environment env = myAppCtxt.getEnvironment();
String converterName = env.getProperty( SdiMainProperties.KEY_PREFIX_CONVERTER + aFieldname );
if ( !StringUtils.hasText( converterName ) )
{
return new ConverterString().init( env, aFieldname );
} // if !StringUtils.hasText( converterName )
myLog.debug( "Looking up converter with name " + converterName );
Map<String, Object> beans = myAppCtxt.getBeansWithAnnotation( SdiConverter.class );
myLog.trace( "Found candidates for converter: " + beans.keySet() );
for ( Object bean : beans.values() )
{
if ( !( bean instanceof FieldConverter ) )
{
throw new SdiException( "Bean annotated with @SdiConverter which is not a FieldConverter, but: "
+ bean.getClass().getName(),
SdiException.EXIT_CODE_CONFIG_ERROR );
} // if !bean instanceof FieldConverter
FieldConverter<?> converter = (FieldConverter<?>) bean;
SdiConverter annotation = bean.getClass().getAnnotation( SdiConverter.class );
String value = annotation.value();
if ( converterName.equals( value ) )
{
return converter.init( env, aFieldname );
} // if converterName.equals( value )
}
throw new SdiException( "Converter " + converterName + " for field '" + aFieldname + "' not found",
SdiException.EXIT_CODE_CONFIG_ERROR );
}
}