Oracle-OraclePartition

SlothLu

于 2024-08-16 21:23:11 发布

阅读量818

点赞数 14

分类专栏： Oracle-debuzium 文章标签： oracle 数据库数据库开发大数据开源 java

本文链接：https://blog.csdn.net/sinat_33727881/article/details/141269867

版权

Oracle-debuzium 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

提示：OraclePartition 是 Debezium 中用于跟踪和处理 Oracle 数据库分区变更的核心组件之一。

文章目录

前言
一、核心功能
二、代码分析
总结

前言

提示：OraclePartition 类用于标识和管理 Oracle 数据库中的逻辑分区，支持数据同步任务中的分区信息追踪和处理。

提示：以下是本篇文章正文内容

标识 Oracle 数据库分区：
- 通过构造函数接收服务器名称 (serverName) 和数据库名称 (databaseName)，用以唯一标识一个 Oracle 数据库分区。
提供源分区信息：
- 通过 getSourcePartition 方法返回一个映射，其中包含分区的关键信息（如服务器名称），这些信息可以被 Debezium 用于数据同步任务。
- 这些信息对于跟踪和处理数据库变更至关重要，例如在捕获和转发数据库表的变更事件时。
对象比较和哈希码生成：
- 通过重写 equals 和 hashCode 方法来确保相同的分区能够被正确地识别和比较。
- 这些方法确保了当两个 OraclePartition 实例具有相同的服务器名称时，它们被视为相等的对象，并且具有相同的哈希码，这对于数据结构（如哈希表）中的分区管理非常重要。
分区提供者：
- 内部静态类 Provider 实现了 Partition.Provider<OraclePartition> 接口，用于提供 OraclePartition 实例。
- Provider 类根据 OracleConnectorConfig 配置创建并返回一个包含单个 OraclePartition 实例的集合，这有助于初始化和管理分区。

一、核心功能

核心功能详细说明

二、代码分析

public class OraclePartition extends AbstractPartition implements Partition {
    // 定义 OraclePartition 类，继承自 AbstractPartition 并实现 Partition 接口

    private static final String SERVER_PARTITION_KEY = "server";
    // 定义常量 SERVER_PARTITION_KEY，用于存储分区中的服务器名称键

    private final String serverName;
    // 定义私有最终字段 serverName，用于存储服务器名称

    // 构造函数
    public OraclePartition(String serverName, String databaseName) {
        // 初始化父类 AbstractPartition 的 databaseName 字段
        super(databaseName);
        this.serverName = serverName;
        // 设置当前类的 serverName 字段
    }

    // 实现 Partition 接口的方法
    @Override
    public Map<String, String> getSourcePartition() {
        // 返回一个映射，其中包含服务器名称，键为 SERVER_PARTITION_KEY
        return Collect.hashMapOf(SERVER_PARTITION_KEY, serverName);
    }

    // 重写 Object 类的方法
    @Override
    public boolean equals(Object obj) {
        // 如果当前对象和传入对象是同一个引用，则返回 true
        if (this == obj) {
            return true;
        }
        // 如果传入对象为空或不是同一个类，则返回 false
        if (obj == null || getClass() != obj.getClass()) {
            return false;
        }
        // 将传入对象转换为 OraclePartition 类型
        final OraclePartition other = (OraclePartition) obj;
        // 比较两个 OraclePartition 实例的 serverName 是否相等
        return Objects.equals(serverName, other.serverName);
    }

    // 重写 Object 类的方法
    @Override
    public int hashCode() {
        // 返回 serverName 字段的哈希码
        return serverName.hashCode();
    }

    // 重写 Object 类的方法
    @Override
    public String toString() {
        // 返回一个字符串，其中包含当前 OraclePartition 实例的 sourcePartition 映射
        return "OraclePartition [sourcePartition=" + getSourcePartition() + "]";
    }

    // 内部静态类 Provider
    static class Provider implements Partition.Provider<OraclePartition> {
        // 定义 Provider 类，实现 Partition.Provider<OraclePartition> 接口

        private final OracleConnectorConfig connectorConfig;
        // 定义私有最终字段 connectorConfig，用于存储 OracleConnectorConfig 配置

        // 构造函数
        Provider(OracleConnectorConfig connectorConfig) {
            this.connectorConfig = connectorConfig;
            // 设置 connectorConfig 字段
        }

        // 实现 Partition.Provider 接口的方法
        @Override
        public Set<OraclePartition> getPartitions() {
            // 根据配置获取数据库名称
            final String databaseName = Strings.isNullOrBlank(connectorConfig.getPdbName())
                    ? connectorConfig.getDatabaseName()
                    : connectorConfig.getPdbName();
            // 创建并返回一个包含单个 OraclePartition 实例的集合
            return Collections.singleton(new OraclePartition(connectorConfig.getLogicalName(), databaseName));
        }
    }
}

封装性

属性封装：OraclePartition 类将 serverName 属性定义为私有的，并通过构造函数进行初始化。这种做法确保了外部无法直接访问和修改该属性，增强了数据的安全性和完整性。
方法封装：getSourcePartition 方法提供了访问分区信息的方式，而不需要暴露内部实现细节。这遵循了面向对象设计中的“隐藏实现细节”原则。

继承性

继承 AbstractPartition：OraclePartition 类继承自 AbstractPartition 类，这意味着它继承了父类的一些通用行为和属性。这种继承关系允许子类专注于实现与 Oracle 数据库相关的特定逻辑，同时复用了父类提供的通用功能。

接口实现

实现 Partition 接口：通过实现 Partition 接口，OraclePartition 类必须提供该接口中定义的方法的具体实现。这有助于确保所有分区类都具有一致的接口，并且可以被统一处理。

重写方法

重写 equals 和 hashCode 方法：这两个方法的重写确保了 OraclePartition 实例能够正确地与其他实例进行比较，并且可以在哈希数据结构中正确地工作。这符合面向对象设计中的“重写方法以提供特定行为”的原则。

内部类

内部类 Provider：Provider 类作为 OraclePartition 的内部类，实现了 Partition.Provider<OraclePartition> 接口。这种方式允许 Provider 类访问 OraclePartition 类的私有成员，同时也保持了良好的封装性。

代码优点

清晰的职责划分：OraclePartition 类专注于管理 Oracle 数据库分区的信息，而 Provider 类则负责提供分区实例。这种职责划分有助于降低代码的耦合度，提高了可维护性。
良好的可读性和文档注释：类和方法都有适当的文档注释，这有助于其他开发人员理解代码的目的和用途。
简洁的实现：代码简洁明了，避免了不必要的复杂性。例如，equals 方法利用 Objects.equals 方法简化了比较逻辑。