plugins/org.eclipse.wst.validation/vf2/org/eclipse/wst/validation/ValidationEvent.java

/*******************************************************************************
 * Copyright (c) 2008 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.wst.validation;

import org.eclipse.core.resources.IResource;
import org.eclipse.core.resources.IResourceDelta;

/**
 * An object that describes which object should be validated and what triggered its validation.
 * <p>
 * <b>Provisional API:</b> This class/interface is part of an interim API that is still under development and expected to 
 * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 
 * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken 
 * (repeatedly) as the API evolves.
 * </p>
 * @author karasiuk
 *
 */

public final class ValidationEvent {
	
	private IResource 		_resource;
	private int				_kind;
	private IResourceDelta 	_dependsOn;
	
	/**
	 * Create an object that describes what should be validated.
	 * 
	 * @param resource
	 *            The resource to be validated.
	 * @param kind
	 *            The way the resource changed. It uses the same values as the
	 *            kind parameter in IResourceDelta.
	 * @param dependsOn
	 *            If the resource is being validated because one of it's
	 *            dependencies has changed, that change is described here. This
	 *            can be null.
	 */
	public ValidationEvent(IResource resource, int kind, IResourceDelta dependsOn){
		_resource = resource;
		_kind = kind;
		_dependsOn = dependsOn;
	}

	/**
	 * The resource to be validated.
	 */
	public IResource getResource() {
		return _resource;
	}

	/**
	 * The way the resource changed. It uses the same values as the kind
	 * parameter in IResourceDelta.
	 */
	public int getKind() {
		return _kind;
	}

	/**
	 * If the resource is being validated because one of it's dependencies has changed, that change is described here.
	 * This method will return null when the trigger is not because of a dependency change.
	 */
	public IResourceDelta getDependsOn() {
		return _dependsOn;
	}
}