polyglot.ext.jl.ast
Class Field_c

java.lang.Object
  extended by polyglot.ext.jl.ast.Node_c
      extended by polyglot.ext.jl.ast.Term_c
          extended by polyglot.ext.jl.ast.Expr_c
              extended by polyglot.ext.jl.ast.Field_c
All Implemented Interfaces:
java.lang.Cloneable, Expr, Field, JL, Node, NodeOps, Prefix, Receiver, Term, Typed, Variable, Copy

public class Field_c
extends Expr_c
implements Field

A Field is an immutable representation of a Java field access. It consists of field name and may also have either a Type or an Expr containing the field being accessed.


Field Summary
protected  FieldInstance fi
           
protected  java.lang.String name
           
protected  Receiver target
           
protected  boolean targetImplicit
           
 
Fields inherited from class polyglot.ext.jl.ast.Expr_c
type
 
Fields inherited from class polyglot.ext.jl.ast.Term_c
exceptions, reachable
 
Fields inherited from class polyglot.ext.jl.ast.Node_c
del, ext, position
 
Constructor Summary
Field_c(Position pos, Receiver target, java.lang.String name)
           
 
Method Summary
 java.util.List acceptCFG(CFGBuilder v, java.util.List succs)
          Visit this term in evaluation order.
 Node buildTypes(TypeBuilder tb)
          Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these.
protected  void checkConsistency(Context c)
           
 Type childExpectedType(Expr child, AscriptionVisitor av)
          Get the expected type of a child expression of this.
 java.lang.Object constantValue()
          Returns the constant value of the expression, if any.
 void dump(CodeWriter w)
          Dump the AST node for debugging purposes.
 Term entry()
          Return the first (sub)term performed when evaluating this term.
 FieldInstance fieldInstance()
          Get the field instance of the field.
 Field fieldInstance(FieldInstance fi)
          Set the field instance of the field.
 Flags flags()
          Return the access flags of the variable.
 boolean isConstant()
          Return whether the expression evaluates to a constant.
 boolean isTargetImplicit()
          Returns whether the target of this field is implicit, that is if the target is either "this" or a classname, and the source code did not explicitly provide a target.
 java.lang.String name()
          Get the name of the field.
 Field name(java.lang.String name)
          Set the name of the field.
 Precedence precedence()
          Get the precedence of the field.
 void prettyPrint(CodeWriter w, PrettyPrinter tr)
          Write the field to an output file.
protected  Field_c reconstruct(Receiver target)
          Reconstruct the field.
 Receiver target()
          Get the target of the field.
 Field target(Receiver target)
          Set the target of the field.
 Field targetImplicit(boolean implicit)
          Set whether the target of the field is implicit.
 java.util.List throwTypes(TypeSystem ts)
          List of Types of exceptions that might get thrown.
 java.lang.String toString()
           
 Node typeCheck(TypeChecker tc)
          Type check the field.
 Node visitChildren(NodeVisitor v)
          Visit the children of the field.
 
Methods inherited from class polyglot.ext.jl.ast.Expr_c
booleanValue, byteValue, charValue, doubleValue, floatValue, intValue, longValue, printSubExpr, printSubExpr, shortValue, stringValue, type, type
 
Methods inherited from class polyglot.ext.jl.ast.Term_c
exceptionCheck, exceptions, exceptions, listEntry, reachable, reachable
 
Methods inherited from class polyglot.ext.jl.ast.Node_c
addDecls, addMembers, addMembersEnter, addMembersOverride, buildTypesEnter, buildTypesOverride, copy, del, del, disambiguate, disambiguateEnter, disambiguateOverride, enterScope, enterScope, exceptionCheckEnter, exceptionCheckOverride, ext, ext, ext, ext, init, node, position, position, print, printBlock, printSubStmt, translate, typeCheckEnter, typeCheckOverride, visit, visitChild, visitEdge, visitList
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface polyglot.ast.Expr
printSubExpr, printSubExpr, type
 
Methods inherited from interface polyglot.ast.Node
del, del, ext, ext, ext, ext, position, position, visit, visitChild, visitEdge, visitList
 
Methods inherited from interface polyglot.ast.JL
init, node
 
Methods inherited from interface polyglot.ast.NodeOps
addDecls, addMembers, addMembersEnter, buildTypesEnter, disambiguate, disambiguateEnter, enterScope, enterScope, exceptionCheck, exceptionCheckEnter, translate, typeCheckEnter
 
Methods inherited from interface polyglot.util.Copy
copy
 
Methods inherited from interface polyglot.ast.Typed
type
 
Methods inherited from interface polyglot.ast.Term
exceptions, exceptions, reachable, reachable
 

Field Detail

target

protected Receiver target

name

protected java.lang.String name

fi

protected FieldInstance fi

targetImplicit

protected boolean targetImplicit
Constructor Detail

Field_c

