org.ontoware.rdf2go.util.ConversionException Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of rdf2go.api Show documentation

RDF2go is an implementation-independent Java API with the design goals: portability (hence the name), performance and ease of implementation. This project was started at FZI Forschungszentrum Informatik Karlsruhe, Germany - www.fzi.de

The newest version!

/**
 * LICENSE INFORMATION
 * 
 * Copyright 2005-2008 by FZI (http://www.fzi.de). Licensed under a BSD license
 * (http://www.opensource.org/licenses/bsd-license.php)  = Max Völkel
 *  = FZI Forschungszentrum Informatik Karlsruhe, Karlsruhe,
 * Germany  = 2010
 * 
 * Further project information at http://semanticweb.org/wiki/RDF2Go
 */

package org.ontoware.rdf2go.util;

/**
 * Thrown when an rdf2go adapter cannot convert from one class to another. The
 * source object that cannot be conveted and the target class that was the goal
 * of the conversion are passed.
 * 
 * 
 * @author sauermann 
 */
public class ConversionException extends RuntimeException {
	
	/**
	 * 
	 */
	private static final long serialVersionUID = -1866748054068895807L;
	Object sourceObject;
	Class targetClass;
	
	/**
	 * default constructor
	 */
	public ConversionException() {
		// empty default constructor
	}
	
	/**
	 * constructor, with an injected message
	 * 
	 * @param message detailed error message
	 */
	public ConversionException(String message) {
		super(message);
	}
	
	/**
	 * @param cause nested error
	 */
	public ConversionException(Throwable cause) {
		super(cause);
	}
	
	/**
	 * @param message detailed error message
	 * @param cause nested error
	 */
	public ConversionException(String message, Throwable cause) {
		super(message, cause);
	}
	
	/**
	 * Generate a new conversion exception. The exception will start with a
	 * string automatically generated from using the toString of the source
	 * object and the targetclass. You can give a message or leave it empty.
	 * 
	 * @param message detailed error message
	 * @param sourceObject of the conversion
	 * @param targetClass of the conversion
	 */
	public ConversionException(String message, Object sourceObject, Class targetClass) {
		super(generateMessage(message, sourceObject, targetClass));
		this.sourceObject = sourceObject;
		this.targetClass = targetClass;
	}
	
	/**
	 * generate the error message
	 */
	protected static String generateMessage(String message, Object sourceObject2,
	        Class targetClass2) {
		
		return "Could not convert '" + sourceObject2 + "' "
		        + ((sourceObject2 == null) ? "" : "of class " + sourceObject2.getClass().getName())
		        + " to target class " + targetClass2 + ((message != null) ? ": " + message : "");
	}
	
	/**
	 * 
	 * @return the source object that could not be converted.
	 */
	public Object getSourceObject() {
		return this.sourceObject;
	}
	
	/**
	 * 
	 * @return the target class that should be converted to
	 */
	public Class getTargetClass() {
		return this.targetClass;
	}
	
}