Apache Ignite自定义缓存存储(CacheStore)实现指南-优快云博客

Apache Ignite自定义缓存存储(CacheStore)实现指南

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite15/ignite

理解CacheStore的核心概念

Apache Ignite的CacheStore接口是连接内存数据网格与持久化存储的关键桥梁。它实现了经典的"读写穿透"(Read-Through/Write-Through)模式，使得开发者可以无缝地将Ignite缓存与底层数据库集成。

CacheStore的核心功能

CacheStore主要提供三类核心操作：

批量加载：通过loadCache()方法实现缓存预热
单条操作：load(), write(), delete()对应单条数据的CRUD
批量操作：loadAll(), writeAll(), deleteAll()处理批量数据

CacheStoreAdapter简化开发

对于大多数场景，我们推荐继承CacheStoreAdapter而非直接实现CacheStore接口。这个适配器类已经提供了批量操作的默认实现（通过循环调用单条操作方法），开发者只需专注于单条记录的处理逻辑即可。

实现事务性CacheStore

要实现事务性CacheStore，关键在于使用CacheStoreSession。这个会话对象可以通过@GridCacheStoreSessionResource注解注入到你的实现类中，它能够在同一事务中保持相同的数据库连接。

@GridCacheStoreSessionResource
private CacheStoreSession session;

在事务提交时，连接会自动提交；事务回滚时，连接也会回滚。这种机制确保了缓存与数据库的一致性。

实战示例：JDBC非事务性CacheStore

以下是一个基于JDBC的非事务性CacheStore实现示例：

public class JdbcPersonStore extends CacheStoreAdapter<Integer, Person> {
    // 数据源引用
    private DataSource dataSrc;
    
    // 注入数据源
    @GridCacheStoreSessionResource
    private CacheStoreSession session;

    @Override
    public Person load(Integer key) {
        try (Connection conn = connection();
             PreparedStatement st = conn.prepareStatement("SELECT * FROM PERSONS WHERE id=?")) {
            st.setInt(1, key);
            
            try (ResultSet rs = st.executeQuery()) {
                return rs.next() ? new Person(rs.getInt(1), rs.getString(2)) : null;
            }
        } catch (SQLException e) {
            throw new CacheLoaderException("Failed to load: " + key, e);
        }
    }

    @Override
    public void write(Cache.Entry<? extends Integer, ? extends Person> entry) {
        try (Connection conn = connection();
             PreparedStatement st = conn.prepareStatement(
                 "MERGE INTO PERSONS (id, name) VALUES (?, ?)")) {
            st.setInt(1, entry.getKey());
            st.setString(2, entry.getValue().getName());
            st.executeUpdate();
        } catch (SQLException e) {
            throw new CacheWriterException("Failed to write: " + entry, e);
        }
    }

    private Connection connection() throws SQLException {
        return session != null && session.attachment() != null ? 
            (Connection)session.attachment() : dataSrc.getConnection();
    }
}