public Field_c(Position pos,
               Receiver target,
               java.lang.String name)
Method Detail

precedence

public Precedence precedence()
Get the precedence of the field.

Specified by:
precedence in interface Expr
Overrides:
precedence in class Expr_c

target

public Receiver target()
Get the target of the field.

Specified by:
target in interface Field

target

public Field target(Receiver target)
Set the target of the field.

Specified by:
target in interface Field

name

public java.lang.String name()
Get the name of the field.

Specified by:
name in interface Field

name

public Field name(java.lang.String name)
Set the name of the field.

Specified by:
name in interface Field

flags

public Flags flags()
Return the access flags of the variable.

Specified by:
flags in interface Variable

fieldInstance

public FieldInstance fieldInstance()
Get the field instance of the field.

Specified by:
fieldInstance in interface Field

fieldInstance

public Field fieldInstance(FieldInstance fi)
Set the field instance of the field.

Specified by:
fieldInstance in interface Field

isTargetImplicit

public boolean isTargetImplicit()
Description copied from interface: Field
Returns whether the target of this field is implicit, that is if the target is either "this" or a classname, and the source code did not explicitly provide a target.

Specified by:
isTargetImplicit in interface Field

targetImplicit

public Field targetImplicit(boolean implicit)
Description copied from interface: Field
Set whether the target of the field is implicit.

Specified by:
targetImplicit in interface Field

reconstruct

protected Field_c reconstruct(Receiver target)
Reconstruct the field.


visitChildren

public Node visitChildren(NodeVisitor v)
Visit the children of the field.

Specified by:
visitChildren in interface NodeOps
Overrides:
visitChildren in class Node_c
Parameters:
v - The visitor that will traverse/rewrite the AST.
Returns:
A new AST if a change was made, or this.

buildTypes

public Node buildTypes(TypeBuilder tb)
                throws SemanticException
Description copied from interface: NodeOps
Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these. These type objects may be ambiguous. Inserts classes into the TypeSystem. This method is called by the leave() method of the visitor. The method should perform work that should be done after visiting the children of the node. The method may return this or a new copy of the node which will be installed as a child of the node's parent.

Specified by:
buildTypes in interface NodeOps
Overrides:
buildTypes in class Expr_c
Parameters:
tb - The visitor which adds new type objects to the TypeSystem.
Throws:
SemanticException

typeCheck

public Node typeCheck(TypeChecker tc)
               throws SemanticException
Type check the field.

Specified by:
typeCheck in interface NodeOps
Overrides:
typeCheck in class Node_c
Parameters:
tc - The type checking visitor.
Throws:
SemanticException

childExpectedType

public Type childExpectedType(Expr child,
                              AscriptionVisitor av)
Description copied from interface: Node
Get the expected type of a child expression of this. The expected type is determined by the context in that the child occurs (e.g., for x = e, the expected type of e is the declared type of x. The expected type should impose the least constraints on the child's type that are allowed by the parent node.

Specified by:
childExpectedType in interface Node
Overrides:
childExpectedType in class Node_c
Parameters:
child - A child expression of this node.
av - An ascription visitor.
Returns:
The expected type of child.

prettyPrint

public void prettyPrint(CodeWriter w,
                        PrettyPrinter tr)
Write the field to an output file.

Specified by:
prettyPrint in interface NodeOps
Overrides:
prettyPrint in class Node_c
Parameters:
w - The code writer to which to write.
tr - The pretty printer. This is not a visitor.

dump

public void dump(CodeWriter w)
Description copied from interface: Node
Dump the AST node for debugging purposes.

Specified by:
dump in interface Node
Overrides:
dump in class Expr_c

entry

public Term entry()
Description copied from class: Term_c
Return the first (sub)term performed when evaluating this term.

Specified by:
entry in interface Term
Specified by:
entry in class Term_c

acceptCFG

public java.util.List acceptCFG(CFGBuilder v,
                                java.util.List succs)
Description copied from class: Term_c
Visit this term in evaluation order.

Specified by:
acceptCFG in interface Term
Specified by:
acceptCFG in class Term_c

toString

public java.lang.String toString()
Overrides:
toString in class Node_c

throwTypes

public java.util.List throwTypes(TypeSystem ts)
Description copied from interface: NodeOps
List of Types of exceptions that might get thrown. The result is not necessarily correct until after type checking.

Specified by:
throwTypes in interface NodeOps
Overrides:
throwTypes in class Node_c

isConstant

public boolean isConstant()
Description copied from interface: Expr
Return whether the expression evaluates to a constant. This is not valid until after disambiguation.

Specified by:
isConstant in interface Expr
Overrides:
isConstant in class Expr_c

constantValue

public java.lang.Object constantValue()
Description copied from interface: Expr
Returns the constant value of the expression, if any.

Specified by:
constantValue in interface Expr
Overrides:
constantValue in class Expr_c

checkConsistency

protected void checkConsistency(Context c)