Skip to content

Commit 3907494

Browse files
hishidamahishidama
committed
Added Oracle COMMENT statement
1 parent de8ad10 commit 3907494

8 files changed

Lines changed: 245 additions & 13 deletions

File tree

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222
package net.sf.jsqlparser.statement;
2323

2424
import net.sf.jsqlparser.statement.alter.Alter;
25+
import net.sf.jsqlparser.statement.comment.Comment;
2526
import net.sf.jsqlparser.statement.create.index.CreateIndex;
2627
import net.sf.jsqlparser.statement.create.table.CreateTable;
2728
import net.sf.jsqlparser.statement.create.view.AlterView;
@@ -39,6 +40,8 @@
3940

4041
public interface StatementVisitor {
4142

43+
void visit(Comment comment);
44+
4245
void visit(Commit commit);
4346

4447
void visit(Delete delete);

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222
package net.sf.jsqlparser.statement;
2323

2424
import net.sf.jsqlparser.statement.alter.Alter;
25+
import net.sf.jsqlparser.statement.comment.Comment;
2526
import net.sf.jsqlparser.statement.create.index.CreateIndex;
2627
import net.sf.jsqlparser.statement.create.table.CreateTable;
2728
import net.sf.jsqlparser.statement.create.view.AlterView;
@@ -39,6 +40,11 @@
3940

4041
public class StatementVisitorAdapter implements StatementVisitor {
4142

43+
@Override
44+
public void visit(Comment comment) {
45+
46+
}
47+
4248
@Override
4349
public void visit(Commit commit) {
4450

‎src/main/java/net/sf/jsqlparser/statement/comment/Comment.java‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
/*
2+
* #%L
3+
* JSQLParser library
4+
* %%
5+
* Copyright (C) 2004 - 2017 JSQLParser
6+
* %%
7+
* This program is free software: you can redistribute it and/or modify
8+
* it under the terms of the GNU Lesser General Public License as
9+
* published by the Free Software Foundation, either version 2.1 of the
10+
* License, or (at your option) any later version.
11+
*
12+
* This program is distributed in the hope that it will be useful,
13+
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14+
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15+
* GNU General Lesser Public License for more details.
16+
*
17+
* You should have received a copy of the GNU General Lesser Public
18+
* License along with this program. If not, see
19+
* <http://www.gnu.org/licenses/lgpl-2.1.html>.
20+
* #L%
21+
*/
22+
package net.sf.jsqlparser.statement.comment;
23+
24+
import net.sf.jsqlparser.expression.StringValue;
25+
import net.sf.jsqlparser.schema.Column;
26+
import net.sf.jsqlparser.schema.Table;
27+
import net.sf.jsqlparser.statement.Statement;
28+
import net.sf.jsqlparser.statement.StatementVisitor;
29+
30+
public class Comment implements Statement {
31+
32+
private Table table;
33+
private Column column;
34+
private StringValue comment;
35+
36+
@Override
37+
public void accept(StatementVisitor statementVisitor) {
38+
statementVisitor.visit(this);
39+
}
40+
41+
public Table getTable() {
42+
return table;
43+
}
44+
45+
public void setTable(Table table) {
46+
this.table = table;
47+
}
48+
49+
public Column getColumn() {
50+
return column;
51+
}
52+
53+
public void setColumn(Column column) {
54+
this.column = column;
55+
}
56+
57+
public StringValue getComment() {
58+
return comment;
59+
}
60+
61+
public void setComment(StringValue comment) {
62+
this.comment = comment;
63+
}
64+
65+
@Override
66+
public String toString() {
67+
String sql = "COMMENT ON ";
68+
if (table != null) {
69+
sql += "TABLE " + table + " ";
70+
} else if (column != null) {
71+
sql += "COLUMN " + column + " ";
72+
}
73+
sql += "IS " + comment;
74+
return sql;
75+
}
76+
}

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323

2424
import java.util.ArrayList;
2525
import java.util.List;
26+
2627
import net.sf.jsqlparser.expression.AllComparisonExpression;
2728
import net.sf.jsqlparser.expression.AnalyticExpression;
2829
import net.sf.jsqlparser.expression.AnyComparisonExpression;
@@ -100,6 +101,7 @@
100101
import net.sf.jsqlparser.statement.Statements;
101102
import net.sf.jsqlparser.statement.UseStatement;
102103
import net.sf.jsqlparser.statement.alter.Alter;
104+
import net.sf.jsqlparser.statement.comment.Comment;
103105
import net.sf.jsqlparser.statement.create.index.CreateIndex;
104106
import net.sf.jsqlparser.statement.create.table.CreateTable;
105107
import net.sf.jsqlparser.statement.create.view.AlterView;
@@ -811,4 +813,17 @@ public void visit(Block block) {
811813
visit(block.getStatements());
812814
}
813815
}
816+
817+
@Override
818+
public void visit(Comment comment) {
819+
if (comment.getTable() != null) {
820+
visit(comment.getTable());
821+
}
822+
if (comment.getColumn() != null) {
823+
Table table = comment.getColumn().getTable();
824+
if (table != null) {
825+
visit(table);
826+
}
827+
}
828+
}
814829
}

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@
3030
import net.sf.jsqlparser.statement.Statements;
3131
import net.sf.jsqlparser.statement.UseStatement;
3232
import net.sf.jsqlparser.statement.alter.Alter;
33+
import net.sf.jsqlparser.statement.comment.Comment;
3334
import net.sf.jsqlparser.statement.create.index.CreateIndex;
3435
import net.sf.jsqlparser.statement.create.table.CreateTable;
3536
import net.sf.jsqlparser.statement.create.view.AlterView;
@@ -240,4 +241,9 @@ public void visit(Block block) {
240241
}
241242
buffer.append("END");
242243
}
244+
245+
@Override
246+
public void visit(Comment comment) {
247+
buffer.append(comment.toString());
248+
}
243249
}

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

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ import net.sf.jsqlparser.expression.operators.relational.*;
7070
import net.sf.jsqlparser.schema.*;
7171
import net.sf.jsqlparser.statement.*;
7272
import net.sf.jsqlparser.statement.alter.*;
73+
import net.sf.jsqlparser.statement.comment.*;
7374
import net.sf.jsqlparser.statement.create.index.*;
7475
import net.sf.jsqlparser.statement.create.table.*;
7576
import net.sf.jsqlparser.statement.create.view.*;
@@ -159,6 +160,7 @@ TOKEN: /* SQL Keywords. prefixed with K_ to avoid name clashes */
159160
| <K_CHAR:"CHAR">
160161
| <K_COLUMN:"COLUMN">
161162
| <K_COMMIT:"COMMIT">
163+
| <K_COMMENT:"COMMENT">
162164
| <K_CONNECT:"CONNECT">
163165
| <K_CONSTRAINT:"CONSTRAINT">
164166
| <K_CREATE:"CREATE">
@@ -416,6 +418,8 @@ Statement SingleStatement() :
416418
stm = Use()
417419
|
418420
stm = Commit()
421+
|
422+
stm = Comment()
419423
)
420424
{ return stm; }
421425
} catch (ParseException e) {
@@ -1014,7 +1018,7 @@ String RelObjectNameWithoutValue() :
10141018
{ Token tk = null; }
10151019
{
10161020
(tk=<S_IDENTIFIER> | tk=<S_QUOTED_IDENTIFIER> | tk=<K_BYTE> | <K_CHAR>
1017-
| tk=<K_CAST> | tk=<K_DO> | tk=<K_EXTRACT> | tk=<K_FIRST> | tk=<K_FOLLOWING>
1021+
| tk=<K_CAST> | tk=<K_COMMENT> | tk=<K_DO> | tk=<K_EXTRACT> | tk=<K_FIRST> | tk=<K_FOLLOWING>
10181022
| tk=<K_LAST> | tk=<K_MATERIALIZED> | tk=<K_NULLS> | tk=<K_PARTITION> | tk=<K_RANGE>
10191023
| tk=<K_ROW> | tk=<K_ROWS> | tk=<K_SIBLINGS> | tk=<K_XML>
10201024
| tk=<K_COLUMN> | tk=<K_REPLACE> | tk=<K_TRUNCATE> | tk=<K_KEY> | tk=<K_ANY>
@@ -3767,3 +3771,27 @@ Commit Commit():
37673771
return commit;
37683772
}
37693773
}
3774+
3775+
Comment Comment():
3776+
{
3777+
Comment result = new Comment();
3778+
Table table;
3779+
Column column;
3780+
Token comment;
3781+
}
3782+
{
3783+
<K_COMMENT> <K_ON>
3784+
(
3785+
(
3786+
<K_TABLE> table = Table() { result.setTable(table); }
3787+
)
3788+
|
3789+
(
3790+
<K_COLUMN> column = Column() { result.setColumn(column); }
3791+
)
3792+
)
3793+
<K_IS> comment=<S_CHAR_LITERAL> { result.setComment(new StringValue(comment.image)); }
3794+
{
3795+
return result;
3796+
}
3797+
}

‎src/test/java/net/sf/jsqlparser/statement/comment/CommentTest.java‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
package net.sf.jsqlparser.statement.comment;
2+
3+
import static net.sf.jsqlparser.test.TestUtils.assertSqlCanBeParsedAndDeparsed;
4+
import static org.junit.Assert.assertEquals;
5+
6+
import java.io.StringReader;
7+
8+
import net.sf.jsqlparser.JSQLParserException;
9+
import net.sf.jsqlparser.parser.CCJSqlParserManager;
10+
import net.sf.jsqlparser.schema.Column;
11+
import net.sf.jsqlparser.schema.Table;
12+
13+
import org.junit.Test;
14+
15+
public class CommentTest {
16+
17+
private final CCJSqlParserManager parserManager = new CCJSqlParserManager();
18+
19+
@Test
20+
public void testCommentTable() throws JSQLParserException {
21+
String statement = "COMMENT ON TABLE table1 IS 'comment1'";
22+
Comment comment = (Comment) parserManager.parse(new StringReader(statement));
23+
Table table = comment.getTable();
24+
assertEquals("table1", table.getName());
25+
assertEquals("comment1", comment.getComment().getValue());
26+
assertEquals(statement, "" + comment);
27+
}
28+
29+
@Test
30+
public void testCommentTable2() throws JSQLParserException {
31+
String statement = "COMMENT ON TABLE schema1.table1 IS 'comment1'";
32+
Comment comment = (Comment) parserManager.parse(new StringReader(statement));
33+
Table table = comment.getTable();
34+
assertEquals("schema1", table.getSchemaName());
35+
assertEquals("table1", table.getName());
36+
assertEquals("comment1", comment.getComment().getValue());
37+
assertEquals(statement, "" + comment);
38+
}
39+
40+
@Test
41+
public void testCommentTableDeparse() throws JSQLParserException {
42+
String statement = "COMMENT ON TABLE table1 IS 'comment1'";
43+
assertSqlCanBeParsedAndDeparsed(statement);
44+
}
45+
46+
@Test
47+
public void testCommentColumn() throws JSQLParserException {
48+
String statement = "COMMENT ON COLUMN table1.column1 IS 'comment1'";
49+
Comment comment = (Comment) parserManager.parse(new StringReader(statement));
50+
Column column = comment.getColumn();
51+
assertEquals("table1", column.getTable().getName());
52+
assertEquals("column1", column.getColumnName());
53+
assertEquals("comment1", comment.getComment().getValue());
54+
assertEquals(statement, "" + comment);
55+
}
56+
57+
@Test
58+
public void testCommentColumnDeparse() throws JSQLParserException {
59+
String statement = "COMMENT ON COLUMN table1.column1 IS 'comment1'";
60+
assertSqlCanBeParsedAndDeparsed(statement);
61+
}
62+
63+
@Test
64+
public void testToString() {
65+
Comment comment = new Comment();
66+
assertEquals("COMMENT ON IS null", comment.toString());
67+
}
68+
}

0 commit comments

Comments
 (0)