GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - reference-project/JSqlParser: JSqlParser parses an SQL statement and translate it into a hierarchy of Java classes. The generated hierarchy can be navigated using the Visitor Pattern

BranchesTags
Open more actions menu
 
 

Latest commit

 

History

1,502 Commits
1,502 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
src
src
 
 
.gitignore
.gitignore
 
 
.travis.yml
.travis.yml
 
 
LICENSE_APACHEV2
LICENSE_APACHEV2
 
 
LICENSE_LGPLV21
LICENSE_LGPLV21
 
 
README.md
README.md
 
 
nb-configuration.xml
nb-configuration.xml
 
 
nbactions.xml
nbactions.xml
 
 
pom.xml
pom.xml
 
 

Repository files navigation

JSqlParser

Build Status Coverage Status Codacy Badge Maven Central Javadocs

Gitter Code Quality: Java Total Alerts

Look here for more information and examples: https://github.com/JSQLParser/JSqlParser/wiki.

License

JSqlParser is dual licensed under LGPL V2.1 or Apache Software License, Version 2.0.

Discussion

Please provide feedback on:

  • API changes: extend visitor with return values (JSQLParser#901)

News

  • 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
  • Released version 2.1 of JSqlParser
  • Released version 2.0 of JSqlParser
  • breaking API change: to support chained functions attribute type was changed to Expression
  • Released version 1.4 of JSqlParser
  • Released version 1.3 of JSqlParser
  • Changed behaviour of dotted multipart names for user variables, tables and columns to accept e.g. ORM class names. To achieve this some behaviour of name parsing had to be changed. Before this the parser would fail missing databasenames for SqlServer queries (server..schema.table). But this is allowed for the schema (server.database..table). Now the parser accepts missing inner names per se to avoid some very complicated parsing rules.
  • Released version 1.2 of JSqlParser
  • breaking API change: merge of within group and over (window expressions)
  • Released version 1.1 of JSqlParser.
  • JSqlParser has now a build in checkstyle configuration to introduce source code conventions.
  • Released first major version 1.0 of JSqlParser.

More news can be found here: https://github.com/JSQLParser/JSqlParser/wiki/News.

Alternatives to JSqlParser?

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

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.

Support

If you need help using JSqlParser feel free to file an issue or contact me.

Contributions

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.

Extensions in the latest SNAPSHOT version 4.0

  • support for CREATE OR REPLACE for create function statements
  • support for JDBCParameter for interval expressions
  • support for xmlserialize(xmlagg(xmltext( ) ORDER BY ) as ) expression
  • first try to support conditions as select items: SELECT a < b
  • support for DROP SEQUENCE
  • heavy updating of many class files to support fluent like class building and setting of attributes (thx to @gitmotte) ** update version to 4.0-SNAPSHOT due fluent PR
  • ON UPDATE CASCADE implemented
  • add generated sources to classpath to avoid maven eclipse problems
  • COMMENT ON VIEW implemented
  • allowed Jdbc named parameters within interval expressions
  • allow variable assignments in select statements in different positions
  • allow keywords as object names of, exclude
  • multi part Table name gets automatically resized if the last item is removed
  • first version of a validation framework for sql statements (thx to @gitmotte)

Extensions of JSqlParser releases

  • Release Notes
  • Modifications before GitHub's release tagging are listed in the Older Releases page.

Building from the sources

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.

Debugging through problems

Refer to the Visualize Parsing section to learn how to run the parser in debug mode.

Source Code conventions

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

Maven Repository

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>3.1</version>
</dependency>

About

JSqlParser parses an SQL statement and translate it into a hierarchy of Java classes. The generated hierarchy can be navigated using the Visitor Pattern

github.com/JSQLParser/JSqlParser/wiki

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.