title: 快速入门

环境准备

  • 支持 JDK 8 及以上版本

1. 创建应用

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

2. 安装 SDK

SDK 的安装方式:

  • 使用 Maven
  1. <dependency>
        <groupId>com.wilddog.client</groupId>
        <artifactId>wilddog-sync-jvm</artifactId>
        <version>2.0.2</version>
    </dependency>

提示：

若用户使用的是 JDK 1.7 环境，请参考 Sync SDK 下载安装。
## 3. 创建 Sync 实例 java // 初始化 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。

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

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

写入的数据如下图：

yourApp

5. 监听数据

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

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

  1. // dataSnapshot 里面的数据会一直和云端保持同步
  2. myRef.addValueEventListener(new ValueEventListener() {
  3.     @Override
  4.     public void onDataChange(DataSnapshot dataSnapshot) {
  5.         if(dataSnapshot.getValue()!=null){
  6.             Log.d("onDataChange",dataSnapshot.toString());
  7.         }
  8.     }
  9.     @Override
  10.     public void onCancelled(SyncError syncError) {
  11.         if(syncError!=null){
  12.              Log.d("onCancelled",syncError.toString());}
  13.         }
  14. });
  16. // 如果你只想监听一次，那么你可以使用addListenerForSingleValueEvent()
  18. myRef.addListenerForSingleValueEvent(new ValueEventListener() {
  19.     @Override
  20.     public void onDataChange(DataSnapshot dataSnapshot) {
  21.         if(dataSnapshot.getValue()!=null){
  22.             Log.d("onDataChange",dataSnapshot.toString());
  23.         }
  24.     }
  25.     @Override
  26.     public void onCancelled(SyncError syncError) {
  27.         if(syncError!=null){
  28.              Log.d("onCancelled",syncError.toString());}
  29.         }
  30. });

6.数据安全

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

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

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

注意：

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

7.更多使用