org.milyn.javabean.gen.ConfigGenerator Maven / Gradle / Ivy
The newest version!
/*
Milyn - Copyright (C) 2006 - 2010
This library 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.
This library 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:
http://www.gnu.org/licenses/lgpl.txt
*/
package org.milyn.javabean.gen;
import org.milyn.assertion.AssertArgument;
import org.milyn.javabean.DataDecoder;
import org.milyn.javabean.gen.model.BindingConfig;
import org.milyn.javabean.gen.model.ClassConfig;
import org.milyn.util.FreeMarkerTemplate;
import java.io.*;
import java.lang.reflect.Field;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.util.*;
/**
* Java binding configuration template generator.
* Usage
* From the commandline:
*
* {@code
* $JAVA_HOME/bin/java -classpath org.milyn.javabean.gen.ConfigGenerator -c -o [-p ]
* }
*
* - The "-c" commandline arg specifies the root class of the model whose binding config is to be generated.
* - The "-o" commandline arg specifies the path and filename for the generated config output.
* - The "-p" commandline arg specifies the path and filename optional binding configuration file that specifies aditional binding parameters.
*
*
* The optional "-p" properties file parameter allows specification of additional config parameters:
*
* - packages.included: Semi-colon separated list of packages. Any fields in the class matching these packages will be included in the binding configuration generated.
* - packages.excluded: Semi-colon separated list of packages. Any fields in the class matching these packages will be excluded from the binding configuration generated.
*
*
* @author [email protected]
*/
public class ConfigGenerator {
public static final String ROOT_BEAN_CLASS = "root.beanClass";
public static final String PACKAGES_INCLUDED = "packages.included";
public static final String PACKAGES_EXCLUDED = "packages.excluded";
private Writer outputWriter;
private Class rootBeanClass;
private List packagesIncluded;
private List packagesExcluded;
private Stack> classStack = new Stack>();
public static void main(String args[]) throws IOException, ClassNotFoundException {
String rootBeanClassName = getArgument("-c", "Root Bean Class Name", true, args);
String outputFileName = getArgument("-o", "Output File Path", true, args);
String propertiesFile = getArgument("-p", "Binding Generation Config File Path", false, args);
Properties properties = loadProperties(propertiesFile);
File outputFile = new File(outputFileName);
properties.setProperty(ROOT_BEAN_CLASS, rootBeanClassName);
outputFile.getParentFile().mkdirs();
Writer outputWriter = new FileWriter(outputFile);
try {
ConfigGenerator generator = new ConfigGenerator(properties, outputWriter);
generator.generate();
} finally {
try {
outputWriter.flush();
} finally {
outputWriter.close();
}
}
}
public ConfigGenerator(Properties bindingProperties, Writer outputWriter) throws ClassNotFoundException {
AssertArgument.isNotNull(bindingProperties, "bindingProperties");
AssertArgument.isNotNull(outputWriter, "outputWriter");
this.outputWriter = outputWriter;
configure(bindingProperties);
}
public void generate() throws IOException {
Map> templatingContextObject = new HashMap>();
List classConfigs = new ArrayList();
FreeMarkerTemplate template;
addClassConfig(classConfigs, rootBeanClass, null);
template = new FreeMarkerTemplate("templates/bindingConfig.ftl.xml", getClass());
templatingContextObject.put("classConfigs", classConfigs);
outputWriter.write(template.apply(templatingContextObject));
}
private ClassConfig addClassConfig(List classConfigs, Class beanClass, String beanId) {
if(classStack.contains(beanClass)) {
// Don't go into an endless loop... stack overflow etc...
return null;
}
classStack.push(beanClass);
try {
ClassConfig classConfig = new ClassConfig(beanClass, beanId);
Field[] fields = beanClass.getDeclaredFields();
List bindings = classConfig.getBindings();
String rootPackage = rootBeanClass.getPackage().getName();
classConfigs.add(classConfig);
for(Field field : fields) {
Class type = field.getType();
Class decoder = DataDecoder.Factory.getInstance(type);
if(decoder != null) {
bindings.add(new BindingConfig(field));
} else {
if(type.isArray()) {
addArrayConfig(classConfigs, bindings, rootPackage, field);
} else if(Collection.class.isAssignableFrom(type)) {
addCollectionConfig(classConfigs, bindings, rootPackage, field);
} else {
String typePackage = type.getPackage().getName();
if(isExcluded(typePackage)) {
continue;
} else if(typePackage.startsWith(rootPackage) || isIncluded(typePackage)) {
bindings.add(new BindingConfig(field, field.getName()));
addClassConfig(classConfigs, type, field.getName());
}
}
}
}
return classConfig;
} finally {
classStack.pop();
}
}
private void addArrayConfig(List classConfigs, List bindings, String rootPackage, Field field) {
Class type = field.getType();
Class arrayType = type.getComponentType();
String wireBeanId = field.getName() + "_entry";
String typePackage = arrayType.getPackage().getName();
if(isExcluded(typePackage)) {
return;
} else if(typePackage.startsWith(rootPackage) || isIncluded(typePackage)) {
ClassConfig arrayConfig = new ClassConfig(arrayType, field.getName());
arrayConfig.getBindings().add(new BindingConfig(wireBeanId));
arrayConfig.setArray(true);
classConfigs.add(arrayConfig);
bindings.add(new BindingConfig(field, field.getName()));
addClassConfig(classConfigs, arrayType, wireBeanId);
}
}
private void addCollectionConfig(List classConfigs, List bindings, String rootPackage, Field field) {
ParameterizedType paramType = (ParameterizedType) field.getGenericType();
Type[] types = paramType.getActualTypeArguments();
if(types.length == 0) {
// No generics info. Can't infer anything...
} else {
Class type = (Class) types[0];
String wireBeanId = field.getName() + "_entry";
String typePackage = type.getPackage().getName();
if(isExcluded(typePackage)) {
return;
} else if(typePackage.startsWith(rootPackage) || isIncluded(typePackage)) {
ClassConfig listConfig = new ClassConfig(ArrayList.class, field.getName());
listConfig.getBindings().add(new BindingConfig(wireBeanId));
classConfigs.add(listConfig);
bindings.add(new BindingConfig(field, field.getName()));
addClassConfig(classConfigs, type, wireBeanId);
}
}
}
private boolean isIncluded(String packageName) {
if(packagesIncluded != null) {
if(isInPackageList(packagesIncluded, packageName)) {
return true;
}
}
return false;
}
private boolean isExcluded(String packageName) {
if(packagesExcluded != null) {
if(isInPackageList(packagesExcluded, packageName)) {
return true;
}
}
return false;
}
private boolean isInPackageList(List packages, String typePackage) {
for (String packageName : packages) {
if(typePackage.startsWith(packageName)) {
return true;
}
}
return false;
}
private void configure(Properties bindingProperties) throws ClassNotFoundException {
String rootBeanClassConfig = bindingProperties.getProperty(ConfigGenerator.ROOT_BEAN_CLASS);
String packagesIncludedConfig = bindingProperties.getProperty(ConfigGenerator.PACKAGES_INCLUDED);
String packagesExcludedConfig = bindingProperties.getProperty(ConfigGenerator.PACKAGES_EXCLUDED);
if(rootBeanClassConfig == null) {
throw new IllegalArgumentException("Binding configuration property '" + ConfigGenerator.ROOT_BEAN_CLASS + "' not defined.");
}
rootBeanClass = Class.forName(rootBeanClassConfig);
if(packagesIncludedConfig != null) {
packagesIncluded = parsePackages(packagesIncludedConfig);
}
if(packagesExcludedConfig != null) {
packagesExcluded = parsePackages(packagesExcludedConfig);
}
}
private List parsePackages(String packagesString) {
String[] packages = packagesString.split(";");
List packagesSet = new ArrayList();
for(String aPackage : packages) {
packagesSet.add(aPackage.trim());
}
return packagesSet;
}
private static Properties loadProperties(String fileName) throws IOException {
Properties properties = new Properties();
if(fileName != null) {
File propertiesFile = new File(fileName);
if(!propertiesFile.exists()) {
throw new IllegalArgumentException("Binding configuration properties file '" + propertiesFile.getAbsolutePath() + "' doesn't exist. See class Javadoc.");
}
InputStream stream = new FileInputStream(propertiesFile);
try {
properties.load(stream);
} finally {
stream.close();
}
}
return properties;
}
private static String getArgument(String argAlias, String argName, boolean mandatory, String[] args) {
for(int i = 0; i < args.length; i++) {
if(args[i].equalsIgnoreCase(argAlias) && i + 1 < args.length) {
return args[i + 1].trim();
}
}
if(mandatory) {
throw new IllegalArgumentException("Binding configuration error. Missing value for commandline arg '" + argAlias + "' (" + argName + ")'.");
}
return null;
}
}