【jOOQ中文】1. 七个步骤快速入门

sihai 发布于2019-08-15 11:04 / 2311人阅读

摘要：关于是一个基于编写的工具包，具有简单轻量函数式编程写等独特优势，非常适合敏捷快速迭代开发。三代码生成在这一步中，我们将使用的命令行工具生成映射到表的类。注意不会主动关闭连接，需要我们手动关闭。

关于jOOQ

jOOQ: The easiest way to write SQL in Java

jOOQ是一个基于Java编写SQL的工具包，具有：简单、轻量、函数式编程写SQL等独特优势，非常适合敏捷快速迭代开发。

初见jOOQ

使用jOOQ，SQL看起来好像是由Java原生支持的，保留SQL原有的简单。

SQL语句：

SELECT AUTHOR.FIRST_NAME, AUTHOR.LAST_NAME, COUNT(*)
    FROM AUTHOR
    JOIN BOOK ON AUTHOR.ID = BOOK.AUTHOR_ID
   WHERE BOOK.LANGUAGE = "DE"
     AND BOOK.PUBLISHED > DATE "2008-01-01"
GROUP BY AUTHOR.FIRST_NAME, AUTHOR.LAST_NAME
  HAVING COUNT(*) > 5
ORDER BY AUTHOR.LAST_NAME ASC NULLS FIRST
   LIMIT 2
  OFFSET 1

Java代码：

create.select(AUTHOR.FIRST_NAME, AUTHOR.LAST_NAME, count())
      .from(AUTHOR)
      .join(BOOK).on(AUTHOR.ID.equal(BOOK.AUTHOR_ID))
      .where(BOOK.LANGUAGE.eq("DE"))
      .and(BOOK.PUBLISHED.gt(date("2008-01-01")))
      .groupBy(AUTHOR.FIRST_NAME, AUTHOR.LAST_NAME)
      .having(count().gt(5))
      .orderBy(AUTHOR.LAST_NAME.asc().nullsFirst())
      .limit(2)
      .offset(1)

一、准备

如果还没有下载，请下载jOOQ：
http://www.jooq.org/download
或者，可是使用Maven：


  org.jooq
  jooq
  3.9.5


  org.jooq
  jooq-meta
  3.9.5


  org.jooq
  jooq-codegen
  3.9.5

二、创建数据库

我们要创建一个名为library的数据库，和一个author表，在表中插入zhang3,li4数据。

CREATE DATABASE `library`;

USE `library`;

CREATE TABLE `author` (
  `id` int NOT NULL,
  `first_name` varchar(255) DEFAULT NULL,
  `last_name` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
);

INSERT INTO `author` (`id`, `first_name`, `last_name`) VALUES ("1", "3", "zhang"), ("2", "4", "li");

三、代码生成

在这一步中，我们将使用jOOQ的命令行工具生成映射到author表的Java类。
有关jOOQ代码生成器的更详细信息，请参见：
jOOQ manual pages about setting up the code generator
代码生成的最简单的方法是将jOOQ的3个jar文件和MySQL Connector jar文件复制到一个临时目录（本示例中目录是test-generated），然后创建一个如下所示的library.xml（名字随意修改）：



  
  
    com.mysql.jdbc.Driver
    
    jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=UTF-8
    
    root
    
    123456
  

  
    
    org.jooq.util.JavaGenerator

    
      
      org.jooq.util.mysql.MySQLDatabase

      
      library

      
      .*

      
      
    

    
      
      
      test.generated

      
      
      C:/workspace/jOOQ-User-Manual/jooq-tutorials-1/src/main/java

在Windows中，cd到test-generated目录，执行以下命令：

注意jar包的版本号与您本地对应上，在这个例子中，jOOQ使用3.9.5，MySQL使用5.1.30。

java -classpath jooq-3.9.5.jar;jooq-meta-3.9.5.jar;jooq-codegen-3.9.5.jar;mysql-connector-java-5.1.30.jar; org.jooq.util.GenerationTool library.xml

UNIX / Linux / Mac中：

java -classpath jooq-3.9.5.jar:jooq-meta-3.9.5.jar:jooq-codegen-3.9.5.jar:mysql-connector-java-5.1.30.jar: org.jooq.util.GenerationTool library.xml

如果一切正常，您应该在控制台输出中看到这些信息：

