快速入门

环境准备

支持 JDK 8 及以上版本

1. 创建应用

首先，你需要在控制面板中创建应用。请参考控制面板-创建应用。

2. 安装 SDK

SDK 的安装方式:

使用 Maven

<dependency>
    <groupId>com.wilddog.client</groupId>
    <artifactId>wilddog-sync-jvm</artifactId>
    <version>2.0.2</version>
</dependency>

提示：

若用户使用的是 JDK 1.7 环境，请参考 Sync SDK 下载安装。

## 3. 创建 Sync 实例

// 初始化
WilddogOptions options = new WilddogOptions.Builder().setSyncUrl("https://<wilddog SyncAppID>.wilddogio.com").build();
WilddogApp.initializeApp(options);
SyncReference ref = WilddogSync.getInstance().getReference();

提示：

Wilddog Sync 允许同时创建多个实例。

4. 写入数据

setValue() 用于向指定节点写入数据。Sync 的数据存储格式采用 JSON。

例如，在应用的根节点下写入评论数据：

 Comment comment = new Comment("Jack","Wilddog, Cool!");
ref.child("messageboard").child("message1").setValue(comment
);

写入的数据如下图：

5. 监听数据

addValueEventListener()或 addListenerForSingleValueEvent() 方法用于监听节点的数据。

例如，从应用中获得评论数据：

// dataSnapshot 里面的数据会一直和云端保持同步
myRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(DataSnapshot dataSnapshot) {
        if(dataSnapshot.getValue()!=null){
          Log.d("onDataChange",dataSnapshot.toString());
        }
    }
    @Override
    public void onCancelled(SyncError syncError) {
        if(syncError!=null){
         Log.d("onCancelled",syncError.toString());}
        }
});

// 如果你只想监听一次，那么你可以使用addListenerForSingleValueEvent()

myRef.addListenerForSingleValueEvent(new ValueEventListener() {
    @Override
    public void onDataChange(DataSnapshot dataSnapshot) {
        if(dataSnapshot.getValue()!=null){
          Log.d("onDataChange",dataSnapshot.toString());
        }
    }
    @Override
    public void onCancelled(SyncError syncError) {
        if(syncError!=null){
         Log.d("onCancelled",syncError.toString());}
        }
});

6.数据安全

你可以在 Sync 中使用规则表达式进行数据访问权限的控制。规则表达式可以实现以下功能：

数据访问权限控制
用户访问权限控制
数据格式校验
数据索引

规则表达式的具体使用，请参考安全性与规则。

注意：

初始配置下，所有人都能读写你的应用数据，请及时在实时通信引擎-读写权限中更改规则表达式。

7.更多使用

了解 Sync 更多使用方式，请参考完整指南和 API 文档。
了解如何设计数据结构，请参考组织数据。