# TurboTransJSON

**Repository Path**: harmonyos_samples/TurboTransJSON

## Basic Information

- **Project Name**: TurboTransJSON
- **Description**: 通过turbo_trans库，实现高效JSON等数据序列化
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-24
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TurboTransJSON

## 简介
本示例展示了使用TurboTrans实现高性能JSON序列化操作，覆盖场景包括：
- 结合Sendable跨线程数据传递场景
- 网络数据交互场景
- 结合跨线程和网络数据交互场景
- JSON大文件解析
- JsonNode懒加载
## 效果预览
<img src='./screenshots/device/image.png' width='320'>

## 使用说明
> **注意：项目包含LFS大文件，请勿直接下载ZIP！**

正确获取完整项目的方式：
1. 安装Git LFS：`git lfs install`
2. 克隆仓库（自动拉取LFS文件）：`git clone https://gitee.com/harmonyos_samples/TurboTransJSON.git`

## 工程目录

```
entry/src/main/ets                            // 代码区
├── common                                  
│   ├── components                            // 公共组件
│   │   ├── CardContainer.ets                 // 功能模块卡片-案例描述，示例代码，执行结果
│   │   ├── CellComponent.ets                 // 单个功能模块菜单
│   │   ├── CellGroupComponent.ets            // 功能模块卡片
│   │   ├── LayoutContainer.ets               // 页面根布局组件
│   │   ├── NavBar.ets                        // 页面标题
│   │   └── interface
│   │       └── MainPageListItem.ets          // 单个菜单的数据结构定义
│   ├── constants
│   │   ├── CodeExample.ets                   // 示例代码
│   │   ├── MenuConstants.ets                 // 首页菜单目录
│   │   ├── NavigationConstants.ets           // 页面NavgationId常量
│   │   ├── PageConstant.ets                  // 页面公共样式常量定义
│   │   └── PageRouteConstants.ets            // router name常量定义
│   ├── styles
│   │   ├── BaseContentStyles.ets             // 页面基础样式
│   │   └── ButtonStyles.ets                  // 按钮公共样式
│   └── index.ets                             // common入口文件
├── entryability
│   └── EntryAbility.ets                      // 应用入口ability
├── model
│   └── CityLots.ets                          // 示例数据结构-citylots.json大文件内子节点对象
│   └── Person.ets                            // 示例数据结构-普通Person类
│   └── PersonWithObservedV2.ets              // 示例数据结构-带ObservedV2和Sendable的Person类
│   └── PersonWithSendable.ets                // 示例数据结构-Sendable的Person类
├── pages
│   ├── Index.ets                             // entry页面，定义Navigation
│   └── MainPage.ets                          // Navgation首页，提供示例入口
│   ├── BigJsonFileDecodePage.ets             // 大文件解析
│   ├── LazyLoadJsonNodePage.ets              // JsonNode懒加载
│   ├── NetworkAndObservedV2Page.ets          // 结合跨线程和网络数据交互场景
│   ├── NetworkRequestPage.ets                // 网络数据交互场景
│   └── WithSendablePage.ets                  // Sendable跨线程使用示例
├── utils
│   ├── BigJsonFileAnalyzerUtil.ets           // JSON大文件解析工具方法
│   ├── JsonNodeMethod.ets                    // JsonNode方法封装
│   ├── Logger.ets                            // 日志工具
│   └── NetworkUtil.ets                       // 本地服务端创建，模拟网络请求
└── viewmodel
    └── JsonNodeViewModel.ets                 // JsonNode懒加载页面数据
```


## TurboTransJSON序列化框架使用说明
[TurboTransJSON序列化框架](https://gitcode.com/openharmony-sig/turbo_trans/wiki)

## 相关权限

1. 网络使用权限：ohos.permission.INTERNET。

## 约束与限制
1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS 6.0.0 Release及以上。
3. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。