edu.illinois.cs.cogcomp.lbjava

Class RevisionAnalysis

java.lang.Object

edu.illinois.cs.cogcomp.lbjava.Pass

edu.illinois.cs.cogcomp.lbjava.RevisionAnalysis

public class RevisionAnalysis
extends Pass

To be run after SemanticAnalysis, this pass determines which CodeGenerators need to have their code generated and which classifiers need to be trained based on the revisions made to the LBJava source file.

A hard coded classifier, a constraint, or an inference named foo needs its code regenerated iff at least one of the following is true:

• The file foo.java does not exist.
• Using the comments at the top of foo.java, it is determined that the code specifying foo has been revised.

If the comments at the top of foo.java do not exist, or if they don't have the expected form, the file will not be overwritten and an error will be generated.

All CodeGenerators are also labeled as either "affected" (by a revision) or "unaffected". An CodeGenerator named foo is labeled "affected" iff at least one of the following is true:

• foo is a hard coded classifier, a constraint, or an inference and either:
  • its code needed to be regenerated as described above or
  • it invokes another "affected" CodeGenerator.
• foo is a learning classifier and at least one of its label or extractor classifiers is "affected".

A learning classifier named foo needs to have its code regenerated and retrained iff at least one of the following is true:

• The file foo.java does not exist.
• Using the comments at the top of foo.java, it is determined that the code specifying foo has been revised.
• At least one of its label or extractor classifiers is "affected".

Author:

Nick Rizzolo

See Also:

SemanticAnalysis

Field Summary

Fields

Modifier and Type	Field and Description
static Integer	AFFECTED Constant representing the "affected" revision status.
static boolean	noChanges Set to true iff no code has changed since the compiler was last run.
static Integer	REVISED Constant representing the "revised" revision status.
static HashMap	revisionStatus Keeps track of the names of classifiers whose revision status has been resolved.
static String[]	statusNames The names of the three revision states.
static Integer	UNAFFECTED Constant representing the "unaffected" revision status.

Fields inherited from class edu.illinois.cs.cogcomp.lbjava.Pass

ast, canAddErrorsAndWarnings, fatalError, root

Constructor Summary

Constructors

Constructor and Description
RevisionAnalysis(AST ast) Instantiates a pass that runs on an entire AST.

Method Summary

Modifier and Type	Method and Description
static void	printRevisionStatus() Prints the contents of revisionStatus to STDOUT.
void	run(ClassifierName cn) Runs this pass on all nodes of the indicated type.
void	run(CodedClassifier cc) Runs this pass on all nodes of the indicated type.
void	run(CompositeGenerator cg) Runs this pass on all nodes of the indicated type.
void	run(Conjunction c) Runs this pass on all nodes of the indicated type.
void	run(ConstraintDeclaration cd) Runs this pass on all nodes of the indicated type.
void	run(DeclarationList list) Runs this pass on all nodes of the indicated type.
void	run(InferenceDeclaration id) Runs this pass on all nodes of the indicated type.
void	run(InferenceInvocation i) Runs this pass on all nodes of the indicated type.
void	run(LearningClassifierExpression lce) Runs this pass on all nodes of the indicated type.
static String	statusToString(Integer status) Returns the name of a revision status, or "no status" if the status is null.

Methods inherited from class edu.illinois.cs.cogcomp.lbjava.Pass

printErrorsAndWarnings, reportError, reportWarning, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, runOnChildren, setRoot

Methods inherited from class java.lang.Object

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

Field Detail

UNAFFECTED

public static final Integer UNAFFECTED

Constant representing the "unaffected" revision status.

AFFECTED

public static final Integer AFFECTED

Constant representing the "affected" revision status.

REVISED

public static final Integer REVISED

Constant representing the "revised" revision status.

statusNames

public static final String[] statusNames

The names of the three revision states.

revisionStatus

public static HashMap revisionStatus

Keeps track of the names of classifiers whose revision status has been resolved.

noChanges

public static boolean noChanges

Set to true iff no code has changed since the compiler was last run.

Constructor Detail

RevisionAnalysis

public RevisionAnalysis(AST ast)

Instantiates a pass that runs on an entire AST.

Parameters:

ast - The program to run this pass on.

Method Detail

printRevisionStatus

public static void printRevisionStatus()

Prints the contents of revisionStatus to STDOUT.

statusToString

public static String statusToString(Integer status)

Returns the name of a revision status, or "no status" if the status is null.

run

public void run(DeclarationList list)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

list - The node to process.

run

public void run(LearningClassifierExpression lce)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

lce - The node to process.

run

public void run(ClassifierName cn)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

cn - The node to process.

run

public void run(CodedClassifier cc)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

cc - The node to process.

run

public void run(CompositeGenerator cg)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

cg - The node to process.

run

public void run(Conjunction c)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

c - The node to process.

run

public void run(InferenceInvocation i)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

i - The node to process.

run

public void run(ConstraintDeclaration cd)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

cd - The node to process.

run

public void run(InferenceDeclaration id)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

id - The node to process.