Package com.sun.tools.javac.util

Class AbstractLog

java.lang.Object

com.sun.tools.javac.util.AbstractLog

Direct Known Subclasses:

Log

public abstract class AbstractLog
extends Object

A base class for error logs. Reports errors and warnings, and keeps track of error numbers and positions.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Field Summary

Fields

Modifier and Type	Field and Description
protected JCDiagnostic.Factory	diags Factory for diagnostics
protected DiagnosticSource	source The file that's currently being translated.
protected Map<JavaFileObject,DiagnosticSource>	sourceMap A cache of lightweight DiagnosticSource objects.

Method Summary

Modifier and Type	Method and Description
DiagnosticSource	currentSource() Return the underlying diagnostic source
protected abstract void	directError(String key, Object... args)
void	error(int pos, String key, Object... args) Report an error, unless another error was already reported at same source position.
void	error(JCDiagnostic.DiagnosticFlag flag, int pos, String key, Object... args) Report an error, unless another error was already reported at same source position.
void	error(JCDiagnostic.DiagnosticFlag flag, JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report an error, unless another error was already reported at same source position.
void	error(JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report an error, unless another error was already reported at same source position.
void	error(String key, Object... args) Report an error, unless another error was already reported at same source position.
protected DiagnosticSource	getSource(JavaFileObject file)
void	mandatoryNote(JavaFileObject file, String key, Object... args) Provide a non-fatal notification, unless suppressed by the -nowarn option.
void	mandatoryWarning(JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report a warning.
void	mandatoryWarning(Lint.LintCategory lc, JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report a warning.
void	note(int pos, String key, Object... args) Provide a non-fatal notification, unless suppressed by the -nowarn option.
void	note(JavaFileObject file, String key, Object... args) Provide a non-fatal notification, unless suppressed by the -nowarn option.
void	note(JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Provide a non-fatal notification, unless suppressed by the -nowarn option.
void	note(String key, Object... args) Provide a non-fatal notification, unless suppressed by the -nowarn option.
protected abstract void	report(JCDiagnostic diagnostic)
JavaFileObject	useSource(JavaFileObject file) Re-assign source, returning previous setting.
void	warning(int pos, String key, Object... args) Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.
void	warning(JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.
void	warning(Lint.LintCategory lc, JCDiagnostic.DiagnosticPosition pos, String key, Object... args) Report a lint warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.
void	warning(Lint.LintCategory lc, String key, Object... args) Report a lint warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.
void	warning(String key, Object... args) Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

diags

protected JCDiagnostic.Factory diags

Factory for diagnostics

source

protected DiagnosticSource source

The file that's currently being translated.

sourceMap

protected Map<JavaFileObject,DiagnosticSource> sourceMap

A cache of lightweight DiagnosticSource objects.

Method Detail

useSource

public JavaFileObject useSource(JavaFileObject file)

Re-assign source, returning previous setting.

getSource

protected DiagnosticSource getSource(JavaFileObject file)

currentSource

public DiagnosticSource currentSource()

Return the underlying diagnostic source

error

public void error(String key,
                  Object... args)

Report an error, unless another error was already reported at same source position.

Parameters:

key - The key for the localized error message.

args - Fields of the error message.

error

public void error(JCDiagnostic.DiagnosticPosition pos,
                  String key,
                  Object... args)

Report an error, unless another error was already reported at same source position.

Parameters:

pos - The source position at which to report the error.

key - The key for the localized error message.

args - Fields of the error message.

error

public void error(JCDiagnostic.DiagnosticFlag flag,
                  JCDiagnostic.DiagnosticPosition pos,
                  String key,
                  Object... args)

Report an error, unless another error was already reported at same source position.

Parameters:

flag - A flag to set on the diagnostic

pos - The source position at which to report the error.

key - The key for the localized error message.

args - Fields of the error message.

error

public void error(int pos,
                  String key,
                  Object... args)

Report an error, unless another error was already reported at same source position.

Parameters:

pos - The source position at which to report the error.

key - The key for the localized error message.

args - Fields of the error message.

error

public void error(JCDiagnostic.DiagnosticFlag flag,
                  int pos,
                  String key,
                  Object... args)

Report an error, unless another error was already reported at same source position.

Parameters:

flag - A flag to set on the diagnostic

pos - The source position at which to report the error.

key - The key for the localized error message.

args - Fields of the error message.

warning

public void warning(String key,
                    Object... args)

Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Parameters:

key - The key for the localized warning message.

args - Fields of the warning message.

warning

public void warning(Lint.LintCategory lc,
                    String key,
                    Object... args)

Report a lint warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Parameters:

lc - The lint category for the diagnostic

key - The key for the localized warning message.

args - Fields of the warning message.

warning

public void warning(JCDiagnostic.DiagnosticPosition pos,
                    String key,
                    Object... args)

Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Parameters:

pos - The source position at which to report the warning.

key - The key for the localized warning message.

args - Fields of the warning message.

warning

public void warning(Lint.LintCategory lc,
                    JCDiagnostic.DiagnosticPosition pos,
                    String key,
                    Object... args)

Report a lint warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Parameters:

lc - The lint category for the diagnostic

pos - The source position at which to report the warning.

key - The key for the localized warning message.

args - Fields of the warning message.

warning

public void warning(int pos,
                    String key,
                    Object... args)

Report a warning, unless suppressed by the -nowarn option or the maximum number of warnings has been reached.

Parameters:

pos - The source position at which to report the warning.

key - The key for the localized warning message.

args - Fields of the warning message.

mandatoryWarning

public void mandatoryWarning(JCDiagnostic.DiagnosticPosition pos,
                             String key,
                             Object... args)

Report a warning.

Parameters:

pos - The source position at which to report the warning.

key - The key for the localized warning message.

args - Fields of the warning message.

mandatoryWarning

public void mandatoryWarning(Lint.LintCategory lc,
                             JCDiagnostic.DiagnosticPosition pos,
                             String key,
                             Object... args)

Report a warning.

Parameters:

lc - The lint category for the diagnostic

pos - The source position at which to report the warning.

key - The key for the localized warning message.

args - Fields of the warning message.

note

public void note(String key,
                 Object... args)

Provide a non-fatal notification, unless suppressed by the -nowarn option.

Parameters:

key - The key for the localized notification message.

args - Fields of the notint an error or warning message:

note

public void note(JCDiagnostic.DiagnosticPosition pos,
                 String key,
                 Object... args)

Provide a non-fatal notification, unless suppressed by the -nowarn option.

Parameters:

key - The key for the localized notification message.

args - Fields of the notification message.

note

public void note(int pos,
                 String key,
                 Object... args)

Provide a non-fatal notification, unless suppressed by the -nowarn option.

Parameters:

key - The key for the localized notification message.

args - Fields of the notification message.

note

public void note(JavaFileObject file,
                 String key,
                 Object... args)

Provide a non-fatal notification, unless suppressed by the -nowarn option.

Parameters:

key - The key for the localized notification message.

args - Fields of the notification message.

mandatoryNote

public void mandatoryNote(JavaFileObject file,
                          String key,
                          Object... args)

Provide a non-fatal notification, unless suppressed by the -nowarn option.

Parameters:

key - The key for the localized notification message.

args - Fields of the notification message.

report

protected abstract void report(JCDiagnostic diagnostic)

directError

protected abstract void directError(String key,
                                    Object... args)