Jooq适配GaussDB开源验证任务

• [任务地址]：https://developer.huaweicloud.com/programs/opensource/contributing/task-detail/e8a3f3db8350453e9bd66cabb978d238
• [servicecomb源码地址]：https://github.com/apache/servicecomb-fence
• 任务摘要：jOOQ是一个功能强大的Java对象关系映射框架，提供类型安全的SQL构建和执行，支持多种数据库并可自动生成代码。本任务的主要目的是让Jooq支持华为云，包括ECS、CCE、GaussDB，帮助拓展华为云的影响力，也方便Jooq的用户能够轻松上云。

一、开发过程

1、jOOQ基础

• [jooq官方地址]：https://www.jooq.org
• [jooq源码地址]：https://githup.com/jOOQ/jOOQ
• [jooq demo]: https://github.com/jOOQ/demo

1.1、OOQ-codegen-maven插件主要用于生成代码，pom.xml plugins配置如下：

<plugin>
    <groupId>org.jooq</groupId>
    <artifactId>jooq-codegen-maven</artifactId>
    <version>${jooq.version}</version>
    <configuration>
        <onUnused>SILENT</onUnused>
        <jdbc>
            <driver>org.postgresql.Driver</driver>
            <url>jdbc:postgresql://localhost:5432/postgres</url>
            <user>gaussdb</user>
            <password>Postgres@123</password>
        </jdbc>
        <generator>
            <generate>
                <pojosAsJavaRecordClasses>true</pojosAsJavaRecordClasses>
                <pojosEqualsAndHashCode>false</pojosEqualsAndHashCode>
                <pojos>true</pojos>
                <pojosToString>false</pojosToString>
                <daos>true</daos>
            </generate>
            <target>
                <directory>src/main/java</directory>
                <packageName>org.apache.servicecomb.fence.generate</packageName>
            </target>
        </generator>
                </configuration>

    <executions>
        <execution>
            <id>generate-code</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>generate</goal>
            </goals>
        </execution>
    </executions>
</plugin>

1.2、jOOQ-demo-oss用于演示java中如何使用jooq连接数据库

<dependencies>
            <dependency>
                <groupId>org.jooq</groupId>
                <artifactId>jooq</artifactId>
                <version>3.19.14</version>
            </dependency>
            <dependency>
                <groupId>org.postgresql</groupId>
                <artifactId>postgresql</artifactId>
                <version>42.7.2</version>
            </dependency>
 </dependencies>

2、jooq-demo-server创建

2.1、基于servicecomb-fence创建maven模块jooq-demo-server,pom.xml配置如下：

<project>
        <properties>
            <jooq.version>3.19.14</jooq.version>
            <postgres.version>42.7.2</postgres.version>
        </properties>
        <dependencies>
            <!-- Database access -->
            <dependency>
                <groupId>org.postgresql</groupId>
                <artifactId>postgresql</artifactId>
                <version>${postgres.version}</version>
            </dependency>
            <dependency>
                <groupId>org.jooq</groupId>
                <artifactId>jooq</artifactId>
                <version>${jooq.version}</version>
            </dependency>
        </dependencies>
</project>

2.2、application.yml GaussDB配置如下：

    servicecomb:
      jooq:
        sql-dialect: postgres
        url: ${DB_URL:jdbc:postgresql://localhost:5432/postgres}
        username: ${DB_USERNAME:gaussdb}
        password: ${DB_PASSWORD:Postgres@123}
        driver-class-name: ${DB_DRIVER:org.postgresql.Driver}

2.3、创建演示用的REST接口ActorEndpoint.java，演示增删改查等功能

1. 在apis模块下创建jooq-demo-api模块
2. 在jooq-demo-server模块中实现api
3. 在edge-server模块application.yml增加路由配置如下：

     http:
       dispatcher:
         edge:
           ## 后端服务
           url:
             enabled: true
             pattern: "/api/(.*)"
             mappings:
               jooq-demo-server:
                 prefixSegmentCount: 2
                 path: "/api/jooq/.*"
   

4. 在admin-website中修改operation.html文件，增加操作入口

二、项目部署

本项目基于华为云CCE云容器和CodeArts持续集成平台搭建测试环境

1、创建dockerfile文件

基于openjdk:17-alpine构建镜像

FROM openjdk:17-alpine
LABEL authors="wmwei"
RUN mkdir -p /opt
COPY target/jooq-demo-server-0.0.1-SNAPSHOT.jar /opt
WORKDIR /opt
RUN mv jooq-demo-server-0.0.1-SNAPSHOT.jar jooq-demo-server.jar
EXPOSE 9098
ENTRYPOINT ["java", "-jar","jooq-demo-server.jar"]

2、创建jooq-demo-deployment.yaml文件

apiVersion: apps/v1
kind: Deployment
metadata:
  name: jooq-demo
  labels:
    app: jooq-demo-deploy
spec:
  replicas: 1
  selector:
    matchLabels:
      app: jooq-demo-pods
  template:
    metadata:
      name: jooq-demo
      labels:
        app: jooq-demo-pods
    spec:
      containers:
        - name: jooq-demo-container
          image: swr.cn-north-4.myhuaweicloud.com/wmwei/jooq-demo-server:0.0.1
          imagePullPolicy: IfNotPresent
          ports:
            - containerPort: 9092
              protocol: TCP
          resources:
            requests:
              memory: "256Mi"
              cpu: "250m"
            limits:
              memory: "256Mi"
              cpu: "250m"
      imagePullSecrets:
        - name: default-secret
      restartPolicy: Always

3、创建jooq-demo-server.yaml文件

apiVersion: v1
kind: Service
metadata:
  name: jooq-demo
spec:
  selector:
    app: jooq-demo-pods
  ports:
    - protocol: TCP
      port: 9098
      targetPort: 9098
  type: NodePort

4、CodeArts平台创建项目

1. 代码托管
   导入gitcode servicecomb-fence代码
2. 创建编译构建任务
   任务一、上传kubernetes yaml文件至华为云OBS对象存储服务
   任务二、上传镜像资源到SWR华为云容器镜像服务
3. 创建部署任务
   任务一、部署基础服务如：mysql、opengauss、zookeeper
   任务二、部署servicecomb-fence微服务和jooq-demo-server服务
4. 创建流水线
   流水线的主要作用是自动执行计划任务，可以定制执行顺序，由于服务之间有依赖关系，要先构建生成代码镜像，接着部署基础服务，最后部署微服务

四、关键验收交付件

• [本文demo地址]：https://github.com/weiwenman/servicecomb-fence
• 博客地址：https://bbs.huaweicloud.com/blogs/438885
• DEMO部署验证结果截图：
• DEMO运行环境和资源规格清单：

1.数据库产品

2.云服务器产品