# SpatialiteExample

**Repository Path**: yzb_harmony/SpatialiteExample

## Basic Information

- **Project Name**: SpatialiteExample
- **Description**: example 是 Spatialite4oh 库的演示应用，展示了如何在 HarmonyOS 应用中使用空间数据库功能。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# example
[![V2.0.0](https://img.shields.io/badge/Version-2.0.0-green.svg)](https://ohpm.openharmony.cn/#/cn/detail/@yzb%2Fspatialite4oh)
[![GPL-3.0 License](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](./LICENSE)
[![HarmonyOS](https://img.shields.io/badge/HarmonyOS-Next-green.svg)](https://developer.harmonyos.com/)

Spatialite4OH 使用示例

## 简介

example 是 [@yzb/spatialite4oh](https://ohpm.openharmony.cn/#/cn/detail/@yzb%2Fspatialite4oh) 库的演示应用，展示了如何在 HarmonyOS 应用中使用空间数据库功能。

## 运行示例

1. 使用 DevEco Studio 打开项目
2. 选择 example 模块
3. 运行应用

## 功能演示

example 模块提供三个标签页的完整功能演示：

### 📂 SQL 标签页 - 原生 SQL 操作

| 功能 | 按钮 | 说明 |
|------|------|------|
| **Database** | Init | 初始化 Spatialite 数据库 |
| | Open | 打开数据库连接 |
| | Close | 关闭数据库连接 |
| | Ver | 查看依赖库版本信息 |
| **DDL** | Create | 创建 cities 表 |
| | AddGeom | 添加空间几何列 |
| | Drop | 删除表 |
| **DML** | Insert | 插入空间数据 |
| | Bind | 参数绑定插入 |
| | Update | 更新数据 |
| | Delete | 删除数据 |
| **Query** | Select | 查询所有数据 |
| | Spatial | 空间查询 |

### 🔷 GEOS 标签页 - 空间几何操作

| 功能 | 按钮 | 说明 |
|------|------|------|
| **Create** | Point | 创建点几何 |
| | Line | 创建线几何 |
| | Polygon | 创建面几何 |
| | WKT | 从 WKT 创建几何 |
| **Properties** | Props | 获取几何属性 |
| | Analysis | 空间分析 |
| **Relations** | Relation | 空间关系判断 |
| | Distance | 计算距离 |

### 📦 ORM 标签页 - DataORM 框架操作

| 功能 | 按钮 | 说明 |
|------|------|------|
| **CRUD** | Insert | 插入城市数据 |
| | QueryName | 按名称查询 |
| | QueryAll | 查询所有 |
| | Update | 更新数据 |
| **Clear** | Delete | 删除单条 |
| | Delete All | 清空所有 |
| | Close | 关闭数据库 |

> 💡 ORM 操作基于 DataORM 框架，自动处理几何对象的序列化

## 示例代码

主要示例代码位于：`src/main/ets/pages/Index.ets`

### 核心模块

- `src/main/ets/test/SqlTest.ets` - SQL 操作测试
- `src/main/ets/test/GeometryTest.ets` - GEOS 几何测试  
- `src/main/ets/test/OrmTest.ets` - ORM 操作测试
- `src/main/ets/orm/City.ets` - City 实体类
- `src/main/ets/orm/DbHelper.ets` - DataORM 数据库助手
- `src/main/ets/base/LogManager.ets` - 日志管理

## 项目结构

```
example/
├── src/main/ets/
│   ├── pages/
│   │   └── Index.ets              # 主页面（完整功能演示）
│   ├── test/
│   │   ├── SqlTest.ets            # SQL 操作测试
│   │   ├── GeometryTest.ets       # 几何操作测试
│   │   └── OrmTest.ets            # ORM 操作测试
│   ├── orm/
│   │   ├── City.ets               # City 实体类
│   │   ├── DbHelper.ets           # DataORM 助手
│   │   └── GeometryConverter.ets  # 几何转换器
│   └── base/
│       └── LogManager.ets         # 日志管理
├── build-profile.json5
└── oh-package.json5
```

## 依赖版本

- Spatialite4OH: 2.0.0
- DataORM: 2.3.5
- HarmonyOS SDK: 5.0.0+

> 💡 **完整 API 文档**：请参考 **@yzb/spatialite4oh/README.md**

## 相关文档

- 🗄️ [SpatiaLite 空间函数参考](https://www.gaia-gis.it/fossil/libspatialite/index)

**重要说明：**
项目仅提供预编译二进制库，想获取更多源码或协助编译其它版本源码，请联系作者本人（[yanzhangbao@163.com](mailto:yanzhangbao@163.com)）。