1. 创建应用
首先，你需要在控制面板中创建应用。请参考 控制面板-创建应用。
2. 安装 SDK
SDK 的安装方式:
<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() 方法用于监听 节点 的数据。
例如，从应用中获得评论数据：
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());}
}
});
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.更多使用
