All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.cayenne.tools.CayenneGenerator Maven / Gradle / Ivy

There is a newer version: 2.0.4
Show newest version
/*****************************************************************
 *   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.cayenne.tools;

import java.io.File;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;

import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.types.Path;
import org.apache.cayenne.gen.AntClassGenerator;
import org.apache.cayenne.gen.ClassGenerator;
import org.apache.cayenne.gen.DefaultClassGenerator;
import org.apache.cayenne.map.DataMap;
import org.apache.cayenne.map.EntityResolver;
import org.apache.cayenne.map.MapLoader;
import org.apache.cayenne.map.ObjEntity;
import org.apache.cayenne.util.Util;
import org.xml.sax.InputSource;

import foundrylogic.vpp.VPPConfig;

/**
 * Ant task to perform class generation from data map. This class is an Ant adapter to
 * DefaultClassGenerator class.
 * 
 * @author Andrus Adamchik
 */
public class CayenneGenerator extends CayenneTask {

    protected String includeEntitiesPattern;
    protected String excludeEntitiesPattern;
    protected VPPConfig vppConfig;

    protected File map;
    protected File additionalMaps[];
    protected DefaultClassGenerator generator;

    public CayenneGenerator() {
        generator = createGenerator();
    }

    /**
     * Factory method to create internal class generator. Called from constructor.
     */
    protected DefaultClassGenerator createGenerator() {
        AntClassGenerator gen = new AntClassGenerator();
        gen.setParentTask(this);
        return gen;
    }

    /**
     * Executes the task. It will be called by ant framework.
     */
    public void execute() throws BuildException {
        configureLogging();
        validateAttributes();

        try {
            processMap();
        }
        catch (Throwable th) {
            th = Util.unwindException(th);

            String thMessage = th.getLocalizedMessage();
            String message = "Error generating classes: ";
            message += (!Util.isEmptyString(thMessage)) ? thMessage : th
                    .getClass()
                    .getName();

            super.log(message);
            throw new BuildException(message, th);
        }
    }

    protected void processMap() throws Exception {

        DataMap dataMap = loadDataMap();
        DataMap additionalDataMaps[] = loadAdditionalDataMaps();

        // Create MappingNamespace for maps.
        EntityResolver entityResolver = new EntityResolver(Collections.singleton(dataMap));
        dataMap.setNamespace(entityResolver);
        for (int i = 0; i < additionalDataMaps.length; i++) {
            entityResolver.addDataMap(additionalDataMaps[i]);
            additionalDataMaps[i].setNamespace(entityResolver);
        }

        Collection allEntities = dataMap.getObjEntities();
        List filteredEntities = new ArrayList(allEntities.size());

        // filter client entities
        if (generator.isClient()) {
            if (dataMap.isClientSupported()) {
                Iterator it = allEntities.iterator();
                while (it.hasNext()) {
                    ObjEntity entity = (ObjEntity) it.next();
                    if (entity.isClientAllowed()) {
                        filteredEntities.add(entity);
                    }
                }
            }
        }
        else {
            filteredEntities.addAll(allEntities);
        }

        // filter names according to the specified pattern
        NamePatternMatcher namePatternMatcher = new NamePatternMatcher(
                this,
                includeEntitiesPattern,
                excludeEntitiesPattern);
        namePatternMatcher.filter(filteredEntities);

        if (false == ClassGenerator.VERSION_1_1.equals(generator.getVersionString())) {
            initializeVppConfig();
            generator.setVppConfig(vppConfig);
        }

        generator.setTimestamp(map.lastModified());
        generator.setDataMap(dataMap);
        generator.setObjEntities(filteredEntities);
        generator.validateAttributes();
        generator.execute();
    }

    /** Loads and returns a DataMap by File. */
    protected DataMap loadDataMap(File mapName) throws Exception {
        InputSource in = new InputSource(mapName.getCanonicalPath());
        return new MapLoader().loadDataMap(in);
    }

    /** Loads and returns DataMap based on map attribute. */
    protected DataMap loadDataMap() throws Exception {
        return loadDataMap(map);
    }

