Nested and Inner Type Summary

Modifier and Type	Class and Description
private static enum	Arguments.ErrorMode
private static interface	Arguments.ErrorReporter

Field Summary

Modifier and Type	Field and Description
private final OptionHelper	apiHelper
public static final Context.Key<Arguments>	argsKey The context key for the arguments.
private Set<String>	classNames
private final OptionHelper	cmdLineHelper
private final Context	context
private Map<Option, String>	deferredFileManagerOptions
private boolean	emptyAllowed
private Arguments.ErrorMode	errorMode
private boolean	errors
private JavaFileManager	fileManager
private Set<JavaFileObject>	fileObjects
private Set<Path>	files
private final Log	log
private final Options	options
private String	ownName

Access	Constructor and Description
protected	Arguments(Context context)

Method Summary

Modifier and Type	Method and Description
public void	allowEmpty()
private boolean	checkDirectory(Option option)
pack-priv void	checkOptionAllowed(boolean allowed, Arguments.ErrorReporter r, Option... opts)
private boolean	doProcessArgs(Iterable<String> args, Set<Option> allowableOpts, OptionHelper helper, boolean allowOperands, boolean checkFileManager)
pack-priv void	error(Option.InvalidValueException f)
public Set<String>	Returns: the classes to be subject to annotation processing getClassNames() Gets the classes to be subject to annotation processing.
public Map<Option, String>	Returns: the deferred file manager options getDeferredFileManagerOptions() Gets the file manager options which may have been deferred during processArgs.
public List<String>	Returns: options for doclint getDocLintOpts() Gets any options specifying how doclint should be run.
private JavaFileManager	getFileManager()
public Set<JavaFileObject>	Returns: the files to be compiled getFileObjects() Gets the files to be compiled.
public Set<List<String>>	Returns: options for plugins getPluginOpts() Gets any options specifying plugins to be run.
public boolean	Returns: true if successful, false otherwise handleReleaseOptions(Predicate<Iterable<String>> a predicate to handle additional options implied by the `--release` option. The predicate should return true if all the additional options were processed successfully. additionalOptions) Handles the `--release` option.
public void	init(String the name of this tool; used to prefix messages ownName, Iterable<String> the args to be processed args) Initializes this Args instance with a set of command line args.
public void	init(String the name of this tool; used to prefix messages ownName, Iterable<String> the options to be processed options, Iterable<String> the classes to be subject to annotation processing classNames, Iterable<? extends JavaFileObject> the files to be compiled files) Initializes this Args instance with the parameters for a JavacTask.
public void	init(String the name of this tool; used to prefix messages ownName) Minimal initialization for tools, like javadoc, to be able to process javac options for themselves, and then call validate.
public static Arguments	Returns: the Arguments instance for this context. instance(Context the content context) Gets the Arguments instance for this context.
public boolean	Returns: true if there are no files or classes specified for use isEmpty() Returns true if there are no files or classes specified for use.
private boolean	Returns: true if all the strings were successfully processed; false otherwise processArgs(Iterable<String> the strings to be processed args, Set<Option> the set of option declarations that are applicable allowableOpts, OptionHelper a help for use by Option.process helper, boolean whether or not to check for files and classes allowOperands, boolean whether or not to check if the file manager can handle options which are not recognized by any of allowableOpts checkFileManager) Processes strings containing options and operands.
private JCDiagnostic.Fragment	releaseNote(Source source, String targetString)
private void	report(JCDiagnostic.DiagnosticInfo diag)
pack-priv void	reportDiag(JCDiagnostic.DiagnosticInfo diag)
pack-priv <T> ListBuffer<T>	toList(Iterable<? extends T> items)
pack-priv <T> Set<T>	toSet(Iterable<? extends T> items)
public boolean	Returns: true if all args are successfully validated; false otherwise. validate() Validates the overall consistency of the options and operands processed by processOptions.
private void	validateAddExports(SourceVersion sv)
private void	validateAddModules(SourceVersion sv)
private void	validateAddReads(SourceVersion sv)
private void	validateDefaultModuleForCreatedFiles(SourceVersion sv)
private void	validateLimitModules(SourceVersion sv)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

apiHelper	back to summary
private final OptionHelper apiHelper

argsKey	back to summary
public static final Context.Key<Arguments> argsKey The context key for the arguments.

classNames	back to summary
private Set<String> classNames

cmdLineHelper	back to summary
private final OptionHelper cmdLineHelper

context	back to summary
private final Context context

deferredFileManagerOptions	back to summary
private Map<Option, String> deferredFileManagerOptions

emptyAllowed	back to summary
private boolean emptyAllowed

errorMode	back to summary
private Arguments.ErrorMode errorMode

errors	back to summary
private boolean errors

fileManager	back to summary
private JavaFileManager fileManager

fileObjects	back to summary
private Set<JavaFileObject> fileObjects

files	back to summary
private Set<Path> files

log	back to summary
private final Log log

options	back to summary
private final Options options

ownName	back to summary
private String ownName

Constructor Detail

Arguments	back to summary
protected Arguments(Context context) Annotations @SuppressWarnings:this-escape

Method Detail

allowEmpty	back to summary
public void allowEmpty()

checkDirectory	back to summary
private boolean checkDirectory(Option option)

checkOptionAllowed	back to summary
pack-priv void checkOptionAllowed(boolean allowed, Arguments.ErrorReporter r, Option... opts)

doProcessArgs	back to summary
private boolean doProcessArgs(Iterable<String> args, Set<Option> allowableOpts, OptionHelper helper, boolean allowOperands, boolean checkFileManager)

error	back to summary
pack-priv void error(Option.InvalidValueException f)

getClassNames	back to summary
public Set<String> getClassNames() Gets the classes to be subject to annotation processing. Returns:Set<String> the classes to be subject to annotation processing

getClassNames

back to summary

public Set<String> getClassNames()

Gets the classes to be subject to annotation processing.

Returns:Set<String>: the classes to be subject to annotation processing

getDeferredFileManagerOptions	back to summary
public Map<Option, String> getDeferredFileManagerOptions() Gets the file manager options which may have been deferred during processArgs. Returns:Map<Option, String> the deferred file manager options

getDeferredFileManagerOptions

back to summary

public Map<Option, String> getDeferredFileManagerOptions()

Gets the file manager options which may have been deferred during processArgs.

Returns:Map<Option, String>: the deferred file manager options

getDocLintOpts	back to summary
public List<String> getDocLintOpts() Gets any options specifying how doclint should be run. An empty list is returned if no doclint options are specified or if the only doclint option is -Xdoclint:none. Returns:List<String> options for doclint

getDocLintOpts

back to summary

public List<String> getDocLintOpts()

Gets any options specifying how doclint should be run. An empty list is returned if no doclint options are specified or if the only doclint option is -Xdoclint:none.

Returns:List<String>: options for doclint

getFileManager	back to summary
private JavaFileManager getFileManager()

getFileObjects	back to summary
public Set<JavaFileObject> getFileObjects() Gets the files to be compiled. Returns:Set<JavaFileObject> the files to be compiled

getFileObjects

back to summary

public Set<JavaFileObject> getFileObjects()

Gets the files to be compiled.

Returns:Set<JavaFileObject>: the files to be compiled

getPluginOpts	back to summary
public Set<List<String>> getPluginOpts() Gets any options specifying plugins to be run. Returns:Set<List<String>> options for plugins

getPluginOpts

back to summary

public Set<List<String>> getPluginOpts()

Gets any options specifying plugins to be run.

Returns:Set<List<String>>: options for plugins

handleReleaseOptions back to summary

handleReleaseOptions	back to summary
public boolean handleReleaseOptions(Predicate<Iterable<String>> additionalOptions) Handles the `--release` option. Parameters additionalOptions:Predicate<Iterable<String>> a predicate to handle additional options implied by the `--release` option. The predicate should return true if all the additional options were processed successfully. Returns:boolean true if successful, false otherwise

public boolean handleReleaseOptions(Predicate<Iterable<String>> additionalOptions)

Handles the --release option.

Parameters

additionalOptions:Predicate<Iterable<String>>: a predicate to handle additional options implied by the --release option. The predicate should return true if all the additional options were processed successfully.

Returns:boolean

true if successful, false otherwise

init	back to summary
public void init(String ownName, Iterable<String> args) Initializes this Args instance with a set of command line args. The args will be processed in conjunction with the full set of command line options, including -help, -version etc. The args may also contain class names and filenames. Any errors during this call, and later during validate, will be reported to the log. Parameters ownName:String the name of this tool; used to prefix messages args:Iterable<String> the args to be processed

init

back to summary

public void init(String ownName, Iterable<String> args)

Initializes this Args instance with a set of command line args. The args will be processed in conjunction with the full set of command line options, including -help, -version etc. The args may also contain class names and filenames. Any errors during this call, and later during validate, will be reported to the log.

Parameters

ownName:String: the name of this tool; used to prefix messages
args:Iterable<String>: the args to be processed

init	back to summary
public void init(String ownName, Iterable<String> options, Iterable<String> classNames, Iterable<? extends JavaFileObject> files) Initializes this Args instance with the parameters for a JavacTask. The options will be processed in conjunction with the restricted set of tool options, which does not include -help, -version, etc, nor does it include classes and filenames, which should be specified separately. File manager options are handled directly by the file manager. Any errors found while processing individual args will be reported via IllegalArgumentException. Any subsequent errors during validate will be reported via IllegalStateException. Parameters ownName:String the name of this tool; used to prefix messages options:Iterable<String> the options to be processed classNames:Iterable<String> the classes to be subject to annotation processing files:Iterable<? extends JavaFileObject> the files to be compiled

init

back to summary

public void init(String ownName, Iterable<String> options, Iterable<String> classNames, Iterable<? extends JavaFileObject> files)

Initializes this Args instance with the parameters for a JavacTask. The options will be processed in conjunction with the restricted set of tool options, which does not include -help, -version, etc, nor does it include classes and filenames, which should be specified separately. File manager options are handled directly by the file manager. Any errors found while processing individual args will be reported via IllegalArgumentException. Any subsequent errors during validate will be reported via IllegalStateException.

Parameters

ownName:String: the name of this tool; used to prefix messages
options:Iterable<String>: the options to be processed
classNames:Iterable<String>: the classes to be subject to annotation processing
files:Iterable<? extends JavaFileObject>: the files to be compiled

init	back to summary
public void init(String ownName) Minimal initialization for tools, like javadoc, to be able to process javac options for themselves, and then call validate. Parameters ownName:String the name of this tool; used to prefix messages

init

back to summary

public void init(String ownName)

Minimal initialization for tools, like javadoc, to be able to process javac options for themselves, and then call validate.

Parameters

ownName:String: the name of this tool; used to prefix messages

instance	back to summary
public static Arguments instance(Context context) Gets the Arguments instance for this context. Parameters context:Context the content Returns:Arguments the Arguments instance for this context.

instance

back to summary

public static Arguments instance(Context context)

Gets the Arguments instance for this context.

Parameters

context:Context: the content

Returns:Arguments

the Arguments instance for this context.

isEmpty	back to summary
public boolean isEmpty() Returns true if there are no files or classes specified for use. Returns:boolean true if there are no files or classes specified for use

isEmpty

back to summary

public boolean isEmpty()

Returns true if there are no files or classes specified for use.

Returns:boolean: true if there are no files or classes specified for use

processArgs	back to summary
private boolean processArgs(Iterable<String> args, Set<Option> allowableOpts, OptionHelper helper, boolean allowOperands, boolean checkFileManager) Processes strings containing options and operands. Parameters args:Iterable<String> the strings to be processed allowableOpts:Set<Option> the set of option declarations that are applicable helper:OptionHelper a help for use by Option.process allowOperands:boolean whether or not to check for files and classes checkFileManager:boolean whether or not to check if the file manager can handle options which are not recognized by any of allowableOpts Returns:boolean true if all the strings were successfully processed; false otherwise Exceptions IllegalArgumentException: if a problem occurs and errorMode is set to ILLEGAL_ARGUMENT

