eu.optique.api.mapping.impl.R2RMLMappingManagerImpl Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of r2rml-api Show documentation
There is a newer version: 0.4.0
/*******************************************************************************
 * Copyright 2013, the Optique Consortium
 * 
 * Licensed 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.
 * 
 * This first version of the R2RML API was developed jointly at the University of Oslo, 
 * the University of Bolzano, La Sapienza University of Rome, and fluid Operations AG, 
 * as part of the Optique project, www.optique-project.eu
 ******************************************************************************/
package eu.optique.api.mapping.impl;

import java.util.Collection;

import eu.optique.api.mapping.LibConfiguration;
import eu.optique.api.mapping.MappingFactory;
import eu.optique.api.mapping.R2RMLMappingCollection;
import eu.optique.api.mapping.R2RMLMappingManager;
import eu.optique.api.mapping.TriplesMap;

/**
 * Implementation of the {@link R2RMLMappingManager} interface.
 * 
 * @author michael.schmidt
 */
public class R2RMLMappingManagerImpl implements R2RMLMappingManager {

	private LibConfiguration lc;
	private MappingFactory mf;

	public R2RMLMappingManagerImpl(LibConfiguration lc) {
		this.lc = lc;
		mf = new MappingFactoryImpl(lc);
	}

	@Override
	public MappingFactory getMappingFactory() {
		return mf;
	}

	@Override
	public Collection importMappings(Object graph)
			throws IllegalArgumentException, InvalidR2RMLMappingException {

		// try once to extract the mapping from the graph and do some basic
		// validations
		// e.g. whether are any triplesmap at all, whether those have a
		// mandatory logical table as well as a subjectmap
		R2RMLMappingCollection mc = extractR2RMLMapping(graph);
		if (mc == null || mc.getTriplesMaps().isEmpty())
			throw new IllegalArgumentException(
					"Does not contain any (valid) TriplesMaps");
		for (TriplesMap map : mc.getTriplesMaps()) {
			if (map.getLogicalTable() == null)
				throw new IllegalArgumentException(
						"No logical table for TriplesMap "
								+ map.getResource(lc.getResourceClass())
										.toString());
			if (map.getLogicalTable().getResource(lc.getResourceClass()) == null
					&& map.getLogicalTable().getSQLQuery() == null)
				throw new IllegalArgumentException(
						"No logical table for TriplesMap "
								+ map.getResource(lc.getResourceClass())
										.toString());
			if (map.getSubjectMap() == null)
				throw new IllegalArgumentException(map.getResource(
						lc.getResourceClass()).toString()
						+ " does not have any SubjectMap");
		}

		return mc.getTriplesMaps();

	}

	@Override
	public  G exportMappings(Collection maps, Class graphClass)
			throws IllegalArgumentException {

		if (maps == null)
			throw new NullPointerException("The mapping collection is null.");

		if (maps.isEmpty())
			throw new IllegalArgumentException(
					"The mapping collection is empty");

		return graphClass.cast(lc.createGraph(maps));

	}

	/**
	 * Extracts the R2RML mapping from an RDF graph.
	 * 
	 * @param graph
	 *            the RDF graph defining the R2RML mapping
	 * @return the list of triples map objects defined in the graph
	 * @throws InvalidR2RMLMappingException
	 *             if invalid mapping found
	 */
	protected R2RMLMappingCollection extractR2RMLMapping(Object graph)
			throws InvalidR2RMLMappingException {
		return new R2RMLMappingCollectionImpl(this, lc, graph);
	}
}