    /** Loads and returns DataMap based on map attribute. */
    protected DataMap[] loadAdditionalDataMaps() throws Exception {
        if (null == additionalMaps) {
            return new DataMap[0];
        }

        DataMap dataMaps[] = new DataMap[additionalMaps.length];
        for (int i = 0; i < additionalMaps.length; i++) {
            dataMaps[i] = loadDataMap(additionalMaps[i]);
        }
        return dataMaps;
    }

    /**
     * Validates atttributes that are not related to internal DefaultClassGenerator.
     * Throws BuildException if attributes are invalid.
     */
    protected void validateAttributes() throws BuildException {
        if (map == null && this.getProject() == null) {
            throw new BuildException("either 'map' or 'project' is required.");
        }
    }

    /**
     * Sets the map.
     * 
     * @param map The map to set
     */
    public void setMap(File map) {
        this.map = map;
    }

    /**
     * Sets the additional DataMaps.
     * 
     * @param additionalMapsPath The additional DataMaps to set
     */
    public void setAdditionalMaps(Path additionalMapsPath) {
        String additionalMapFilenames[] = additionalMapsPath.list();
        this.additionalMaps = new File[additionalMapFilenames.length];

        for (int i = 0; i < additionalMapFilenames.length; i++) {
            additionalMaps[i] = new File(additionalMapFilenames[i]);
        }
    }

    /**
     * Sets the destDir.
     */
    public void setDestDir(File destDir) {
        generator.setDestDir(destDir);
    }

    /**
     * Sets overwrite property.
     */
    public void setOverwrite(boolean overwrite) {
        generator.setOverwrite(overwrite);
    }

    /**
     * Sets makepairs property.
     */
    public void setMakepairs(boolean makepairs) {
        generator.setMakePairs(makepairs);
    }

    /**
     * Sets template property.
     */
    public void setTemplate(String template) {
        generator.setTemplate(template);
    }

    /**
     * Sets supertemplate property.
     */
    public void setSupertemplate(String supertemplate) {
        generator.setSuperTemplate(supertemplate);
    }

    /**
     * Sets usepkgpath property.
     */
    public void setUsepkgpath(boolean usepkgpath) {
        generator.setUsePkgPath(usepkgpath);
    }

    /**
     * Sets superpkg property.
     */
    public void setSuperpkg(String superpkg) {
        generator.setSuperPkg(superpkg);
    }

    /**
     * Sets client property.
     * 
     * @since 1.2
     */
    public void setClient(boolean client) {
        generator.setClient(client);
    }

    /**
     * Sets version property.
     * 
     * @since 1.2
     */
    public void setVersion(String versionString) {
        try {
            generator.setVersionString(versionString);
        }
        catch (IllegalStateException e) {
            throw new BuildException(e.getMessage(), e);
        }
    }

    /**
     * Sets encoding property that allows to generate files using
     * non-default encoding.
     * 
     * @since 1.2
     */
    public void setEncoding(String encoding) {
        generator.setEncoding(encoding);
    }

    /**
     * Sets excludeEntitiesPattern property.
     * 
     * @since 1.2
     */
    public void setExcludeEntities(String excludeEntitiesPattern) {
        this.excludeEntitiesPattern = excludeEntitiesPattern;
    }

    /**
     * Sets includeEntitiesPattern property.
     * 
     * @since 1.2
     */
    public void setIncludeEntities(String includeEntitiesPattern) {
        this.includeEntitiesPattern = includeEntitiesPattern;
    }

    /**
     * Sets outputPattern property.
     * 
     * @since 1.2
     */
    public void setOutputPattern(String outputPattern) {
        generator.setOutputPattern(outputPattern);
    }

    /**
     * Sets outputPattern property.
     * 
     * @since 1.2
     */
    public void setMode(String mode) {
        generator.setMode(mode);
    }

    /**
     * Provides a VPPConfig objec to configure. (Written with
     * createConfig() instead of addConfig() to avoid run-time dependency on VPP).
     * 
     * @since 1.2
     */
    public Object createConfig() {
        this.vppConfig = new VPPConfig();
        return this.vppConfig;
    }

    /**
     * If no VppConfig element specified, use the default one.
     * 
     * @since 1.2
     */
    private void initializeVppConfig() {
        if (vppConfig == null) {
            vppConfig = VPPConfig.getDefaultConfig(getProject());
        }
    }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy