+0
日增长
4,969
stars
878
forks
152
watchers
1,853
prs
2,054
issues
35
releases
README
Querydsl
Querydsl is a framework which enables the construction of type-safe SQL-like queries for multiple backends including JPA, MongoDB and SQL in Java.
Instead of writing queries as inline strings or externalizing them into XML files they are constructed via a fluent API.
Getting started
Use these tutorials to get started
Querying JPA
Querying SQL
Querying Mongodb
Querying Lucene
Querying Collections
Querydsl Spatial
Querying JDO
Examples
Querydsl example projects
Support
Free support is provided in the Discussion Section and on StackOverflow.
Please do not post questions as issue. Such issues will be closed immediately.
How to build
Querydsl provides releases via public Maven repositories, but you can also build the sources yourself like this
BASH
$ mvn -Pquickbuild,{projectname} clean install
Where projectname is one of the Maven profiles (e.g. jpa, sql, mongodb, etc. or all)
For more information visit the project homepage at https://querydsl.github.io.
Docker Compose setup
For running tests, a Docker Compose setup is provided. It comes with the following databases:
Oracle Express Edition 11g
PostgreSQL 9.1.10
MySQL 5.5.34
Cubrid 9.2
You will need to install [Docker] and [docker-compose].
To launch the database containers:
BASH
$ docker-compose up -d
All of the databases' default ports are forwarded to the host machine.
How to contribute
GitHub pull requests are the way to contribute to Querydsl.
If you are unsure about the details of a contribution, ask on the Querydsl Google Group or create a ticket on GitHub.
[Docker]: https://www.docker.com/products/docker-desktop
[docker-compose]: https://docs.docker.com/compose/
Slack
If you want to join Slack workspace for Querydsl contributors join by following this link.Top issues
#3201apt-maven-plugin alternatives19 comments · 2022-03-11#3655Q classes not generated with Java 2115 comments · 2023-12-27#3281[ERROR] Failed to execute goal com.querydsl:querydsl-maven-plugin:5.0.0:export (default) on project my-project: Stream has already been closed9 comments · 2022-05-31#3929Query dsl 5.0.0 Q classes not generating4 comments · 2025-11-12#3819ScrollableResultsIterator causes error with hibernate 63 comments · 2025-02-26#3897fetchAll() with hibernate 62 comments · 2025-09-12#3957`GroupByList` and `GroupByGenericCollection` don't close CloseableIterator on exception (GroupByMap does)1 comments · 2026-03-24#3956Security: CVE-2024-49203 affects querydsl-jpa 5.1.01 comments · 2026-02-19
Discussions
#3988Request for a published OpenPGP signing-key statement for Querydsl POMs on Maven Central0 comments · 2026-11-03#3987Is this project dead ?1 comments · 2026-10-26#3985QueryDSL 7.5 MavenCentral0 comments · 2026-07-23#3930Retrieve IDENTITY column value after INSERT with Oracle Database0 comments · 2025-11-12#3928QueryDsl & Lombok, MapStruct - is not working in Spring boot 3.5.7 and Java 213 comments · 2025-11-11#3914Where to find documentation with usage of maven-compiler-plugin instead of apt-maven-plugin0 comments · 2025-10-07#3885Fail on generating the querydsl metamodel with java 21 and querydsl 5.1.0 with a @MappedSuperclass that have a validation annotation0 comments · 2025-08-03#3865Feat. (OpenFeign)Query DSL supports for Hibernate 6 Windows Function in JPAQueries1 comments · 2025-06-11
Latest release
5.1.0 QUERYDSL_5_1_0 2024-01-29What's Changed Bump jcc from 11.5.5.0 to 11.5.6.0 by @dependabot in https://github.com/querydsl/querydsl/pull/2956 Bump classgraph from 4.8.108 to 4.8.110 by @dependabot in https://github.com/querydsl/querydsl/pull/2959 Bump postgresql from 42.2.22 to 42.2.23 by @dependabot in https://github.com/querydsl/querydsl/pull/2960 Bump dokka-maven-plugin from 1.4.32 to 1.5.0 by @dependabot in https://github.com/querydsl/querydsl/pull/2961 Bump spring-jdbc from 5.3.8 to 5.3.9 by @dependabot in https://github.com/querydsl/querydsl/pull/2966 Bump ant from 1.10.10 to 1.10.11 by @dependabot in