org.databene.benerator.composite.MultiComponentBuilder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of databene-benerator Show documentation

benerator is a framework for creating realistic and valid high-volume test data, used for testing (unit/integration/load) and showcase setup. Metadata constraints are imported from systems and/or configuration files. Data can imported from and exported to files and systems, anonymized or generated from scratch. Domain packages provide reusable generators for creating domain-specific data as names and addresses internationalizable in language and region. It is strongly customizable with plugins and configuration options.

The newest version!

/*
 * (c) Copyright 2008-2013 by Volker Bergmann. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, is permitted under the terms of the
 * GNU General Public License.
 *
 * For redistributing this software or a derivative work under a license other
 * than the GPL-compatible Free Software License as defined by the Free
 * Software Foundation or approved by OSI, you must first obtain a commercial
 * license to this software product from Volker Bergmann.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * WITHOUT A WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS,
 * REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE
 * HEREBY EXCLUDED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

package org.databene.benerator.composite;

import java.util.List;

import org.databene.benerator.engine.AbstractScopedLifeCycleHolder;
import org.databene.benerator.engine.BeneratorContext;
import org.databene.benerator.util.RandomUtil;
import org.databene.commons.ArrayFormat;
import org.databene.commons.CollectionUtil;

/**
 * Abstract parent class for all builders that relate to a group of components.


 * Created at 09.05.2008 13:38:33
 * @since 0.5.4
 * @author Volker Bergmann
 */
public abstract class MultiComponentBuilder extends AbstractScopedLifeCycleHolder implements ComponentBuilder {
	
	protected ComponentBuilder[] builders;
	private List> availableBuilders;
	protected String message;

	public MultiComponentBuilder(ComponentBuilder[] builders, String scope) {
		super(scope);
		this.builders = builders;
		this.availableBuilders = CollectionUtil.toList(builders);
	}
	
	@Override
	public String getMessage() {
		return message;
	}
	
	// Generator interface ---------------------------------------------------------------------------------------------

	@Override
	public void init(BeneratorContext context) {
		for (ComponentBuilder builder : builders)
			builder.init(context);
	}

	@Override
	public void reset() {
		for (ComponentBuilder builder : builders)
			builder.reset();
		this.availableBuilders = CollectionUtil.toList(builders);
	}

	@Override
	public void close() {
		for (ComponentBuilder builder : builders)
			builder.close();
		this.availableBuilders.clear();
	}
	
	public boolean buildRandomComponent(BeneratorContext context) {
		message = null;
		if (availableBuilders.size() == 0) {
			message = "No component available: " + this;
			return false;
		}
		boolean success;
		do {
			int builderIndex = RandomUtil.randomIndex(availableBuilders);
			success = availableBuilders.get(builderIndex).execute(context);
			if (!success)
				availableBuilders.remove(builderIndex);
		} while (!success && availableBuilders.size() > 0);
		if (!success)
			message = "No component available: " + this;
	    return success;
	}
	
	// java.lang.Object overrides --------------------------------------------------------------------------------------
	
	@Override
	public String toString() {
		return getClass().getSimpleName() + ArrayFormat.format(builders);
	}
	
}