Hibernate HQL/JP-QL Parser

Extensible parser for HQL/JP-QL queries

License	GNU Lesser General Public License
Categories	Hibernate Data ORM
GroupId	org.hibernate.hql
ArtifactId	hibernate-hql-parser
Last Version	1.5.0.Final
Release Date	Sep 18, 2017
Type	jar
Description	Hibernate HQL/JP-QL Parser Extensible parser for HQL/JP-QL queries
Project URL	http://ogm.hibernate.org/
Project Organization	Hibernate.org
Source Code Management	http://github.com/hibernate/hibernate-hql-parser

Download hibernate-hql-parser

Filename	Size
hibernate-hql-parser-1.5.0.Final.pom
hibernate-hql-parser-1.5.0.Final.jar	744 KB
hibernate-hql-parser-1.5.0.Final-sources.jar	277 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.hibernate.hql/hibernate-hql-parser/ -->
<dependency>
    <groupId>org.hibernate.hql</groupId>
    <artifactId>hibernate-hql-parser</artifactId>
    <version>1.5.0.Final</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.hibernate.hql/hibernate-hql-parser/
implementation 'org.hibernate.hql:hibernate-hql-parser:1.5.0.Final'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.hibernate.hql/hibernate-hql-parser/
implementation ("org.hibernate.hql:hibernate-hql-parser:1.5.0.Final")

Apache Buildr

'org.hibernate.hql:hibernate-hql-parser:jar:1.5.0.Final'

Apache Ivy

<dependency org="org.hibernate.hql" name="hibernate-hql-parser" rev="1.5.0.Final">
  <artifact name="hibernate-hql-parser" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.hibernate.hql', module='hibernate-hql-parser', version='1.5.0.Final')
)

Scala SBT

libraryDependencies += "org.hibernate.hql" % "hibernate-hql-parser" % "1.5.0.Final"

Leiningen

[org.hibernate.hql/hibernate-hql-parser "1.5.0.Final"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.antlr : antlr-runtime	jar	3.4
org.jboss.logging : jboss-logging	jar	3.1.4.GA

Project Modules

There are no modules declared in this project.

Hibernate Query Parser

Experimental new parser for HQL and JP-QL queries, to convert these into SQL and other different targets such as Lucene queries, Map/Reduce queries for NoSQL stores, make it possible to perform more sophisticated SQL transformations.

Help

There is much to do and many tests to be ported from the existing parser or added from scratch; anyone is welcome to help by sending pull requests, commenting the code on github directly or by by using the mailing list or IRC chat channels:

• Mailing list
• irc://irc.freenode.net/#hibernate

Bug Reports:

• Hibernate JIRA (preferred)
• Mailing list

Building

This project used Gradle as build tool. To build the complete project, run the following command from the directory containing this README file:

./gradlew clean build

You don't need to have Gradle installed; When executed for the first time, gradlew (the "Gradle wrapper") will download Gradle in the required version.

In order to install the JARs created by this project into your local Maven repository, run the following command:

./gradlew clean install

To deploy the modules to the JBoss Maven repository, run:

./gradlew clean publish

Depending on the version of the project (as given via ext.projectVersion) this will perform a deployment either into the JBoss snapshot repository or the JBoss release staging repository (both requires your Nexus credentials to be configured in ~/.m2/settings.xml).

Releasing

Perform the following steps to do a release of this project:

• delete any stale files and directories from your working copy: git clean -d -x -f
• verify that everything builds as expected: ./gradlew clean build
• set project version in build.gradle (property ext.projectVersion) to the release version, e.g. "1.0.0.Alpha3" and commit
• tag the release in Git: git tag -a 1.0.0.Alpha3 -m 'my version 1.0.0.Alpha3'
• perform the release: ./gradlew clean publish
• examine the staged release on the JBoss Nexus server; either close and release or drop the staging repository
• set project version in build.gradle to the next development version, e.g. "1.0.0-SNAPSHOT" and commit
• push the master branches and the new tag to the upstream repo
• release the version in JIRA and transition all involved issues to "Closed"

Source and credits

The grammar and parser code is based on the antlr3 branch previously developed for Hibernate 3; the original code by Steve Ebersole and Alexandre Porcelli can be found on the archived Hibernate subversion repository.

License

This software and its documentation are distributed under the terms of the FSF Lesser GNU Public License (see license.txt).

Hibernate

Versions

Version
1.5.0.Final Sep 18, 2017
1.4.0.Final Feb 14, 2017
1.4.0.Beta1 Feb 1, 2017
1.3.0.Final Aug 9, 2016
1.3.0.Alpha2 Aug 25, 2015
1.3.0.Alpha1 Jul 22, 2015
1.2.2.Final Sep 3, 2015
1.2.1.Final Jul 2, 2015
1.2.0.Final May 19, 2015
1.2.0.Alpha2 May 6, 2015
1.2.0.Alpha1 Mar 12, 2015
1.1.2.Final Aug 25, 2015
1.1.1.Final Jul 2, 2015
1.1.0.Final Dec 16, 2014
1.1.0.Beta1 Nov 21, 2014
1.1.0.Alpha3 Jul 4, 2014
1.1.0.Alpha2 May 21, 2014
1.1.0.Alpha1 May 20, 2014
1.0.3.Final Aug 25, 2015
1.0.2.Final Aug 8, 2015
1.0.1.Final Jul 2, 2015
1.0.0.Final Jul 2, 2015
1.0.0.CR2 Jul 4, 2014
1.0.0.CR1 May 15, 2014
1.0.0.Alpha7 Feb 15, 2014
1.0.0.Alpha6 Jan 24, 2014
1.0.0.Alpha5 Oct 2, 2013
1.0.0.Alpha4 Sep 27, 2013
1.0.0.Alpha3 Aug 13, 2013
1.0.0.Alpha2 Aug 1, 2013