Package adql.query

Interface ADQLObject

All Known Subinterfaces:
ADQLConstraint, ADQLOperand, FromContent, UnknownType
All Known Implementing Classes:
ADQLColumn, ADQLFunction, ADQLJoin, ADQLList, ADQLOrder, ADQLQuery, ADQLSet, ADQLTable, AreaFunction, Between, BoxFunction, CastFunction, CentroidFunction, CircleFunction, ClauseADQL, ClauseConstraints, ClauseOffset, ClauseSelect, CoalesceFunction, ColumnReference, Comparison, Concatenation, ConstraintsGroup, ContainsFunction, CrossJoin, DefaultUDF, DistanceFunction, Exists, ExtractCoord, ExtractCoordSys, GeometryFunction, GeometryFunction.GeometryValue, In, InnerJoin, IntersectsFunction, InUnitFunction, IsNull, LowerFunction, MathFunction, NegativeOperand, NotConstraint, NullValue, NumericConstant, Operation, OuterJoin, PointFunction, PolygonFunction, RegionFunction, SelectAllColumns, SelectItem, SetOperation, SQLFunction, SQLServer_InnerJoin, SQLServer_OuterJoin, StringConstant, UpperFunction, UserDefinedFunction, WithItem, WrappedOperand

public interface ADQLObject
This class gathers all main behaviors of any ADQL object (query, clause, columns, condition, etc...):
  • to have a name in ADQL,
  • to be written in ADQL,
  • to offer a way to search any ADQL item (included itself),
  • to get its position in the original ADQL query,
  • to be defined as an ADQL language feature.
  • Method Details

    • getName

      String getName()
      Gets the name of this object in ADQL.
      Returns:
      The name of this ADQL object.
    • getPosition

      TextPosition getPosition()
      Gets the position of this object/token in the ADQL query.

      By default, no position should be set.

      Returns:
      Position of this ADQL item in the ADQL query, or NULL if not written originally in the query (for example, if added afterwards).
      Since:
      1.4
    • toADQL

      String toADQL()
      Gets the ADQL expression of this object.
      Returns:
      The corresponding ADQL expression.
    • getFeatureDescription

      LanguageFeature getFeatureDescription()
      Get the description of this ADQL's Language Feature.

      Note: Getting this description is generally only useful when discovery optional features so that determining if they are allowed to be used in ADQL queries.

      Returns:
      Description of this ADQL object as an ADQL's feature.
      Since:
      2.0
    • getCopy

      ADQLObject getCopy() throws Exception
      Gets a (deep) copy of this ADQL object.
      Returns:
      The copy of this ADQL object.
      Throws:
      Exception - If there is any error during the copy.
    • adqlIterator

      ADQLIterator adqlIterator()
      Gets an iterator on the intern ADQL objects.

      Note: The returned iterator is particularly used by a ISearchHandler extension to browse a whole ADQL tree.

      Returns:
      An ADQL objects iterator.
      See Also: