[DERBY-791] Expose api for printing Abstract Syntax Trees in production (non-debug) servers

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: SQL
• Labels: derby_triage10_11
• Urgency: Normal
• Assignee: Unassigned
• Reporter: Richard N. Hillegas
• Created: 04/Jan/06 06:32
• Updated: 25/Jun/13 15:17

Description

Currently you can print Abstract Syntax Trees to derby.log by setting the DumpParseTree tracepoint at server startup. E.g.:

java -cp $CLASSPATH -Dderby.debug.true=DumpParseTree -Dderby.stream.error.logSeverityLevel=0 org.apache.derby.tools.ij z.sql

This can be a useful debugging tool. However, it only works on debug servers built with the following flags:

sanity=true
debug=true

We should provide some mechanism for printing these trees in production (non-debug) servers.

Issue Links

• is related to: DERBY-6263 Make acceptChildren() overloads visit all clauses in QueryTreeNodes
• is related to: DERBY-3946 Provide support for using the Derby parser to generate Abstract Syntax Trees
• relates to: DERBY-673 Get rid of the NodeFactory
• relates to: DERBY-4415 Make it easy to plug custom AST printers into the compiler