Java SDK

Lovrabet Java SDK（com.lovrabet:sdk）是专为 Java 后端应用设计的 OpenAPI 客户端库，提供简洁可靠的 Lovrabet 平台数据访问能力。

💡 产品定位

Java SDK 对标 TypeScript SDK（@lovrabet/sdk），面向 Java / Kotlin / Spring Boot 后端开发者，核心能力一致：数据 CRUD、条件筛选、聚合统计、自定义 SQL、BFF 调用——但用 Java 生态惯用的接口风格实现。

⚡ 核心特性

• HMAC-SHA256 签名认证：服务端安全通信，AccessKey 永不泄露到客户端
• 完整 CRUD 操作：filter() 筛选、getOne() 查询、create/update/delete 增删改
• 聚合统计：aggregate() 支持 count/sum/avg 分组查询
• 自定义 SQL：executeCustomSQL() 调用平台预注册的 SQL 逻辑
• Spring Boot 集成：starter 依赖，一行配置即可注入
• 统一错误处理：LovrabetException 携带错误码和描述

📦 快速安装

<!-- Maven -->
<dependency>
    <groupId>com.lovrabet</groupId>
    <artifactId>sdk</artifactId>
    <version>{VERSION}</version>
</dependency>

// Gradle
implementation 'com.lovrabet:sdk:{VERSION}'

📂 文档目录

🚀 入门

• Java SDK 介绍 — SDK 概述、能力清单、快速安装
• 快速开始 — 5 分钟完成依赖引入和第一次 API 调用

🧩 核心概念

• 核心概念 — SDK 核心类、客户端管理、认证机制

🛠️ 使用指南

• 示例 — 5 个真实业务场景的完整代码
• 最佳实践 — 生产环境客户端管理、安全性、性能优化

🔍 参考

• API 参考 — 所有类、方法的完整接口文档
• FAQ — 常见问题与解决方案

---

本文档由 Claude Code 维护，基于飞书 Wiki 源自动生成。