3.x Documentation

Version Javadoc Manual
3.1.0 HTML HTML HTML (multi-page) PDF
3.0.0 HTML HTML HTML (multi-page) PDF

2.x Documentation

Version Javadoc Manual
2.6.0 HTML HTML HTML (multi-page) PDF
2.5.0 HTML HTML HTML (multi-page) PDF
2.4.0 HTML HTML HTML (multi-page) PDF
2.3.0 HTML
2.2.0 HTML
2.1.0 HTML
2.0.0 HTML

FAQ

Before you go on and read the whole manual, there are a couple of interesting questions that you might want to consider:

Q: When I generate source code from MySQL, can I also use it on another database?
A: Yes! The generated Java code will work for all supported databases, not only for the database driver that you used when you generated the code.

Q: When I generate source code from my developer database, can I also use it on production?
A: Yes! You can map your schema at code generation time or at run time. See the manual for details.

Q: Can I use jOOQ without code generation?
A: Yes! You can define tables, fields, conditions using Strings. See the manual for details.

Q: Can I use jOOQ as a query builder and execute queries with Spring?
A: Yes! This has been done by other users and will be documented soon. See this Stack Overflow question for details.

Tutorial

Your simplest entry point is probably to get the tutorial running. It shows how to use jOOQ and its code generator with a simple MySQL database

Book Recommendation

With jOOQ, you will write a lot of SQL. Knowing SQL well is important. We highly recommend you read this book to write high-performing SQL:

SQL Performance Explained by Markus Winand, author of Use-The-Index-Luke.com Markus Winand is the author of the popular website Use-The-Index-Luke.com. His book explains nicely how to achieve proper indexing and performance in popular RDBMS:

Author Markus Winand
Title SQL Performance Explained
Available in English, German, French


Read this book when writing SQL with jOOQ!

Further readings