Package nz.org.riskscape.rl.ast

Class StructDeclaration

java.lang.Object
nz.org.riskscape.rl.ast.StructDeclaration
All Implemented Interfaces:
AST, Expression
public class StructDeclaration extends Object

  • Field Details

    • EMPTY

      public static final StructDeclaration EMPTY

      A base-case empty StructDeclaration - useful as a better null sentinel.

  • Constructor Details

  • Method Details

    • anonMember

      public static StructDeclaration.Member anonMember(Expression expression)
      Returns:
      an anonymous attribute declaration wrapping the given expression.

    • jsonStyleMember

      public static StructDeclaration.Member jsonStyleMember(Token ident, Expression expression)

      Returns a json style (foo: bar) struct member

    • jsonStyleMember

      public static StructDeclaration.Member jsonStyleMember(String ident, Expression expression)

      Returns a json style (foo: bar) struct member

    • sqlStyleMember

      public static StructDeclaration.Member sqlStyleMember(Token ident, Expression expression, Token as)

      Returns an sql style (bar as foo) struct member

    • selectAllMember

      public static StructDeclaration.Member selectAllMember(Token asterisk)

      Returns a select-all ({*}) struct member

    • appendSource

      protected void appendSource(StringBuilder appendTo)

      Implementers extend this to append their source to the given string builder. Done via string builder to encourage a more efficient implementation than is possible with concatenating multiple toString calls that typically contruct a string builder anyway.

    • accept

      public <T, R> R accept(ExpressionVisitor<T,R> visitor, T data)

    • getMember

      public StructDeclaration.Member getMember(int index)

      Shortcut for getMembers().get(index)

      Returns:
      the AttrDeclaration at the given zero-based index
      Throws:
      IndexOutOfBoundsException - if the index is < 0 or > size

    • withNewMembers

      public StructDeclaration withNewMembers(List<StructDeclaration.Member> newMembers, Optional<Pair<Token,Token>> newBoundary)

    • isEmpty

      public boolean isEmpty()

    • isLiteral

      public boolean isLiteral()
      Description copied from interface: Expression

      Tests whether this expression is a literal expression - a literal expression is a constant expression that is unaffected by the scope in which it was realized/evaluated and contains no function-defined behaviour. Therefore a literal expression is one that contains no property access (unless the receiver is a literal) and no function calls.

      A literal expression will always realize to being a constant (e.g. RealizedExpression.isConstant() will return true), however there are constant expressions that are not literal.

      One edge case to be aware of is a limitation of the AST in determining literal expressions in contrived cases like this one - {foo: 'bar', baz: qux}.foo. The struct is not literal, but the property being accessed is. But because the AST is relatively 'dumb', the expression itself is not literal. It can, however, be realized as a constant - realization is 'smarter' and can pick out the that the property being accessed is constant.

    • equals

      public boolean equals(Object o)

    • canEqual

      protected boolean canEqual(Object other)

    • hashCode

      public int hashCode()

    • getMembers

      public List<StructDeclaration.Member> getMembers()

    • getBoundary

      public Optional<Pair<Token,Token>> getBoundary()
      Returns:
      a pair of tokens that represent the start and end of this expression, to be used when giving users information about where errors have occurred. If the expression has been rebuilt then the boundary may be empty or it may be from the original AST. Intended for use in problems to trace errors back to their source.

    • appendSource

      protected static void appendSource(AST ast, StringBuilder appendTo)

      Helper method for appending the source of another ast element to a string builder, efficiently if possible.

    • toString

      public final String toString()

      Returns a simplified view of the ast in a source-like fashion, but with a lot of details left out for conciseness

      Overrides:
      toString in class Object

    • appendString

      protected void appendString(StringBuilder appendTo)

      Append a simplified string representation to the builder. Default implementation uses appendSource. Subclasses can override to provide a more concise representation.

    • toSource

      public final String toSource()
      Specified by:
      toSource in interface AST
      Returns:
      a normalized version of the AST that can be parsed to be exactly the same AST as this