BatchEnvironment (RMIC compiler 4.0.2-b010 API)

java.lang.Object
- sun.tools.java.Environment
- - sun.tools.javac.BatchEnvironment

All Implemented Interfaces:

Constants, RuntimeConstants, ErrorConsumer

Direct Known Subclasses:

BatchEnvironment

Deprecated.
```
@Deprecated
public class BatchEnvironment
extends Environment
implements ErrorConsumer
```
Main environment of the batch version of the Java compiler, this needs more work. WARNING: The contents of this source file are not part of any supported API. Code that depends on them does so at its own risk: they are subject to change or removal without notice.

Field Summary

Fields
Modifier and Type	Field and Description
`protected ClassPath`	`binaryPath` Deprecated. The path we use for finding class (binary) files.
`File`	`covFile` Deprecated. coverage data file
`int`	`errorLimit` Deprecated. Maximum number of errors to print.
`int`	`flags` Deprecated. flags
`short`	`majorVersion` Deprecated. Major and minor versions to use for generated class files.
`short`	`minorVersion` Deprecated.
`int`	`ndeprecations` Deprecated.
`int`	`nerrors` Deprecated. The number of errors and warnings
`int`	`nwarnings` Deprecated.
`protected ClassPath`	`sourcePath` Deprecated. The path we use for finding source files.

Fields inherited from interface sun.tools.java.Constants
ABSTRACT, ACCM_CLASS, ACCM_FIELD, ACCM_INNERCLASS, ACCM_MEMBER, ACCM_METHOD, ADD, AND, ARRAY, ARRAYACCESS, ASGADD, ASGBITAND, ASGBITOR, ASGBITXOR, ASGDIV, ASGLSHIFT, ASGMUL, ASGREM, ASGRSHIFT, ASGSUB, ASGURSHIFT, ASSIGN, ATT_ALL, ATT_ALLCLASSES, ATT_CODE, BITAND, BITNOT, BITOR, BITXOR, BOOLEAN, BOOLEANVAL, BREAK, BYTE, BYTEVAL, CASE, CAST, CATCH, CHAR, CHARVAL, CLASS, COLON, COMMA, COMMENT, COND, CONST, CONTINUE, CONVERT, CS_BINARY, CS_CHECKED, CS_COMPILED, CS_NOTFOUND, CS_PARSED, CS_SOURCE, CS_UNDECIDED, CS_UNDEFINED, CT_BLOCK, CT_BRANCH_FALSE, CT_BRANCH_TRUE, CT_CASE, CT_FIKT_METHOD, CT_FIKT_RET, CT_FIRST_KIND, CT_LAST_KIND, CT_METHOD, CT_SWITH_WO_DEF, DEC, DECLARATION, DEFAULT, DIV, DO, DOUBLE, DOUBLEVAL, ELSE, EQ, ERROR, EXPR, EXPRESSION, EXTENDS, F_COVDATA, F_COVERAGE, F_DEBUG_LINES, F_DEBUG_SOURCE, F_DEBUG_VARS, F_DEPENDENCIES, F_DEPRECATION, F_DUMP, F_ERRORSREPORTED, F_OPT, F_OPT_INTERCLASS, F_PRINT_DEPENDENCIES, F_STRICTDEFAULT, F_VERBOSE, F_VERSION12, F_WARNINGS, FALSE, FIELD, FINAL, FINALLY, FLOAT, FLOATVAL, FOR, GE, GOTO, GT, idAppend, idClass, idClassInit, idClone, idCode, idConstantValue, idCoverageTable, idDeprecated, idDocumentation, IDENT, idExceptions, idFinallyReturnValue, idGetClass, idInit, idInnerClasses, idJavaIoSerializable, idJavaLang, idJavaLangClass, idJavaLangCloneable, idJavaLangError, idJavaLangException, idJavaLangObject, idJavaLangRuntimeException, idJavaLangString, idJavaLangStringBuffer, idJavaLangThrowable, idLength, idLineNumberTable, idLocalVariableTable, idNew, idNull, idSourceFile, idStar, idSuper, idSynthetic, idThis, idToString, idTYPE, idValueOf, IF, IMPLEMENTS, IMPORT, INC, INLINEMETHOD, INLINENEWINSTANCE, INLINERETURN, INSTANCEOF, INT, INTERFACE, INTVAL, LBRACE, LE, LENGTH, LONG, LONGVAL, LPAREN, LSHIFT, LSQBRACKET, LT, M_ABSTRACT, M_ANONYMOUS, M_DEPRECATED, M_FINAL, M_INLINEABLE, M_INTERFACE, M_LOCAL, M_NATIVE, M_PRIVATE, M_PROTECTED, M_PUBLIC, M_STATIC, M_STRICTFP, M_SYNCHRONIZED, M_SYNTHETIC, M_TRANSIENT, M_VOLATILE, MAXFILESIZE, MAXLINENUMBER, METHOD, MM_CLASS, MM_FIELD, MM_MEMBER, MM_METHOD, MUL, NATIVE, NE, NEG, NEW, NEWARRAY, NEWFROMNAME, NEWINSTANCE, NOT, NULL, opNames, opPrecedence, OR, PACKAGE, paraDeprecated, POS, POSTDEC, POSTINC, PREDEC, prefixAccess, prefixArray, prefixClass, prefixLoc, prefixThis, prefixVal, PREINC, PRIVATE, PROTECTED, PUBLIC, QUESTIONMARK, RBRACE, REM, RETURN, RPAREN, RSHIFT, RSQBRACKET, SEMICOLON, SHORT, SHORTVAL, SIG_INNERCLASS, SIGC_INNERCLASS, STAT, STATIC, STRICTFP, STRINGVAL, SUB, SUPER, SWITCH, SYNCHRONIZED, TC_ARRAY, TC_BOOLEAN, TC_BYTE, TC_CHAR, TC_CLASS, TC_DOUBLE, TC_ERROR, TC_FLOAT, TC_INT, TC_LONG, TC_METHOD, TC_NULL, TC_SHORT, TC_VOID, THIS, THROW, THROWS, TM_ARRAY, TM_BOOLEAN, TM_BYTE, TM_CHAR, TM_CLASS, TM_DOUBLE, TM_ERROR, TM_FLOAT, TM_INT, TM_INT32, TM_INTEGER, TM_LONG, TM_METHOD, TM_NULL, TM_NUM32, TM_NUM64, TM_NUMBER, TM_REAL, TM_REFERENCE, TM_SHORT, TM_VOID, tracing, TRANSIENT, TRUE, TRY, TYPE, URSHIFT, VARDECLARATION, VOID, VOLATILE, WHEREOFFSETBITS, WHILE

Fields inherited from interface sun.tools.java.RuntimeConstants
ACC_ABSTRACT, ACC_FINAL, ACC_INTERFACE, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_TRANSIENT, ACC_VOLATILE, CONSTANT_CLASS, CONSTANT_DOUBLE, CONSTANT_FIELD, CONSTANT_FLOAT, CONSTANT_INTEGER, CONSTANT_INTERFACEMETHOD, CONSTANT_INVOKEDYNAMIC, CONSTANT_LONG, CONSTANT_METHOD, CONSTANT_METHODHANDLE, CONSTANT_METHODTYPE, CONSTANT_NAMEANDTYPE, CONSTANT_STRING, CONSTANT_UNICODE, CONSTANT_UTF8, JAVA_DEFAULT_MINOR_VERSION, JAVA_DEFAULT_VERSION, JAVA_MAGIC, JAVA_MAX_SUPPORTED_MINOR_VERSION, JAVA_MAX_SUPPORTED_VERSION, JAVA_MIN_SUPPORTED_VERSION, opc_aaload, opc_aastore, opc_aconst_null, opc_aload, opc_aload_0, opc_aload_1, opc_aload_2, opc_aload_3, opc_anewarray, opc_areturn, opc_arraylength, opc_astore, opc_astore_0, opc_astore_1, opc_astore_2, opc_astore_3, opc_athrow, opc_baload, opc_bastore, opc_bipush, opc_breakpoint, opc_caload, opc_castore, opc_checkcast, opc_d2f, opc_d2i, opc_d2l, opc_dadd, opc_daload, opc_dastore, opc_dcmpg, opc_dcmpl, opc_dconst_0, opc_dconst_1, opc_ddiv, opc_dead, opc_dload, opc_dload_0, opc_dload_1, opc_dload_2, opc_dload_3, opc_dmul, opc_dneg, opc_drem, opc_dreturn, opc_dstore, opc_dstore_0, opc_dstore_1, opc_dstore_2, opc_dstore_3, opc_dsub, opc_dup, opc_dup_x1, opc_dup_x2, opc_dup2, opc_dup2_x1, opc_dup2_x2, opc_f2d, opc_f2i, opc_f2l, opc_fadd, opc_faload, opc_fastore, opc_fcmpg, opc_fcmpl, opc_fconst_0, opc_fconst_1, opc_fconst_2, opc_fdiv, opc_fload, opc_fload_0, opc_fload_1, opc_fload_2, opc_fload_3, opc_fmul, opc_fneg, opc_frem, opc_freturn, opc_fstore, opc_fstore_0, opc_fstore_1, opc_fstore_2, opc_fstore_3, opc_fsub, opc_getfield, opc_getstatic, opc_goto, opc_goto_w, opc_i2b, opc_i2c, opc_i2d, opc_i2f, opc_i2l, opc_i2s, opc_iadd, opc_iaload, opc_iand, opc_iastore, opc_iconst_0, opc_iconst_1, opc_iconst_2, opc_iconst_3, opc_iconst_4, opc_iconst_5, opc_iconst_m1, opc_idiv, opc_if_acmpeq, opc_if_acmpne, opc_if_icmpeq, opc_if_icmpge, opc_if_icmpgt, opc_if_icmple, opc_if_icmplt, opc_if_icmpne, opc_ifeq, opc_ifge, opc_ifgt, opc_ifle, opc_iflt, opc_ifne, opc_ifnonnull, opc_ifnull, opc_iinc, opc_iload, opc_iload_0, opc_iload_1, opc_iload_2, opc_iload_3, opc_imul, opc_ineg, opc_instanceof, opc_invokedynamic, opc_invokeinterface, opc_invokespecial, opc_invokestatic, opc_invokevirtual, opc_ior, opc_irem, opc_ireturn, opc_ishl, opc_ishr, opc_istore, opc_istore_0, opc_istore_1, opc_istore_2, opc_istore_3, opc_isub, opc_iushr, opc_ixor, opc_jsr, opc_jsr_w, opc_l2d, opc_l2f, opc_l2i, opc_label, opc_ladd, opc_laload, opc_land, opc_lastore, opc_lcmp, opc_lconst_0, opc_lconst_1, opc_ldc, opc_ldc_w, opc_ldc2_w, opc_ldiv, opc_lload, opc_lload_0, opc_lload_1, opc_lload_2, opc_lload_3, opc_lmul, opc_lneg, opc_lookupswitch, opc_lor, opc_lrem, opc_lreturn, opc_lshl, opc_lshr, opc_lstore, opc_lstore_0, opc_lstore_1, opc_lstore_2, opc_lstore_3, opc_lsub, opc_lushr, opc_lxor, opc_monitorenter, opc_monitorexit, opc_multianewarray, opc_new, opc_newarray, opc_nop, opc_pop, opc_pop2, opc_putfield, opc_putstatic, opc_ret, opc_return, opc_saload, opc_sastore, opc_sipush, opc_swap, opc_tableswitch, opc_try, opc_wide, opcLengths, opcNames, SIG_ARRAY, SIG_BOOLEAN, SIG_BYTE, SIG_CHAR, SIG_CLASS, SIG_DOUBLE, SIG_ENDCLASS, SIG_ENDMETHOD, SIG_FLOAT, SIG_INT, SIG_LONG, SIG_METHOD, SIG_PACKAGE, SIG_SHORT, SIG_VOID, SIGC_ARRAY, SIGC_BOOLEAN, SIGC_BYTE, SIGC_CHAR, SIGC_CLASS, SIGC_DOUBLE, SIGC_ENDCLASS, SIGC_ENDMETHOD, SIGC_FLOAT, SIGC_INT, SIGC_LONG, SIGC_METHOD, SIGC_PACKAGE, SIGC_SHORT, SIGC_VOID, T_BOOLEAN, T_BYTE, T_CHAR, T_CLASS, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT

Constructor Summary

Constructors
Constructor and Description
`BatchEnvironment(ClassPath path)` Deprecated. Old constructors -- these constructors build a BatchEnvironment with an old-style class path.
`BatchEnvironment(ClassPath sourcePath, ClassPath binaryPath)` Deprecated. New constructors -- these constructors build a BatchEnvironment with a source path and a binary path.
`BatchEnvironment(OutputStream out, ClassPath path)` Deprecated.
`BatchEnvironment(OutputStream out, ClassPath sourcePath, ClassPath binaryPath)` Deprecated.
`BatchEnvironment(OutputStream out, ClassPath sourcePath, ClassPath binaryPath, ErrorConsumer errorConsumer)` Deprecated.
`BatchEnvironment(OutputStream out, ClassPath path, ErrorConsumer errorConsumer)` Deprecated.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`classExists(Identifier nm)` Deprecated. Check if a class exists Applies only to package members (non-nested classes).
`protected static ClassPath[]`	`classPaths(String srcPathString, String classPathString, String sysClassPathString)` Deprecated.
`void`	`error(Object source, long where, String err, Object arg1, Object arg2, Object arg3)` Deprecated. Issue an error
`String`	`errorString(String err, Object arg1, Object arg2, Object arg3)` Deprecated. Error String
`void`	`flushErrors()` Deprecated.
`ClassDeclaration`	`getClassDeclaration(Identifier nm)` Deprecated. Get a class, given the fully qualified class name
`ClassDeclaration`	`getClassDeclaration(Type t)` Deprecated. Return a class declaration given a type.
`Enumeration<ClassDeclaration>`	`getClasses()` Deprecated. Return an enumeration of all the currently defined classes in order of appearance to getClassDeclaration().
`File`	`getcovFile()` Deprecated. Return coverage data file
`int`	`getFlags()` Deprecated. Return flags
`short`	`getMajorVersion()` Deprecated. Return major version to use for generated class files
`short`	`getMinorVersion()` Deprecated. Return minor version to use for generated class files
`Package`	`getPackage(Identifier pkg)` Deprecated. Get the package path for a package
`protected boolean`	`insertError(long where, String message)` Deprecated. Insert an error message in the list of outstanding error messages.
`boolean`	`isExemptPackage(Identifier id)` Deprecated. Tells whether an Identifier refers to a package which should be exempt from the "exists" check in Imports#resolve().
`void`	`loadDefinition(ClassDeclaration c)` Deprecated. Load the definition of a class or at least determine how to load it.
`ClassDefinition`	`makeClassDefinition(Environment toplevelEnv, long where, IdentifierToken name, String doc, int modifiers, IdentifierToken superClass, IdentifierToken[] interfaces, ClassDefinition outerClass)` Deprecated. Create a new class.
`MemberDefinition`	`makeMemberDefinition(Environment origEnv, long where, ClassDefinition clazz, String doc, int modifiers, Type type, Identifier name, IdentifierToken[] argNames, IdentifierToken[] expIds, Object value)` Deprecated. Create a new field.
`void`	`output(String msg)` Deprecated. Output a string.
`void`	`parseFile(ClassFile file)` Deprecated. Parse a source file
`void`	`pushError(String errorFileName, int line, String message, String referenceText, String referenceTextPointer)` Deprecated. Flush outstanding errors
`void`	`reportError(Object src, long where, String err, String msg)` Deprecated. Report error
`void`	`shutdown()` Deprecated. Release resources in classpath.