processArgs

back to summary

private boolean processArgs(Iterable<String> args, Set<Option> allowableOpts, OptionHelper helper, boolean allowOperands, boolean checkFileManager)

Processes strings containing options and operands.

Parameters

args:Iterable<String>: the strings to be processed
allowableOpts:Set<Option>: the set of option declarations that are applicable
helper:OptionHelper: a help for use by Option.process
allowOperands:boolean: whether or not to check for files and classes
checkFileManager:boolean: whether or not to check if the file manager can handle options which are not recognized by any of allowableOpts

Returns:boolean

true if all the strings were successfully processed; false otherwise

Exceptions

IllegalArgumentException:: if a problem occurs and errorMode is set to ILLEGAL_ARGUMENT

releaseNote	back to summary
private JCDiagnostic.Fragment releaseNote(Source source, String targetString)

report	back to summary
private void report(JCDiagnostic.DiagnosticInfo diag)

reportDiag	back to summary
pack-priv void reportDiag(JCDiagnostic.DiagnosticInfo diag)

toList	back to summary
pack-priv <T> ListBuffer<T> toList(Iterable<? extends T> items)

toSet	back to summary
pack-priv <T> Set<T> toSet(Iterable<? extends T> items)

validate	back to summary
public boolean validate() Validates the overall consistency of the options and operands processed by processOptions. Returns:boolean true if all args are successfully validated; false otherwise. Exceptions IllegalStateException: if a problem is found and errorMode is set to ILLEGAL_STATE

validate

back to summary

public boolean validate()

Validates the overall consistency of the options and operands processed by processOptions.

Returns:boolean

true if all args are successfully validated; false otherwise.

Exceptions

IllegalStateException:: if a problem is found and errorMode is set to ILLEGAL_STATE

validateAddExports	back to summary
private void validateAddExports(SourceVersion sv)

validateAddModules	back to summary
private void validateAddModules(SourceVersion sv)

validateAddReads	back to summary
private void validateAddReads(SourceVersion sv)

validateDefaultModuleForCreatedFiles	back to summary
private void validateDefaultModuleForCreatedFiles(SourceVersion sv)

validateLimitModules	back to summary
private void validateLimitModules(SourceVersion sv)

com.sun.tools.javac.main back to summary

private final Enum Arguments.ErrorMode

Class Inheritance

extends Enum<Arguments.ErrorMode>

java.lang.Object
java.lang.Enum
com.sun.tools.javac.main.Arguments.ErrorMode

Field Summary

Modifier and Type	Field and Description
public static final Arguments.ErrorMode	ILLEGAL_ARGUMENT
public static final Arguments.ErrorMode	ILLEGAL_STATE
public static final Arguments.ErrorMode	LOG

Constructor Summary

Access	Constructor and Description
private	ErrorMode()

Method Summary

Modifier and Type	Method and Description
public static Arguments.ErrorMode	valueOf(String name)
public static Arguments.ErrorMode[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

ILLEGAL_ARGUMENT	back to summary
public static final Arguments.ErrorMode ILLEGAL_ARGUMENT

ILLEGAL_STATE	back to summary
public static final Arguments.ErrorMode ILLEGAL_STATE

LOG	back to summary
public static final Arguments.ErrorMode LOG

Constructor Detail

ErrorMode	back to summary
private ErrorMode()

Method Detail

valueOf	back to summary
public static Arguments.ErrorMode valueOf(String name)

values	back to summary
public static Arguments.ErrorMode[] values()

com.sun.tools.javac.main back to summary

private Interface Arguments.ErrorReporter

Method Summary

Modifier and Type	Method and Description
public void	report(Option o)

Method Detail

report	back to summary
public void report(Option o)

public Class Arguments

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Enum Arguments.ErrorMode

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface Arguments.ErrorReporter

Method Summary

Method Detail