casacore
TaQLNodeVisitor.h
Go to the documentation of this file.
1 //# TaQLNodeVisitor.h: Class to visit the nodes in the raw TaQL parse tree
2 //# Copyright (C) 2005
3 //# Associated Universities, Inc. Washington DC, USA.
4 //#
5 //# This library is free software; you can redistribute it and/or modify it
6 //# under the terms of the GNU Library General Public License as published by
7 //# the Free Software Foundation; either version 2 of the License, or (at your
8 //# option) any later version.
9 //#
10 //# This library is distributed in the hope that it will be useful, but WITHOUT
11 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
13 //# License for more details.
14 //#
15 //# You should have received a copy of the GNU Library General Public License
16 //# along with this library; if not, write to the Free Software Foundation,
17 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
18 //#
19 //# Correspondence concerning AIPS++ should be addressed as follows:
20 //# Internet email: aips2-request@nrao.edu.
21 //# Postal address: AIPS++ Project Office
22 //# National Radio Astronomy Observatory
23 //# 520 Edgemont Road
24 //# Charlottesville, VA 22903-2475 USA
25 //#
26 //# $Id$
27 
28 #ifndef TABLES_TAQLNODEVISITOR_H
29 #define TABLES_TAQLNODEVISITOR_H
30 
31 //# Includes
32 #include <casacore/casa/aips.h>
33 #include <casacore/tables/TaQL/TaQLNode.h>
34 #include <casacore/tables/TaQL/TaQLNodeDer.h>
35 
36 namespace casacore { //# NAMESPACE CASACORE - BEGIN
37 
38 // <summary>
39 // Class to visit the nodes in the raw TaQL parse tree.
40 // </summary>
41 
42 // <use visibility=local>
43 
44 // <reviewed reviewer="" date="" tests="tTableGram">
45 // </reviewed>
46 
47 // <prerequisite>
48 //# Classes you should understand before using this one.
49 // <li> <linkto class=TaQLNode>TaQLNode</linkto>
50 // <li> Note 199 describing
51 // <a href="../notes/199.html">
52 // TaQL</a>
53 // </prerequisite>
54 
55 // <synopsis>
56 // TaQLNodeVisitor is the abstract base class for classes that want to
57 // visit a TaQLNode tree, i.e. traverse the tree.
58 // Each visit results in a TaQLNodeResult object which acts as the basis
59 // for the actual result object.
60 // <br>
61 // A specialization of TaQLNodeVisitor (e.g. class
62 // <linkto class=TaQLNodeHandler>TaQLNodeHandler</linkto> needs to implement
63 // the various visitXXNode functions. A visit function will process a node
64 // which usually means visiting its children, etc..
65 // </synopsis>
66 
67 // <motivation>
68 // The visitor design pattern separates the tree from the way it is processed.
69 // In this way any handler can be created. For instance, a query optimizer
70 // could be a future other handler.
71 // </motivation>
72 
74 {
75 public:
76  virtual ~TaQLNodeVisitor();
77 
78  // Define the functions to visit each node type.
79  // <group>
80  virtual TaQLNodeResult visitConstNode (const TaQLConstNodeRep& node) = 0;
81  virtual TaQLNodeResult visitRegexNode (const TaQLRegexNodeRep& node) = 0;
82  virtual TaQLNodeResult visitUnaryNode (const TaQLUnaryNodeRep& node) = 0;
83  virtual TaQLNodeResult visitBinaryNode (const TaQLBinaryNodeRep& node) = 0;
84  virtual TaQLNodeResult visitMultiNode (const TaQLMultiNodeRep& node) = 0;
85  virtual TaQLNodeResult visitFuncNode (const TaQLFuncNodeRep& node) = 0;
86  virtual TaQLNodeResult visitRangeNode (const TaQLRangeNodeRep& node) = 0;
87  virtual TaQLNodeResult visitIndexNode (const TaQLIndexNodeRep& node) = 0;
88  virtual TaQLNodeResult visitKeyColNode (const TaQLKeyColNodeRep& node) = 0;
89  virtual TaQLNodeResult visitTableNode (const TaQLTableNodeRep& node) = 0;
90  virtual TaQLNodeResult visitColNode (const TaQLColNodeRep& node) = 0;
91  virtual TaQLNodeResult visitColumnsNode (const TaQLColumnsNodeRep& node) = 0;
92  virtual TaQLNodeResult visitJoinNode (const TaQLJoinNodeRep& node) = 0;
93  virtual TaQLNodeResult visitGroupNode (const TaQLGroupNodeRep& node) = 0;
94  virtual TaQLNodeResult visitSortKeyNode (const TaQLSortKeyNodeRep& node) = 0;
95  virtual TaQLNodeResult visitSortNode (const TaQLSortNodeRep& node) = 0;
96  virtual TaQLNodeResult visitLimitOffNode (const TaQLLimitOffNodeRep& node) = 0;
97  virtual TaQLNodeResult visitGivingNode (const TaQLGivingNodeRep& node) = 0;
98  virtual TaQLNodeResult visitUpdExprNode (const TaQLUpdExprNodeRep& node) = 0;
99  virtual TaQLNodeResult visitSelectNode (const TaQLSelectNodeRep& node) = 0;
100  virtual TaQLNodeResult visitUpdateNode (const TaQLUpdateNodeRep& node) = 0;
101  virtual TaQLNodeResult visitInsertNode (const TaQLInsertNodeRep& node) = 0;
102  virtual TaQLNodeResult visitDeleteNode (const TaQLDeleteNodeRep& node) = 0;
103  virtual TaQLNodeResult visitCountNode (const TaQLCountNodeRep& node) = 0;
104  virtual TaQLNodeResult visitCalcNode (const TaQLCalcNodeRep& node) = 0;
105  virtual TaQLNodeResult visitCreTabNode (const TaQLCreTabNodeRep& node) = 0;
106  virtual TaQLNodeResult visitColSpecNode (const TaQLColSpecNodeRep& node) = 0;
107  virtual TaQLNodeResult visitRecFldNode (const TaQLRecFldNodeRep& node) = 0;
108  virtual TaQLNodeResult visitUnitNode (const TaQLUnitNodeRep& node) = 0;
109  virtual TaQLNodeResult visitAltTabNode (const TaQLAltTabNodeRep& node) = 0;
110  virtual TaQLNodeResult visitAddColNode (const TaQLAddColNodeRep& node) = 0;
111  virtual TaQLNodeResult visitSetKeyNode (const TaQLSetKeyNodeRep& node) = 0;
112  virtual TaQLNodeResult visitRenDropNode (const TaQLRenDropNodeRep& node) = 0;
113  virtual TaQLNodeResult visitAddRowNode (const TaQLAddRowNodeRep& node) = 0;
114  virtual TaQLNodeResult visitConcTabNode (const TaQLConcTabNodeRep& node) = 0;
115  virtual TaQLNodeResult visitShowNode (const TaQLShowNodeRep& node) = 0;
116  // </group>
117 
118 protected:
119  // A convenience function to visit the given node using this visitor.
121  { return node.visit (*this); }
122 };
123 
124 } //# NAMESPACE CASACORE - END
125 
126 #endif
casacore::TaQLNodeVisitor::visitFuncNode
virtual TaQLNodeResult visitFuncNode(const TaQLFuncNodeRep &node)=0
casacore::TaQLNodeVisitor::~TaQLNodeVisitor
virtual ~TaQLNodeVisitor()
casacore::TaQLNodeVisitor::visitCalcNode
virtual TaQLNodeResult visitCalcNode(const TaQLCalcNodeRep &node)=0
casacore::TaQLRangeNodeRep
Raw TaQL parse tree node defining a range.
Definition: TaQLNodeDer.h:330
casacore::TaQLNodeVisitor::visitColumnsNode
virtual TaQLNodeResult visitColumnsNode(const TaQLColumnsNodeRep &node)=0
casacore::TaQLNodeVisitor::visitConstNode
virtual TaQLNodeResult visitConstNode(const TaQLConstNodeRep &node)=0
Define the functions to visit each node type.
casacore::TaQLBinaryNodeRep
Raw TaQL parse tree node defining a binary operator.
Definition: TaQLNodeDer.h:194
casacore::TaQLNodeVisitor::visitIndexNode
virtual TaQLNodeResult visitIndexNode(const TaQLIndexNodeRep &node)=0
casacore::TaQLKeyColNodeRep
Raw TaQL parse tree node defining a keyword or column name.
Definition: TaQLNodeDer.h:427
casacore::TaQLRegexNodeRep
Raw TaQL parse tree node defining a constant regex value.
Definition: TaQLNodeDer.h:119
casacore::TaQLColumnsNodeRep
Raw TaQL parse tree node defining a select column list.
Definition: TaQLNodeDer.h:524
casacore::TaQLNodeVisitor::visitRangeNode
virtual TaQLNodeResult visitRangeNode(const TaQLRangeNodeRep &node)=0
casacore::TaQLNodeVisitor::visitColNode
virtual TaQLNodeResult visitColNode(const TaQLColNodeRep &node)=0
casacore::TaQLNode::visit
TaQLNodeResult visit(TaQLNodeVisitor &visitor) const
Let the visitor visit the node.
Definition: TaQLNode.h:131
casacore::TaQLNodeVisitor::visitUnaryNode
virtual TaQLNodeResult visitUnaryNode(const TaQLUnaryNodeRep &node)=0
casacore::TaQLCalcNodeRep
Raw TaQL parse tree node defining a calc command.
Definition: TaQLNodeDer.h:998
casacore::TaQLNodeVisitor::visitShowNode
virtual TaQLNodeResult visitShowNode(const TaQLShowNodeRep &node)=0
casacore::TaQLNodeVisitor::visitSetKeyNode
virtual TaQLNodeResult visitSetKeyNode(const TaQLSetKeyNodeRep &node)=0
casacore::TaQLNodeVisitor::visitMultiNode
virtual TaQLNodeResult visitMultiNode(const TaQLMultiNodeRep &node)=0
casacore::TaQLNodeVisitor::visitRecFldNode
virtual TaQLNodeResult visitRecFldNode(const TaQLRecFldNodeRep &node)=0
casacore::TaQLGivingNodeRep
Raw TaQL parse tree node defining a giving expression list.
Definition: TaQLNodeDer.h:685
casacore::TaQLRecFldNodeRep
Raw TaQL parse tree node defining a record field.
Definition: TaQLNodeDer.h:1099
casacore::TaQLNodeVisitor::visitCreTabNode
virtual TaQLNodeResult visitCreTabNode(const TaQLCreTabNodeRep &node)=0
casacore::TaQLNodeVisitor::visitAddColNode
virtual TaQLNodeResult visitAddColNode(const TaQLAddColNodeRep &node)=0
casacore::TaQLNodeVisitor::visitUpdateNode
virtual TaQLNodeResult visitUpdateNode(const TaQLUpdateNodeRep &node)=0
casacore::TaQLUpdateNodeRep
Raw TaQL parse tree node defining an update command.
Definition: TaQLNodeDer.h:890
casacore::TaQLNodeVisitor::visitRegexNode
virtual TaQLNodeResult visitRegexNode(const TaQLRegexNodeRep &node)=0
casacore::TaQLTableNodeRep
Raw TaQL parse tree node defining a table.
Definition: TaQLNodeDer.h:458
casacore::TaQLNodeVisitor::visitSelectNode
virtual TaQLNodeResult visitSelectNode(const TaQLSelectNodeRep &node)=0
casacore::TaQLColNodeRep
Raw TaQL parse tree node defining a select column expression.
Definition: TaQLNodeDer.h:491
casacore::TaQLNode
Envelope class for a node in the raw TaQL parse tree.
Definition: TaQLNode.h:82
casacore::TaQLNodeVisitor::visitNode
TaQLNodeResult visitNode(const TaQLNode &node)
A convenience function to visit the given node using this visitor.
Definition: TaQLNodeVisitor.h:120
casacore::TaQLNodeVisitor::visitCountNode
virtual TaQLNodeResult visitCountNode(const TaQLCountNodeRep &node)=0
casacore::TaQLNodeResult
Envelope class to hold the result of a visit to the node tree.
Definition: TaQLNodeResult.h:123
casacore::TaQLNodeVisitor::visitJoinNode
virtual TaQLNodeResult visitJoinNode(const TaQLJoinNodeRep &node)=0
casacore::TaQLConcTabNodeRep
Raw TaQL parse tree node defining an alter table command.
Definition: TaQLNodeDer.h:1310
casacore::TaQLAddColNodeRep
Raw TaQL parse tree node defining an alter table add column command.
Definition: TaQLNodeDer.h:1196
casacore::TaQLLimitOffNodeRep
Raw TaQL parse tree node defining a limit/offset expression.
Definition: TaQLNodeDer.h:655
casacore::TaQLRenDropNodeRep
Raw TaQL parse tree node defining an alter table rename or drop command.
Definition: TaQLNodeDer.h:1225
casacore::TaQLInsertNodeRep
Raw TaQL parse tree node defining an insert command.
Definition: TaQLNodeDer.h:928
casacore::TaQLNodeVisitor::visitUnitNode
virtual TaQLNodeResult visitUnitNode(const TaQLUnitNodeRep &node)=0
casacore::TaQLNodeVisitor::visitKeyColNode
virtual TaQLNodeResult visitKeyColNode(const TaQLKeyColNodeRep &node)=0
casacore::TaQLNodeVisitor::visitGroupNode
virtual TaQLNodeResult visitGroupNode(const TaQLGroupNodeRep &node)=0
casacore::TaQLNodeVisitor::visitSortKeyNode
virtual TaQLNodeResult visitSortKeyNode(const TaQLSortKeyNodeRep &node)=0
casacore::TaQLNodeVisitor::visitConcTabNode
virtual TaQLNodeResult visitConcTabNode(const TaQLConcTabNodeRep &node)=0
casacore::TaQLNodeVisitor::visitInsertNode
virtual TaQLNodeResult visitInsertNode(const TaQLInsertNodeRep &node)=0
casacore::TaQLNodeVisitor::visitUpdExprNode
virtual TaQLNodeResult visitUpdExprNode(const TaQLUpdExprNodeRep &node)=0
casacore
this file contains all the compiler specific defines
Definition: mainpage.dox:28
casacore::TaQLSelectNodeRep
Raw TaQL parse tree node defining a select command.
Definition: TaQLNodeDer.h:808
casacore::TaQLUnitNodeRep
Raw TaQL parse tree node defining a unit.
Definition: TaQLNodeDer.h:1134
casacore::TaQLNodeVisitor::visitAltTabNode
virtual TaQLNodeResult visitAltTabNode(const TaQLAltTabNodeRep &node)=0
casacore::TaQLAltTabNodeRep
Raw TaQL parse tree node defining an alter table command.
Definition: TaQLNodeDer.h:1163
casacore::TaQLSortNodeRep
Raw TaQL parse tree node defining a sort list.
Definition: TaQLNodeDer.h:621
casacore::TaQLNodeVisitor::visitRenDropNode
virtual TaQLNodeResult visitRenDropNode(const TaQLRenDropNodeRep &node)=0
casacore::TaQLNodeVisitor::visitBinaryNode
virtual TaQLNodeResult visitBinaryNode(const TaQLBinaryNodeRep &node)=0
casacore::TaQLFuncNodeRep
Raw TaQL parse tree node defining a function.
Definition: TaQLNodeDer.h:299
casacore::TaQLShowNodeRep
Raw TaQL parse tree node defining a show command.
Definition: TaQLNodeDer.h:1342
casacore::TaQLUpdExprNodeRep
Raw TaQL parse tree node defining a column update expression.
Definition: TaQLNodeDer.h:719
casacore::TaQLIndexNodeRep
Raw TaQL parse tree node defining an index in a array.
Definition: TaQLNodeDer.h:365
casacore::TaQLNodeVisitor::visitAddRowNode
virtual TaQLNodeResult visitAddRowNode(const TaQLAddRowNodeRep &node)=0
casacore::TaQLNodeVisitor::visitLimitOffNode
virtual TaQLNodeResult visitLimitOffNode(const TaQLLimitOffNodeRep &node)=0
casacore::TaQLNodeVisitor
Class to visit the nodes in the raw TaQL parse tree.
Definition: TaQLNodeVisitor.h:73
casacore::TaQLNodeVisitor::visitSortNode
virtual TaQLNodeResult visitSortNode(const TaQLSortNodeRep &node)=0
casacore::TaQLConstNodeRep
Raw TaQL parse tree node defining a constant value.
Definition: TaQLNodeDer.h:61
casacore::TaQLNodeVisitor::visitTableNode
virtual TaQLNodeResult visitTableNode(const TaQLTableNodeRep &node)=0
casacore::TaQLNodeVisitor::visitColSpecNode
virtual TaQLNodeResult visitColSpecNode(const TaQLColSpecNodeRep &node)=0
casacore::TaQLAddRowNodeRep
Raw TaQL parse tree node defining an alter table add rows command.
Definition: TaQLNodeDer.h:1282
casacore::TaQLJoinNodeRep
Raw TaQL parse tree node defining a join operation.
Definition: TaQLNodeDer.h:397
casacore::TaQLNodeVisitor::visitGivingNode
virtual TaQLNodeResult visitGivingNode(const TaQLGivingNodeRep &node)=0
casacore::TaQLCountNodeRep
Raw TaQL parse tree node defining a count command.
Definition: TaQLNodeDer.h:856
casacore::TaQLNodeVisitor::visitDeleteNode
virtual TaQLNodeResult visitDeleteNode(const TaQLDeleteNodeRep &node)=0
casacore::TaQLColSpecNodeRep
Raw TaQL parse tree node defining a create column specification.
Definition: TaQLNodeDer.h:1068
casacore::TaQLMultiNodeRep
Raw TaQL parse tree node defining a list of nodes.
Definition: TaQLNodeDer.h:251
casacore::TaQLSetKeyNodeRep
Raw TaQL parse tree node defining an alter table set keyword command.
Definition: TaQLNodeDer.h:1254
casacore::TaQLGroupNodeRep
Raw TaQL parse tree node defining a groupby list.
Definition: TaQLNodeDer.h:554
casacore::TaQLSortKeyNodeRep
Raw TaQL parse tree node defining a sort key.
Definition: TaQLNodeDer.h:587
casacore::TaQLUnaryNodeRep
Raw TaQL parse tree node defining a unary operator.
Definition: TaQLNodeDer.h:156
casacore::TaQLDeleteNodeRep
Raw TaQL parse tree node defining a delete command.
Definition: TaQLNodeDer.h:964
casacore::TaQLCreTabNodeRep
Raw TaQL parse tree node defining a create table command.
Definition: TaQLNodeDer.h:1033