org.aspectj.bridge.ISourceLocation Maven / Gradle / Ivy

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

The AspectJ weaver applies aspects to Java classes. It can be used as a Java agent in order to apply load-time weaving (LTW) during class-loading and also contains the AspectJ runtime classes.

There is a newer version: 1.9.22.1

Show newest version

/* *******************************************************************
 * Copyright (c) 1999-2001 Xerox Corporation,
 *               2002 Palo Alto Research Center, Incorporated (PARC).
 * All rights reserved.
 * This program and the accompanying materials are made available
 * under the terms of the Eclipse Public License v 2.0
 * which accompanies this distribution and is available at
 * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
 *
 * Contributors:
 *     Xerox/PARC     initial implementation
 * ******************************************************************/

package org.aspectj.bridge;

import java.io.File;

/**
 * Represent source location as a starting line/column and ending line in a source file. Implementations should be immutable. XXX
 * why?
 *
 * @see org.aspectj.lang.reflect.SourceLocation
 */
public interface ISourceLocation extends java.io.Serializable {
	int MAX_LINE = Integer.MAX_VALUE / 2;
	int MAX_COLUMN = MAX_LINE;

	/** non-null but empty (nonexisting) File constant */
	File NO_FILE = new File("ISourceLocation.NO_FILE");

	/** signal that column is not known */
	int NO_COLUMN = Integer.MIN_VALUE + 1;

	/** non-null but empty constant source location */
	ISourceLocation EMPTY = new SourceLocation(NO_FILE, 0, 0, 0);

	/**
	 * @return File source or NO_FILE if the implementation requires a non-null result or null otherwise
	 */
	File getSourceFile();

	/** @return 0..MAX_LINE */
	int getLine();

	/**
	 * @return int 0..MAX_COLUMN actual column or 0 if column input was ISourceLocation.NO_COLUMN
	 */
	int getColumn();

	/**
	 * @return offset into file
	 */
	int getOffset();

	/** @return getLine()..MAX_LINE */
	int getEndLine();

	/** @return String application-specific context for source */
	String getContext();

	/**
	 * In the cases where getSourceFile().getName() returns a class file (for example when we have a binary aspect) this should
	 * return the name of the source file (for example BinaryAspect.aj)
	 *
	 * @return the name of the source file
	 */
	String getSourceFileName();

}