Entrypoint into the Plsql parser. In this preliminary version, you
can only parse full Plsql files (i.e. no expression parsing) and it
only parses procedure/function in the root, local variables in the
block declarations, and for loops in the statements.
Error handling. If there are any syntax errors, the parser will
generate error Strings and generate as much of the parse tree as
possible. The client will be able to retrieve the array of error
Strings from the returned parse tree JavaSymbol. If there are any
errors, it is almost guaranteed the tree will NOT be
well-formed. In rare cases, the parser may simply return null.
Parse depth. Parses for functions, procedures, packages and package
bodies. Within each type of global declaration, you'll get type
declarations and local variable declarations. You'll also get all the
various control statements in the code blocks: if, loop, while, and for.
You'll get all nested blocks so that you can find all local variables
in the Plsql file. No expression parsing is done and next to no sql
parsing is done.