org.eclipse.jface.text.IDocumentInformationMapping Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation

AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based @AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step. This library is a superset of AspectJ weaver and hence also of AspectJ runtime.

There is a newer version: 1.9.22.1

Show newest version

/*******************************************************************************
 * Copyright (c) 2000, 2005 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jface.text;


/**
 * A IDocumentInformationMapping  represents a mapping between the coordinates of two
 * IDocument objects: the original and the image. The document information mapping
 * can translate document information such as line numbers or character ranges given for the original into
 * the corresponding information of the image and vice versa.
 *
 * In order to provided backward compatibility for clients of IDocumentInformationMapping, extension
 * interfaces are used to provide a means of evolution. The following extension interfaces
 * exist:
 * 
 *  {@link org.eclipse.jface.text.IDocumentInformationMappingExtension} since version 3.0 extending the
 *      degree of detail of the mapping information.
 *  {@link org.eclipse.jface.text.IDocumentInformationMappingExtension2} since version 3.1, adding lenient
 *      image region computation.
 * 
 *
 * @since 2.1
 */
public interface IDocumentInformationMapping {

	/**
	 * Returns the minimal region of the original document that completely comprises all of the image document
	 * or null if there is no such region.
	 *
	 * @return the minimal region of the original document comprising the image document or null
	 */
	IRegion getCoverage();

	/**
	 * Returns the offset in the original document that corresponds to the given offset in the image document
	 * or -1 if there is no such offset
	 *
	 * @param imageOffset the offset in the image document
	 * @return the corresponding offset in the original document or -1
	 * @throws BadLocationException if imageOffset is not a valid offset in the image document
	 */
	int toOriginOffset(int imageOffset) throws BadLocationException;

	/**
	 * Returns the minimal region of the original document that completely comprises the given region of the
	 * image document or null if there is no such region.
	 *
	 * @param imageRegion the region of the image document
	 * @return the minimal region of the original document comprising the given region of the image document or null
	 * @throws BadLocationException if imageRegion is not a valid region of the image document
	 */
	IRegion toOriginRegion(IRegion imageRegion) throws BadLocationException;

	/**
	 * Returns the range of lines of the original document that corresponds to the given line of the image document or
	 * null if there are no such lines.
	 *
	 * @param imageLine the line of the image document
	 * @return the corresponding lines of the original document or null
	 * @throws BadLocationException if imageLine is not a valid line number in the image document
	 */
	IRegion toOriginLines(int imageLine) throws BadLocationException;

	/**
	 * Returns the line of the original document that corresponds to the given line of the image document or
	 * -1 if there is no such line.
	 *
	 * @param imageLine the line of the image document
	 * @return the corresponding line of the original document or -1
	 * @throws BadLocationException if imageLine is not a valid line number in the image document
	 */
	int toOriginLine(int imageLine) throws BadLocationException;



	/**
	 * Returns the offset in the image document that corresponds to the given offset in the original document
	 * or -1 if there is no such offset
	 *
	 * @param originOffset the offset in the original document
	 * @return the corresponding offset in the image document or -1
	 * @throws BadLocationException if originOffset is not a valid offset in the original document
	 */
	int toImageOffset(int originOffset) throws BadLocationException;

	/**
	 * Returns the minimal region of the image document that completely comprises the given region of the
	 * original document or null if there is no such region.
	 *
	 * @param originRegion the region of the original document
	 * @return the minimal region of the image document comprising the given region of the original document or null
	 * @throws BadLocationException if originRegion is not a valid region of the original document
	 */
	IRegion toImageRegion(IRegion originRegion) throws BadLocationException;

	/**
	 * Returns the line of the image document that corresponds to the given line of the original document or
	 * -1 if there is no such line.
	 *
	 * @param originLine the line of the original document
	 * @return the corresponding line of the image document or -1
	 * @throws BadLocationException if originLine is not a valid line number in the original document
	 */
	int toImageLine(int originLine) throws BadLocationException;

	/**
	 * Returns the line of the image document whose corresponding line in the original document
	 * is closest to the given line in the original document.
	 *
	 * @param originLine the line in the original document
	 * @return the line in the image document that corresponds best to the given line in the original document
	 * @throws BadLocationException if originLineis not a valid line in the original document
	 */
	int toClosestImageLine(int originLine) throws BadLocationException;
}