Add show tables support (#1015)

* visual

* implement show tables

Co-authored-by: Jan Monterrubio <Jan.Monterrubio@Cerner.com>

Author: AnEmortalKid

src/main/java/net/sf/jsqlparser/statement/StatementVisitor.java

@@ -26,6 +26,7 @@
 import net.sf.jsqlparser.statement.merge.Merge;
 import net.sf.jsqlparser.statement.replace.Replace;
 import net.sf.jsqlparser.statement.select.Select;
+import net.sf.jsqlparser.statement.show.ShowTablesStatement;
 import net.sf.jsqlparser.statement.truncate.Truncate;
 import net.sf.jsqlparser.statement.update.Update;
 import net.sf.jsqlparser.statement.upsert.Upsert;
@@ -69,6 +70,8 @@ public interface StatementVisitor {
 
     void visit(ShowColumnsStatement set);
 
+    void visit(ShowTablesStatement showTables);
+
     void visit(Merge merge);
 
     void visit(Select select);

src/main/java/net/sf/jsqlparser/statement/StatementVisitorAdapter.java

@@ -26,6 +26,7 @@
 import net.sf.jsqlparser.statement.merge.Merge;
 import net.sf.jsqlparser.statement.replace.Replace;
 import net.sf.jsqlparser.statement.select.Select;
+import net.sf.jsqlparser.statement.show.ShowTablesStatement;
 import net.sf.jsqlparser.statement.truncate.Truncate;
 import net.sf.jsqlparser.statement.update.Update;
 import net.sf.jsqlparser.statement.upsert.Upsert;
@@ -119,10 +120,6 @@ public void visit(SetStatement set) {
 
     }
 
-    @Override
-    public void visit(ShowColumnsStatement set) {
-    }
-
     @Override
     public void visit(Merge merge) {
 
@@ -160,6 +157,14 @@ public void visit(ExplainStatement aThis) {
     public void visit(ShowStatement aThis) {
     }
 
+    @Override
+    public void visit(ShowColumnsStatement set) {
+    }
+
+    @Override
+    public void visit(ShowTablesStatement showTables) {
+    }
+
     @Override
     public void visit(DeclareStatement aThis) {
     }

src/main/java/net/sf/jsqlparser/statement/show/ShowTablesStatement.java

@@ -0,0 +1,111 @@
+/*-
+ * #%L
+ * JSQLParser library
+ * %%
+ * Copyright (C) 2004 - 2020 JSQLParser
+ * %%
+ * Dual licensed under GNU LGPL 2.1 or Apache License 2.0
+ * #L%
+ */
+package net.sf.jsqlparser.statement.show;
+
+import net.sf.jsqlparser.expression.Expression;
+import net.sf.jsqlparser.statement.Statement;
+import net.sf.jsqlparser.statement.StatementVisitor;
+
+import java.util.EnumSet;
+
+/**
+ * A {@code SHOW TABLES} statement
+ * @see <a href="https://dev.mysql.com/doc/refman/8.0/en/show-tables.html">MySQL show tables</a>
+ */
+public class ShowTablesStatement implements Statement {
+
+    private EnumSet<Modifiers> modifiers;
+    private SelectionMode selectionMode;
+    private String dbName;
+    private Expression likeExpression;
+    private Expression whereCondition;
+
+    public EnumSet<Modifiers> getModifiers() {
+        return modifiers;
+    }
+
+    public void setModifiers(EnumSet<Modifiers> modifiers) {
+        this.modifiers = modifiers;
+    }
+
+    public SelectionMode getSelectionMode() {
+        return selectionMode;
+    }
+
+    public void setSelectionMode(SelectionMode selectionMode) {
+        this.selectionMode = selectionMode;
+    }
+
+    public String getDbName() {
+        return dbName;
+    }
+
+    public void setDbName(String dbName) {
+        this.dbName = dbName;
+    }
+
+    public Expression getLikeExpression() {
+        return likeExpression;
+    }
+
+    public void setLikeExpression(Expression likeExpression) {
+        this.likeExpression = likeExpression;
+    }
+
+    public Expression getWhereCondition() {
+        return whereCondition;
+    }
+
+    public void setWhereCondition(Expression whereCondition) {
+        this.whereCondition = whereCondition;
+    }
+
+    @Override
+    public String toString() {
+        StringBuilder builder = new StringBuilder();
+        builder.append("SHOW");
+
+        if (modifiers.contains(Modifiers.EXTENDED)) {
+            builder.append(" EXTENDED");
+        }
+        if (modifiers.contains(Modifiers.FULL)) {
+            builder.append(" FULL");
+        }
+
+        builder.append(" TABLES");
+
+        if (dbName != null) {
+            builder.append(" ").append(selectionMode.name()).append(" ").append(dbName);
+        }
+
+        if (likeExpression != null) {
+            builder.append(" ").append("LIKE").append(" ").append(likeExpression);
+        }
+
+        if (whereCondition != null) {
+            builder.append(" ").append("WHERE").append(" ").append(whereCondition);
+        }
+
+        return builder.toString();
+    }
+
+    @Override
+    public void accept(StatementVisitor statementVisitor) {
+        statementVisitor.visit(this);
+    }
+
+    public enum SelectionMode {
+        FROM, IN
+    }
+
+    public enum Modifiers {
+        EXTENDED, FULL
+    }
+}

src/main/java/net/sf/jsqlparser/util/TablesNamesFinder.java

@@ -92,6 +92,7 @@
 import net.sf.jsqlparser.statement.select.TableFunction;
 import net.sf.jsqlparser.statement.select.ValuesList;
 import net.sf.jsqlparser.statement.select.WithItem;
+import net.sf.jsqlparser.statement.show.ShowTablesStatement;
 import net.sf.jsqlparser.statement.truncate.Truncate;
 import net.sf.jsqlparser.statement.update.Update;
 import net.sf.jsqlparser.statement.upsert.Upsert;
@@ -879,4 +880,9 @@ public void visit(AlterSequence alterSequence) {
     public void visit(CreateFunctionalStatement createFunctionalStatement) {
         throw new UnsupportedOperationException("Finding tables from CreateFunctionalStatement is not supported");
     }
+
+    @Override
+    public void visit(ShowTablesStatement showTables) {
+        throw new UnsupportedOperationException("Finding tables from ShowTablesStatement is not supported");
+    }
 }

src/main/java/net/sf/jsqlparser/util/deparser/ShowTablesStatementDeparser.java

@@ -0,0 +1,24 @@
+/*-
+ * #%L
+ * JSQLParser library
+ * %%
+ * Copyright (C) 2004 - 2020 JSQLParser
+ * %%
+ * Dual licensed under GNU LGPL 2.1 or Apache License 2.0
+ * #L%
+ */
+package net.sf.jsqlparser.util.deparser;
+
+import net.sf.jsqlparser.statement.show.ShowTablesStatement;
+
+public class ShowTablesStatementDeparser extends AbstractDeParser<ShowTablesStatement> {
+
+    public ShowTablesStatementDeparser(StringBuilder buffer) {
+        super(buffer);
+    }
+
+    @Override
+    void deParse(ShowTablesStatement statement) {
+        buffer.append(statement);
+    }
+}

src/main/java/net/sf/jsqlparser/util/deparser/StatementDeParser.java

@@ -43,6 +43,7 @@
 import net.sf.jsqlparser.statement.replace.Replace;
 import net.sf.jsqlparser.statement.select.Select;
 import net.sf.jsqlparser.statement.select.WithItem;
+import net.sf.jsqlparser.statement.show.ShowTablesStatement;
 import net.sf.jsqlparser.statement.truncate.Truncate;
 import net.sf.jsqlparser.statement.update.Update;
 import net.sf.jsqlparser.statement.upsert.Upsert;
@@ -227,6 +228,11 @@ public void visit(ShowColumnsStatement show) {
         new ShowColumnsStatementDeParser(buffer).deParse(show);
     }
 
+    @Override
+    public void visit(ShowTablesStatement showTables) {
+        new ShowTablesStatementDeparser(buffer).deParse(showTables);
+    }
+
     @Override
     public void visit(Block block) {
         buffer.append("BEGIN\n");

src/main/jjtree/net/sf/jsqlparser/parser/JSqlParserCC.jjt

@@ -52,6 +52,7 @@ import net.sf.jsqlparser.statement.insert.*;
 import net.sf.jsqlparser.statement.replace.*;
 import net.sf.jsqlparser.statement.execute.*;
 import net.sf.jsqlparser.statement.select.*;
+import net.sf.jsqlparser.statement.show.*;
 import net.sf.jsqlparser.statement.truncate.*;
 import net.sf.jsqlparser.statement.update.*;
 import net.sf.jsqlparser.statement.upsert.*;
@@ -188,6 +189,7 @@ TOKEN: /* SQL Keywords. prefixed with K_ to avoid name clashes */
 |   <K_EXECUTE: "EXECUTE">
 |   <K_EXISTS:"EXISTS">
 |   <K_EXPLAIN:"EXPLAIN">
+|   <K_EXTENDED:"EXTENDED">
 |   <K_EXTRACT:"EXTRACT">
 |   <K_FETCH:"FETCH">
 |   <K_FILTER: "FILTER">
@@ -313,6 +315,7 @@ TOKEN: /* SQL Keywords. prefixed with K_ to avoid name clashes */
 |   <K_SOME:"SOME">
 |   <K_START:"START">
 |   <K_TABLE:"TABLE">
+|   <K_TABLES:"TABLES">
 |   <K_TABLESPACE : "TABLESPACE">
 |   <K_THEN:"THEN">
 |   <K_TEMP:"TEMP">
@@ -494,7 +497,11 @@ Statement SingleStatement() :
         |
         stm = Set()
         |
-        LOOKAHEAD(2) stm = ShowColumns()
+        LOOKAHEAD(ShowColumns())
+        stm = ShowColumns()
+        |
+        LOOKAHEAD(ShowTables())
+        stm = ShowTables()
         |
         stm = Show()
         |
@@ -773,6 +780,39 @@ ShowColumnsStatement ShowColumns(): {
     }
 }
 
+// https://dev.mysql.com/doc/refman/8.0/en/show-tables.html
+ShowTablesStatement ShowTables(): {
+    ShowTablesStatement showTablesStatement;
+    EnumSet<ShowTablesStatement.Modifiers> modifiers =  EnumSet.noneOf(ShowTablesStatement.Modifiers.class);
+    ShowTablesStatement.SelectionMode selectionMode = null;
+    String dbName = null;
+    Expression likeExpression = null;
+    Expression whereCondition = null;
+}
+{
+  <K_SHOW>
+  [ <K_EXTENDED> { modifiers.add(ShowTablesStatement.Modifiers.EXTENDED); } ]
+  [ <K_FULL> { modifiers.add(ShowTablesStatement.Modifiers.FULL); } ]
+  <K_TABLES>
+  [
+    (
+      <K_FROM> {selectionMode = ShowTablesStatement.SelectionMode.FROM; }
+    | <K_IN> { selectionMode = ShowTablesStatement.SelectionMode.IN; }
+    )
+    dbName = RelObjectNameExt()
+  ]
+  [ (<K_LIKE> likeExpression = SimpleExpression() | <K_WHERE> whereCondition = Expression()) ]
+  {
+    showTablesStatement = new ShowTablesStatement();
+    showTablesStatement.setModifiers(modifiers);
+    showTablesStatement.setSelectionMode(selectionMode);
+    showTablesStatement.setDbName(dbName);
+    showTablesStatement.setLikeExpression(likeExpression);
+    showTablesStatement.setWhereCondition(whereCondition);
+    return showTablesStatement;
+  }
+}
+
 ShowStatement Show(): {
     String name;
 }
@@ -1299,7 +1339,7 @@ String RelObjectName() :
 {    Token tk = null; String result = null; }
 {
     (result = RelObjectNameWithoutValue()
-		| tk=<K_GROUP> | tk=<K_INTERVAL> | tk=<K_ON> | tk=<K_ORDER> | tk=<K_START> | tk=<K_TOP> | tk=<K_VALUE> | tk=<K_VALUES> | tk=<K_CREATE> )
+		| tk=<K_GROUP> | tk=<K_INTERVAL> | tk=<K_ON> | tk=<K_ORDER> | tk=<K_START> | tk=<K_TOP> | tk=<K_VALUE> | tk=<K_VALUES> | tk=<K_CREATE> | tk=<K_TABLES> )
 
     {
 		if (tk!=null) result=tk.image;

src/test/java/net/sf/jsqlparser/statement/show/ShowTablesStatementTest.java

@@ -0,0 +1,47 @@
+/*-
+ * #%L
+ * JSQLParser library
+ * %%
+ * Copyright (C) 2004 - 2020 JSQLParser
+ * %%
+ * Dual licensed under GNU LGPL 2.1 or Apache License 2.0
+ * #L%
+ */
+package net.sf.jsqlparser.statement.show;
+
+import org.junit.Test;
+
+import static net.sf.jsqlparser.test.TestUtils.assertSqlCanBeParsedAndDeparsed;
+
+public class ShowTablesStatementTest {
+
+    @Test
+    public void showTables() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW TABLES");
+    }
+
+    @Test
+    public void showTablesModifiers() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW EXTENDED FULL TABLES");
+    }
+
+    @Test
+    public void showTablesFromDbName() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW EXTENDED TABLES FROM db_name");
+    }
+
+    @Test
+    public void showTablesInDbName() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW FULL TABLES IN db_name");
+    }
+
+    @Test
+    public void showTablesLikeExpression() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW TABLES LIKE '%FOO%'");
+    }
+
+    @Test
+    public void showTablesWhereExpression() throws Exception {
+        assertSqlCanBeParsedAndDeparsed("SHOW TABLES WHERE table_name = 'FOO'");
+    }
+}