Look here for more information and examples: https://github.com/JSQLParser/JSqlParser/wiki.
JSqlParser is dual licensed under LGPL V2.1 or Apache Software License, Version 2.0.
Please provide feedback on:
- API changes: extend visitor with return values (JSQLParser#901)
- Released version 4.0 of JSqlParser
- Released version 3.2 of JSqlParser
- Released version 3.1 of JSqlParser
- Released version 3.0 of JSqlParser
- The array parsing is the default behaviour. Square bracket quotation has to be enabled using a parser flag (CCJSqlParser.withSquareBracketQuotation).
- due to an API change the version will be 3.0
- JSqlParser uses now Java 8 at the minimum
More news can be found here: https://github.com/JSQLParser/JSqlParser/wiki/News.
General SQL Parser looks pretty good, with extended SQL syntax (like PL/SQL and T-SQL) and java + .NET APIs. The tool is commercial (license available online), with a free download option.
JSqlParser is a SQL statement parser. It translates SQLs in a traversable hierarchy of Java classes. JSqlParser is not limited to one database but provides support for a lot of specials of Oracle, SqlServer, MySQL, PostgreSQL ... To name some, it has support for Oracles join syntax using (+), PostgreSQLs cast syntax using ::, relational operators like != and so on.
If you need help using JSqlParser feel free to file an issue or contact me.
To help JSqlParser's development you are encouraged to provide
- feedback
- bugreports
- pull requests for new features
- improvement requests
- fund new features or sponsor JSqlParser (Sponsor)
Please write in English, since it's the language most of the dev team knows.
Also I would like to know about needed examples or documentation stuff.
- support for with (ctl) for delete, update and merge
- introduce a max depth to allow parsing complex expression lists without performance loss (thx to @manticore-projects)
- allow all functions to have complex expressions as parameters (thx to @manticore-projects) ** API change FunctionWithCondParams production removed
- API change in ValuesStatement: the expression list is now hold as a ItemList and not as a List
- support for parser modification within parseExpression and parseCondExpression
- support for table schema for foreign keys
- support for Oracle hints on insert, update and merge
- support for merge insert where clause
- allow in as schema name
- allow skip, algorithm as column name
- support for functions in an interval expression
- subArray support arr[1:3]
- first support for tuples as simple expression SELECT myfunc((f1, f2))
- support for array constructors array[[1, 2], [id1, id2]]
- added support for NOT in MySqls REGEXP clause
- added support for WITH mytble as ( .. ) INSERT INTO ...
- added support for H2 casewhen function with conditional parameters
- Release Notes
- Modifications before GitHub's release tagging are listed in the Older Releases page.
As the project is a Maven project, building is rather simple by running:
mvn package
The project requires the following to build:
- Maven
- JDK 8 or later. The jar will target JDK 8, but the version of the maven-compiler-plugin that JsqlParser uses requires JDK 8+
This will produce the jsqlparser-VERSION.jar file in the target/ directory.
To build this project without using Maven, one has to build the parser by JavaCC using the CLI options it provides.
Refer to the Visualize Parsing section to learn how to run the parser in debug mode.
Recently a checkstyle process was integrated into the build process. JSqlParser follows the sun java format convention. There are no TABs allowed. Use spaces.
public void setUsingSelect(SubSelect usingSelect) {
this.usingSelect = usingSelect;
if (this.usingSelect != null) {
this.usingSelect.setUseBrackets(false);
}
}This is a valid piece of source code:
- blocks without braces are not allowed
- after control statements (if, while, for) a whitespace is expected
- the opening brace should be in the same line as the control statement
JSQLParser is deployed at sonatypes open source maven repository. Starting from now I will deploy there. The first snapshot version there will be 0.8.5-SNAPSHOT. To use it this is the repository configuration:
<repositories>
<repository>
<id>jsqlparser-snapshots</id>
<snapshots>
<enabled>true</enabled>
</snapshots>
<url>https://oss.sonatype.org/content/groups/public/</url>
</repository>
</repositories>This repositories releases will be synched to maven central. Snapshots remain at sonatype.
And this is the dependency declaration in your pom:
<dependency>
<groupId>com.github.jsqlparser</groupId>
<artifactId>jsqlparser</artifactId>
<version>4.0</version>
</dependency>