15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package com.sun.mirror.util;
27
28
29 import java.io.File;
30
31
32 /**
33 * Represents a position in a source file.
34 *
35 * @author Joseph D. Darcy
36 * @author Scott Seligman
37 * @since 1.5
38 */
39
40 public interface SourcePosition {
41
42 /**
43 * Returns the source file containing this position.
44 *
45 * @return the source file containing this position; never null
46 */
47 File file();
48
49 /**
50 * Returns the line number of this position. Lines are numbered
51 * starting with 1.
52 *
53 * @return the line number of this position, or 0 if the line
54 * number is unknown or not applicable
55 */
56 int line();
57
58 /**
59 * Returns the column number of this position. Columns are numbered
|
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package com.sun.mirror.util;
27
28
29 import java.io.File;
30
31
32 /**
33 * Represents a position in a source file.
34 *
35 * @deprecated All components of this API have been superseded by the
36 * standardized annotation processing API. There is no direct
37 * replacement for the functionality of this interface since the
38 * standardized {@link javax.annotation.processing.Messager Messager}
39 * API implicitly takes a source position argument via any element,
40 * annotation mirror, or annotation value passed along with the
41 * message.
42 *
43 * @author Joseph D. Darcy
44 * @author Scott Seligman
45 * @since 1.5
46 */
47 @Deprecated
48 @SuppressWarnings("deprecation")
49 public interface SourcePosition {
50
51 /**
52 * Returns the source file containing this position.
53 *
54 * @return the source file containing this position; never null
55 */
56 File file();
57
58 /**
59 * Returns the line number of this position. Lines are numbered
60 * starting with 1.
61 *
62 * @return the line number of this position, or 0 if the line
63 * number is unknown or not applicable
64 */
65 int line();
66
67 /**
68 * Returns the column number of this position. Columns are numbered
|