5分钟上手JetBrains Xodus：嵌入式事务数据库的极速入门指南

【免费下载链接】xodus Transactional schema-less embedded database used by JetBrains YouTrack and JetBrains Hub. 项目地址: https://gitcode.com/gh_mirrors/xo/xodus

JetBrains Xodus是一款由JetBrains开发的事务性无模式嵌入式数据库，采用Java和Kotlin编写，被广泛应用于YouTrack和Hub等知名产品中。作为一款ACID兼容的嵌入式数据库，Xodus无需独立部署，可直接嵌入应用程序，为开发者提供高效、可靠的数据存储解决方案。

🚀 为什么选择Xodus？核心优势解析

Xodus凭借五大核心特性脱颖而出：

• 完全事务支持：遵循ACID原则，确保数据一致性
• 高并发性能：基于MVCC（多版本并发控制）实现无阻塞读取
• 无模式设计：无需预定义表结构，支持敏捷开发
• 嵌入式架构：零部署成本，直接嵌入应用进程
• 多语言支持：纯Java/Kotlin实现，无缝集成JVM生态

这些特性使Xodus成为嵌入式场景的理想选择，尤其适合需要本地数据存储且对性能有高要求的应用。

⚡ 极速入门：5分钟搭建开发环境

环境准备

Xodus作为嵌入式数据库，无需单独安装服务，只需在项目中添加依赖即可。目前支持Maven和Gradle两种构建工具。

Gradle项目配置

在build.gradle文件中添加以下依赖：

dependencies {
    implementation 'jetbrains.exodus:xodus-environment:1.3.232'
    implementation 'jetbrains.exodus:xodus-entity-store:1.3.232'
}

Maven项目配置

在pom.xml文件中添加：

<dependency>
    <groupId>jetbrains.exodus</groupId>
    <artifactId>xodus-environment</artifactId>
    <version>1.3.232</version>
</dependency>
<dependency>
    <groupId>jetbrains.exodus</groupId>
    <artifactId>xodus-entity-store</artifactId>
    <version>1.3.232</version>
</dependency>

更多依赖管理细节可参考官方文档。

🔍 核心概念快速理解

Xodus主要包含两大API层：

环境（Environment）

Environment是Xodus的核心概念，代表一个数据库实例，负责管理数据存储和事务。每个Environment对应文件系统中的一个目录。

实体存储（Entity Store）

基于Environment构建的高级API，提供面向对象的数据访问方式，支持实体、属性和链接等概念，无需处理底层键值对操作。

💻 实战示例：创建你的第一个Xodus应用

1. 初始化Environment

import jetbrains.exodus.env.Environment;
import jetbrains.exodus.env.Environments;
import java.io.File;

public class XodusExample {
    public static void main(String[] args) {
        // 指定数据库目录
        final File dbDir = new File("/path/to/your/database");
        
        // 打开或创建Environment
        try (final Environment env = Environments.newInstance(dbDir)) {
            // 数据库操作代码
        }
    }
}

2. 执行事务操作

// 在Environment中执行写事务
env.executeInTransaction(txn -> {
    // 获取或创建名为"users"的存储
    final Store store = env.openStore("users", StoreConfig.WITHOUT_DUPLICATES, txn);
    
    // 写入数据
    final ByteIterable key = StringBinding.stringToEntry("user1");
    final ByteIterable value = StringBinding.stringToEntry("John Doe");
    store.put(txn, key, value);
    
    return null;
});

// 执行读事务
env.executeInReadonlyTransaction(txn -> {
    final Store store = env.openStore("users", StoreConfig.WITHOUT_DUPLICATES, txn);
    final ByteIterable key = StringBinding.stringToEntry("user1");
    final ByteIterable value = store.get(txn, key);
    
    if (value != null) {
        System.out.println("User: " + StringBinding.entryToString(value));
    }
    return null;
});

3. 使用实体存储API

// 创建实体存储
try (final EntityStore store = PersistentEntityStores.newInstance(env)) {
    // 在事务中操作实体
    try (final StoreTransaction txn = store.beginTransaction()) {
        // 创建实体
        final Entity user = txn.newEntity("User");
        user.setProperty("name", "John Doe");
        user.setProperty("age", 30);
        
        // 提交事务
        txn.commit();
    }
}

🔒 数据安全：内置加密功能

从1.2.0版本开始，Xodus支持数据库加密功能，提供Salsa20和ChaCha两种加密算法，确保敏感数据安全。加密功能可通过配置轻松启用，为本地存储的数据提供额外保护。

📊 性能表现：超越传统嵌入式数据库

根据基准测试，Xodus在各种操作中表现优异：

• 带键前缀的Xodus存储（Patricia树）：插入100万条记录仅需0.994秒
• 不带键前缀的Xodus存储（BTree）：插入100万条记录需1.880秒

这些性能数据表明Xodus在嵌入式场景下具有显著优势，特别适合需要处理大量数据的应用。

📚 学习资源与社区支持

• 官方文档：提供详细的API参考和使用指南
• GitHub仓库：包含完整源代码和示例项目
• 社区论坛：可获取开发支持和问题解答

通过这些资源，开发者可以快速掌握Xodus的高级特性和最佳实践。

🎯 总结：Xodus的适用场景

Xodus特别适合以下场景：

• 桌面应用本地数据存储
• 移动应用离线数据管理
• 嵌入式系统数据处理
• 需要事务支持的客户端应用

凭借其出色的性能和易用性，Xodus为开发者提供了一个强大而灵活的嵌入式数据库解决方案，值得在你的下一个项目中尝试。

开始使用Xodus，体验嵌入式事务数据库带来的开发便利和性能优势吧！

【免费下载链接】xodus Transactional schema-less embedded database used by JetBrains YouTrack and JetBrains Hub. 项目地址: https://gitcode.com/gh_mirrors/xo/xodus