七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: Initialising properties  : library.xml
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: No  was provided. Generating ALL available catalogs instead.
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: License parameters
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息:   Thank you for using jOOQ and jOOQ"s code generator
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: Database parameters
七月 30, 2017 1:12:51 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   dialect                : MYSQL
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   URL                    : jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=UTF-8
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   target dir             : C:/workspace/jOOQ-User-Manual/jooq-tutorials-1/src/main/java
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   target package         : test.generated
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   includes               : [.*]
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   excludes               : []
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   includeExcludeColumns  : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: JavaGenerator parameters
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   strategy               : class org.jooq.util.DefaultGeneratorStrategy
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   deprecated             : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   generated annotation   : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   JPA annotations        : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   validation annotations : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   instance fields        : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   sequences              : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   udts                   : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   routines               : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   tables                 : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   records                : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   pojos                  : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   immutable pojos        : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   interfaces             : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   immutable interfaces   : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   daos                   : false
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   relations              : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   table-valued functions : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:   global references      : true
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generation remarks
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating catalogs      : Total: 1
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@  @@        @@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@        @@@@@@@@@@
@@@@@@@@@@@@@@@@  @@  @@    @@@@@@@@@@
@@@@@@@@@@  @@@@  @@  @@    @@@@@@@@@@
@@@@@@@@@@        @@        @@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@        @@        @@@@@@@@@@
@@@@@@@@@@    @@  @@  @@@@  @@@@@@@@@@
@@@@@@@@@@    @@  @@  @@@@  @@@@@@@@@@
@@@@@@@@@@        @@  @  @  @@@@@@@@@@
@@@@@@@@@@        @@        @@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@  @@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  Thank you for using jOOQ 3.9.5

