From 9af3aeecc905bd084e74570b7c3369c6b0ab4bf4 Mon Sep 17 00:00:00 2001
From: lukaseder <lukas.eder@gmail.com>
Date: Mon, 11 Dec 2017 11:38:35 +0100
Subject: [PATCH] [#6898] Parser API doesn't document thrown ParserException

---
 jOOQ/src/main/java/org/jooq/Parser.java | 50 +++++++++++++++++--------
 1 file changed, 34 insertions(+), 16 deletions(-)

diff --git a/jOOQ/src/main/java/org/jooq/Parser.java b/jOOQ/src/main/java/org/jooq/Parser.java
index d868287743..baefe5e209 100644
--- a/jOOQ/src/main/java/org/jooq/Parser.java
+++ b/jOOQ/src/main/java/org/jooq/Parser.java
@@ -37,6 +37,8 @@
  */
 package org.jooq;
 
+import org.jooq.impl.ParserException;
+
 /**
  * This is experimental functionality.
  * <p>
@@ -51,151 +53,167 @@ public interface Parser {
      * Parse a SQL string to a set of queries.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Queries parse(String sql);
+    Queries parse(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a set of queries.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Queries parse(String sql, Object... bindings);
+    Queries parse(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a query.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Query parseQuery(String sql);
+    Query parseQuery(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a query.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Query parseQuery(String sql, Object... bindings);
+    Query parseQuery(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a result query.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    ResultQuery<?> parseResultQuery(String sql);
+    ResultQuery<?> parseResultQuery(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a result query.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    ResultQuery<?> parseResultQuery(String sql, Object... bindings);
+    ResultQuery<?> parseResultQuery(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a table.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Table<?> parseTable(String sql);
+    Table<?> parseTable(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a table.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Table<?> parseTable(String sql, Object... bindings);
+    Table<?> parseTable(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a field.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Field<?> parseField(String sql);
+    Field<?> parseField(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a field.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Field<?> parseField(String sql, Object... bindings);
+    Field<?> parseField(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a row.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Row parseRow(String sql);
+    Row parseRow(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a row.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Row parseRow(String sql, Object... bindings);
+    Row parseRow(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a condition.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Condition parseCondition(String sql);
+    Condition parseCondition(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a condition.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Condition parseCondition(String sql, Object... bindings);
+    Condition parseCondition(String sql, Object... bindings) throws ParserException;
 
     /**
      * Parse a SQL string to a name.
      *
      * @param sql The SQL string
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Name parseName(String sql);
+    Name parseName(String sql) throws ParserException;
 
     /**
      * Parse a SQL string with bind variables to a name.
      *
      * @param sql The SQL string
      * @param bindings The bind variables
+     * @throws ParserException If the SQL string could not be parsed.
      */
     @Support
     @PlainSQL
-    Name parseName(String sql, Object... bindings);
+    Name parseName(String sql, Object... bindings) throws ParserException;
 }