Methods inherited from class sun.tools.java.Environment
classExists, covdata, coverage, debug_lines, debug_source, debug_vars, debugOutput, dependencies, deprecation, dtEnter, dtEvent, dtExit, dump, dumpModifiers, error, error, error, error, explicitCast, getCharacterEncoding, getClassDefinition, getClassDefinition, getImports, getQualifiedClassDefinition, getSource, implicitCast, isApplicable, isMoreSpecific, isMoreSpecific, opt_interclass, opt, print_dependencies, resolve, resolve, resolveByName, resolveExtendsByName, resolveName, resolveNames, resolvePackageQualifiedName, setCharacterEncoding, strictdefault, verbose, version12, warnings

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail
- sourcePath
```
protected ClassPath sourcePath
```
  Deprecated.
  
  The path we use for finding source files.
- binaryPath
```
protected ClassPath binaryPath
```
  Deprecated.
  
  The path we use for finding class (binary) files.
- flags
```
public int flags
```
  Deprecated.
  
  flags
- majorVersion
```
public short majorVersion
```
  Deprecated.
  
  Major and minor versions to use for generated class files. Environments that extend BatchEnvironment (such as javadoc's Env class) get the default values below. javac itself may override these versions with values determined from the command line "-target" option.
- minorVersion
```
public short minorVersion
```
  Deprecated.
- covFile
```
public File covFile
```
  Deprecated.
  
  coverage data file
- nerrors
```
public int nerrors
```
  Deprecated.
  
  The number of errors and warnings
- nwarnings
```
public int nwarnings
```
  Deprecated.
- ndeprecations
```
public int ndeprecations
```
  Deprecated.
- errorLimit
```
public int errorLimit
```
  Deprecated.
  
  Maximum number of errors to print.

Constructor Detail

BatchEnvironment
```
public BatchEnvironment(ClassPath path)
```
Deprecated.

Old constructors -- these constructors build a BatchEnvironment with an old-style class path.

BatchEnvironment

public BatchEnvironment(OutputStream out,
                ClassPath path)

Deprecated.

BatchEnvironment

public BatchEnvironment(OutputStream out,
                ClassPath path,
                ErrorConsumer errorConsumer)

Deprecated.

BatchEnvironment
```
public BatchEnvironment(ClassPath sourcePath,
                ClassPath binaryPath)
```
Deprecated.

New constructors -- these constructors build a BatchEnvironment with a source path and a binary path.

BatchEnvironment

public BatchEnvironment(OutputStream out,
                ClassPath sourcePath,
                ClassPath binaryPath)

Deprecated.

BatchEnvironment

public BatchEnvironment(OutputStream out,
                ClassPath sourcePath,
                ClassPath binaryPath,
                ErrorConsumer errorConsumer)

Deprecated.

Method Detail

classPaths

protected static ClassPath[] classPaths(String srcPathString,
                     String classPathString,
                     String sysClassPathString)

Deprecated.

getFlags
```
public int getFlags()
```
Deprecated.

Return flags

Overrides:

getFlags in class Environment

getMajorVersion
```
public short getMajorVersion()
```
Deprecated.

Return major version to use for generated class files

Overrides:

getMajorVersion in class Environment

getMinorVersion
```
public short getMinorVersion()
```
Deprecated.

Return minor version to use for generated class files

Overrides:

getMinorVersion in class Environment

getcovFile
```
public File getcovFile()
```
Deprecated.

Return coverage data file

Overrides:

getcovFile in class Environment

getClasses
```
public Enumeration<ClassDeclaration> getClasses()
```
Deprecated.

Return an enumeration of all the currently defined classes in order of appearance to getClassDeclaration().

isExemptPackage
```
public boolean isExemptPackage(Identifier id)
```
Deprecated.

Tells whether an Identifier refers to a package which should be exempt from the "exists" check in Imports#resolve().

Overrides:

isExemptPackage in class Environment

getClassDeclaration
```
public ClassDeclaration getClassDeclaration(Identifier nm)
```
Deprecated.

Get a class, given the fully qualified class name

Overrides:

getClassDeclaration in class Environment

getClassDeclaration
```
public ClassDeclaration getClassDeclaration(Type t)
```
Deprecated.

Description copied from class: Environment

Return a class declaration given a type. Only works for class types.

Overrides:

getClassDeclaration in class Environment

classExists
```
public boolean classExists(Identifier nm)
```
Deprecated.

Check if a class exists Applies only to package members (non-nested classes).

Overrides:

classExists in class Environment

getPackage
```
public Package getPackage(Identifier pkg)
                   throws IOException
```
Deprecated.

Get the package path for a package

Overrides:

getPackage in class Environment

Throws:

IOException

parseFile

public void parseFile(ClassFile file)
               throws FileNotFoundException

Deprecated.

Parse a source file

Throws:: FileNotFoundException

loadDefinition
```
public void loadDefinition(ClassDeclaration c)
```
Deprecated.

Load the definition of a class or at least determine how to load it. The caller must repeat calls to this method until it the state converges to CS_BINARY, CS_PARSED, or the like..

Overrides:

loadDefinition in class Environment

See Also:
ClassDeclaration.getClassDefinition()

makeClassDefinition

public ClassDefinition makeClassDefinition(Environment toplevelEnv,
                                  long where,
                                  IdentifierToken name,
                                  String doc,
                                  int modifiers,
                                  IdentifierToken superClass,
                                  IdentifierToken[] interfaces,
                                  ClassDefinition outerClass)

Deprecated.

Create a new class.

Overrides:: makeClassDefinition in class Environment

makeMemberDefinition

public MemberDefinition makeMemberDefinition(Environment origEnv,
                                    long where,
                                    ClassDefinition clazz,
                                    String doc,
                                    int modifiers,
                                    Type type,
                                    Identifier name,
                                    IdentifierToken[] argNames,
                                    IdentifierToken[] expIds,
                                    Object value)

Deprecated.

Create a new field.

Overrides:: makeMemberDefinition in class Environment

shutdown
```
public void shutdown()
```
Deprecated.

Release resources in classpath.

Overrides:

shutdown in class Environment

errorString

public String errorString(String err,
                 Object arg1,
                 Object arg2,
                 Object arg3)

Deprecated.

Error String

insertError
```
protected boolean insertError(long where,
                  String message)
```
Deprecated.

Insert an error message in the list of outstanding error messages. The list is sorted on input position and contains no duplicates. The return value indicates whether or not the message was actually inserted. The method flushErrors() used to check for duplicate error messages. It would only detect duplicates if they were contiguous. Removing non-contiguous duplicate error messages is slightly less complicated at insertion time, so the functionality was moved here. This also saves a miniscule number of allocations.

pushError

public void pushError(String errorFileName,
             int line,
             String message,
             String referenceText,
             String referenceTextPointer)

Deprecated.

Flush outstanding errors

Specified by:: pushError in interface ErrorConsumer

flushErrors
```
public void flushErrors()
```
Deprecated.

reportError

public void reportError(Object src,
               long where,
               String err,
               String msg)

Deprecated.

Report error

error

public void error(Object source,
         long where,
         String err,
         Object arg1,
         Object arg2,
         Object arg3)

Deprecated.

Issue an error

Overrides:: error in class Environment

output
```
public void output(String msg)
```
Deprecated.

Output a string. This can either be an error message or something for debugging.

Overrides:

output in class Environment

Class BatchEnvironment

Field Summary

Fields inherited from interface sun.tools.java.Constants

Fields inherited from interface sun.tools.java.RuntimeConstants

Constructor Summary

Method Summary

Methods inherited from class sun.tools.java.Environment

Methods inherited from class java.lang.Object

Field Detail

sourcePath

binaryPath

flags

majorVersion

minorVersion

covFile

nerrors

nwarnings

ndeprecations

errorLimit

Constructor Detail

BatchEnvironment

BatchEnvironment

BatchEnvironment

BatchEnvironment

BatchEnvironment

BatchEnvironment

Method Detail

classPaths

getFlags

getMajorVersion

getMinorVersion

getcovFile

getClasses

isExemptPackage

getClassDeclaration

getClassDeclaration

classExists

getPackage

parseFile

loadDefinition

makeClassDefinition

makeMemberDefinition

shutdown

errorString

insertError

pushError

flushErrors

reportError

error

output