七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ARRAYs fetched           : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Enums fetched            : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Packages fetched         : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Routines fetched         : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Tables fetched           : 1 (1 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: No schema version is applied for catalog . Regenerating.
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating catalog       : DefaultCatalog.java
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ==========================================================
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating schemata      : Total: 1
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: No schema version is applied for schema library. Regenerating.
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating schema        : Library.java
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: ----------------------------------------------------------
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Sequences fetched        : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: UDTs fetched             : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating tables
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Synthetic primary keys   : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Overriding primary keys  : 1 (0 included, 1 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating table         : Author.java [input=author, output=author, pk=KEY_author_PRIMARY]
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Tables generated         : Total: 819.168ms
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating table references
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Table refs generated     : Total: 827.491ms, +8.323ms
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating Keys
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Keys generated           : Total: 835.486ms, +7.995ms
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating table records
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generating record        : AuthorRecord.java
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Table records generated  : Total: 854.667ms, +19.18ms
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Domains fetched          : 0 (0 included, 0 excluded)
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Generation finished: library: Total: 860.822ms, +6.155ms
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息:
七月 30, 2017 1:12:52 下午 org.jooq.tools.JooqLogger info
信息: Removing excess files

四、连接到您的数据库

我们在工程中编写一个测试类Main.java：

package test.generated;

import java.sql.Connection;
import java.sql.DriverManager;

/**
 * 测试类
 * Created by jan on 2017/7/30.
 */
public class Main {
    public static void main(String[] args) {
        // 用户名
        String userName = "root";
        // 密码
        String password = "123456";
        // mysql连接url
        String url = "jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=UTF-8";

        // Connection is the only JDBC resource that we need
        // PreparedStatement and ResultSet are handled by jOOQ, internally
        try (Connection conn = DriverManager.getConnection(url, userName, password)) {
            // ...
        }

        // For the sake of this tutorial, let"s keep exception handling simple
        catch (Exception e) {
            e.printStackTrace();
        }
    }
}

这是一个标准的JDBC MySQL连接代码。

五、查询

我们使用jOOQ的DSL构建出一个简单查询：

DSLContext create = DSL.using(conn, SQLDialect.MYSQL);
Result result = create.select().from(AUTHOR).fetch();

传入Connection连接对象、数据方言得到一个DSLContext的实例，然后使用DSL对象查询得到一个Result对象。

注意：DSLContext不会主动关闭连接，需要我们手动关闭。

六、输出结果

得到Result对象后，循环输出结果集：

for (Record r : result) {
    Integer id = r.getValue(AUTHOR.ID);
    String firstName = r.getValue(AUTHOR.FIRST_NAME);
    String lastName = r.getValue(AUTHOR.LAST_NAME);

    System.out.println("ID: " + id + " first name: " + firstName + " last name: " + lastName);
}

完成的代码应该是这样的：

package test.generated;

import org.jooq.DSLContext;
import org.jooq.Record;
import org.jooq.Result;
import org.jooq.SQLDialect;
import org.jooq.impl.DSL;

import java.sql.Connection;
import java.sql.DriverManager;

import static test.generated.tables.Author.AUTHOR;

/**
 * 测试类
 * Created by jan on 2017/7/30.
 */
public class Main {
    public static void main(String[] args) {
        // 用户名
        String userName = "root";
        // 密码
        String password = "123456";
        // mysql连接url
        String url = "jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=UTF-8";

        // Connection is the only JDBC resource that we need
        // PreparedStatement and ResultSet are handled by jOOQ, internally
        try (Connection conn = DriverManager.getConnection(url, userName, password)) {
            DSLContext create = DSL.using(conn, SQLDialect.MYSQL);
            Result result = create.select().from(AUTHOR).fetch();

            for (Record r : result) {
                Integer id = r.getValue(AUTHOR.ID);
                String firstName = r.getValue(AUTHOR.FIRST_NAME);
                String lastName = r.getValue(AUTHOR.LAST_NAME);

                /**
                 * 控制台输出
                 * ID: 1 first name: 3 last name: zhang
                 * ID: 2 first name: 4 last name: li
                 */
                System.out.println("ID: " + id + " first name: " + firstName + " last name: " + lastName);
            }

            // 关闭连接对象
            conn.close();
        }
        // For the sake of this tutorial, let"s keep exception handling simple
        catch (Exception e) {
            e.printStackTrace();
        }
    }
}

七、更多示例

jOOQ已经是一个全面的SQL库，更多学习文档请参考：

http://www.jooq.org/learn

http://www.jooq.org/javadoc/l...

http://ikaisays.com/2011/11/0...

【jOOQ中文】教程代码都会放在码云，希望多多宣传给Star(^_−)☆。

https://gitee.com/xujian_jaso...

云服务器 GPU云服务器入门的五个步骤前端快速入门 JOOQ 云计算快速入门

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/67526.html

【jOOQ中文】3. 数据库版本管理工具Flyway

摘要：一简介什么是是独立于数据库的应用管理跟踪数据库变更的数据库版本管理工具。当升级完成时，数据库表结构及数据应当与升级后的产品版本保持一致。在执行数据库迁移时，我们推荐使用jOOQ与Flyway - 数据库迁移轻松。在本章中，我们将简单的来使用这两个框架。一、Flyway简介 showImg(https://segmentfault.com/img/bVSjro?w=400&h=31...

AprilJ 2019-08-15 11:09 评论0 收藏0
【jOOQ中文】2. jOOQ与Spring和Druid整合

摘要：在这个例子中，我们将整合但您也可以使用其他连接池，如，，等。作为构建和执行。 jOOQ和Spring很容易整合。在这个例子中，我们将整合： Alibaba Druid（但您也可以使用其他连接池，如BoneCP，C3P0，DBCP等）。 Spring TX作为事物管理library。 jOOQ作为SQL构建和执行library。一、准备数据库 DROP TABLE IF EXIS...

pingink 2019-08-15 11:08 评论0 收藏0
ORM “杀器”之 JOOQ

摘要：摘要介绍简单实用，以及相对于传统框架的不同点。最令人满意的就是在实际使用过程中解决问题的灵活性。当前在数据服务组担任开发工程师，主要负责服务器开发。摘要介绍JOOQ简单实用，以及相对于传统ORM框架的不同点。 showImg(https://segmentfault.com/img/remote/1460000006763840); （图片来自http://www.jooq.org...

Andrman 2019-06-25 18:22 评论0 收藏0
ORM “杀器”之 JOOQ

摘要：摘要介绍简单实用，以及相对于传统框架的不同点。最令人满意的就是在实际使用过程中解决问题的灵活性。当前在数据服务组担任开发工程师，主要负责服务器开发。摘要介绍JOOQ简单实用，以及相对于传统ORM框架的不同点。 showImg(https://segmentfault.com/img/remote/1460000006763840); （图片来自http://www.jooq.org...

elarity 2019-06-24 17:49 评论0 收藏0