org.openrdf.repository.object.managers.helpers.HierarchicalRoleMapper Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of alibaba-composition-object Show documentation
The Object Composition library merges multiple Java objects into a single multi-subject object.
There is a newer version: 2.4
Show newest version
/*
 * Copyright (c) 2007-2009, James Leigh All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 
 * - Redistributions of source code must retain the above copyright notice, this
 *   list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution. 
 * - Neither the name of the openrdf.org nor the names of its contributors may
 *   be used to endorse or promote products derived from this software without
 *   specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. 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.openrdf.repository.object.managers.helpers;

import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;

import org.openrdf.model.URI;
import org.openrdf.model.ValueFactory;
import org.openrdf.repository.object.exceptions.ObjectCompositionException;

/**
 * Tracks recorded roles and maps them to their subject type.
 * 
 * @author James Leigh
 * 
 */
public class HierarchicalRoleMapper implements Cloneable {

	private DirectMapper directMapper = new DirectMapper();
	private TypeMapper typeMapper = new TypeMapper();
	private SimpleRoleMapper simpleRoleMapper = new SimpleRoleMapper();
	private Map, Set>> subclasses = new HashMap, Set>>(256);

	public HierarchicalRoleMapper clone() {
		try {
			HierarchicalRoleMapper cloned = (HierarchicalRoleMapper) super.clone();
			cloned.directMapper = directMapper.clone();
			cloned.typeMapper = typeMapper.clone();
			cloned.simpleRoleMapper = simpleRoleMapper.clone();
			cloned.subclasses = clone(subclasses);
			return cloned;
		} catch (CloneNotSupportedException e) {
			throw new AssertionError(e);
		}
	}

	private  Map> clone(Map> map) {
		Map> cloned = new HashMap>(map);
		for (Map.Entry> e : cloned.entrySet()) {
			e.setValue(new HashSet(e.getValue()));
		}
		return cloned;
	}

	public void setURIFactory(ValueFactory vf) {
		simpleRoleMapper.setURIFactory(vf);
	}

	public Collection> findAllRoles() {
		return simpleRoleMapper.findAllRoles();
	}

	public Collection> findRoles(URI type) {
		return simpleRoleMapper.findRoles(type);
	}

	public Collection> findRoles(Collection types,
			Collection> classes) {
		return simpleRoleMapper.findRoles(types, classes);
	}

	public boolean isNamedTypePresent() {
		return simpleRoleMapper.isNamedTypePresent();
	}

	public boolean isTypeRecorded(URI type) {
		return simpleRoleMapper.isTypeRecorded(type);
	}

	/**
	 * Finds the rdf:Class for this Java Class.
	 * 
	 * @param role
	 * @return URI of the rdf:Class for this Java Class or null.
	 */
	public URI findType(Class role) {
		return typeMapper.findType(role);
	}

	public Collection findSubTypes(Class role, Collection rdfTypes) {
		URI type = findType(role);
		if (type == null)
			throw new ObjectCompositionException("Concept not registered: "
					+ role.getSimpleName());
		rdfTypes.add(type);
		Set> subset = subclasses.get(role);
		if (subset == null)
			return rdfTypes;
		for (Class c : subset) {
			findSubTypes(c, rdfTypes);
		}
		return rdfTypes;
	}

	public synchronized void recordConcept(Class role, URI type, boolean equiv, boolean primary) {
		assert type != null;
		recordClassHierarchy(role);
		if (primary) {
			typeMapper.recordRole(role, type);
		}
		if (equiv) {
			directMapper.recordRole(role, type);
		}
		if (simpleRoleMapper.getBaseType().equals(type)) {
			simpleRoleMapper.recordBaseRole(role);
		} else {
			Set> superRoles = getSuperRoles(role);
			Set> newRoles = new HashSet>(
					superRoles.size() + 1);
			newRoles.addAll(superRoles);
			newRoles.add(role);
			recordSubclasses(type, newRoles);
		}
	}

	public synchronized void recordBehaviour(Class role, URI type, boolean equiv) {
		assert type != null;
		if (equiv) {
			directMapper.recordRole(role, type);
		}
		if (simpleRoleMapper.getBaseType().equals(type)) {
			recordClassHierarchy(role);
			simpleRoleMapper.recordBaseRole(role);
		} else {
			Set> newRoles = new HashSet>();
			newRoles.add(role);
			recordSubclasses(type, newRoles);
		}
	}

	/**
	 * Record the class hierarchy of the concept to looks subclasses of related
	 * subject types.
	 * 
	 * @param concept
	 */
	private void recordClassHierarchy(Class concept) {
		for (Class sup : concept.getInterfaces()) {
			Set> set = subclasses.get(sup);
			if (set == null)
				subclasses.put(sup, set = new HashSet>());
			if (!set.contains(concept)) {
				set.add(concept);
				recordClassHierarchy(sup);
			}
		}
		Class sup = concept.getSuperclass();
		if (sup != null) {
			Set> set = subclasses.get(sup);
			if (set == null)
				subclasses.put(sup, set = new HashSet>());
			if (!set.contains(concept)) {
				set.add(concept);
				recordClassHierarchy(sup);
			}
		}
	}

	private Set> getSuperRoles(Class role) {
		Set> superRoles = new HashSet>();
		for (Class sup : role.getInterfaces()) {
			Set> sr = getSuperRoles(sup);
			addRelatedRoles(sr, sup, superRoles);
		}
		Class sup = role.getSuperclass();
		if (sup != null) {
			Set> sr = getSuperRoles(sup);
			addRelatedRoles(sr, sup, superRoles);
		}
		return superRoles;
	}

	private void recordSubclasses(URI type, Set> newRoles) {
		newRoles = simpleRoleMapper.recordRoles(newRoles, type);
		Set> directRoles = directMapper.getDirectRoles(type);
		if (directRoles != null) {
			for (Class r : directRoles) {
				addRolesInSubclasses(r, newRoles);
			}
		}
	}

	private void addRolesInSubclasses(Class role, Set> newRoles) {
		Set> subset = subclasses.get(role);
		if (subset == null)
			return; // no subclasses
		for (Class sub : subset) {
			Set> subRoles = new HashSet>();
			subRoles = addRelatedRoles(newRoles, sub, subRoles);
			addRolesInSubclasses(sub, subRoles);
		}
	}

	private Set> addRelatedRoles(Set> existing,
			Class role, Set> roles) {
		roles.addAll(existing);
		Set set = directMapper.getDirectTypes(role);
		if (set != null) {
			for (URI uri : set) {
				simpleRoleMapper.recordRoles(existing, uri);
				for (Class c : simpleRoleMapper.findRoles(uri)) {
					roles.add(c);
				}
			}
		}
		return roles;
	}
}