shuxingjihe

属性集合

你可以通过键值对的形式访问、监听或管理一组对象，并可据此快速生成观察者模型或数据模型。

引用和创建实例

import { PropsController } from 'datasense';

只需使用关键词new即可创建其实例。

// Create an instance.
let props = new PropsController();

访问属性

你可以获取或设置指定属性的值。

// 检查是否已存在该属性。
console.info(`There ${props.hasProp("name") ? "isn't" : "is"} a name here.`);

// 逐一设置指定属性。
props.setProp("name", "Kingcean");
props.setProp("gender", "male");

// 批量设置一组属性。
props.setProps({
    name: "Lily",
    gender: "female"
});

// 获取指定属性。
console.info(props.getProp("name"));

添加事件和订阅

你可以为各属性添加事件或订阅，以观测其值的变化。

// 注册事件或订阅。
props.onPropChanging("name", ev => {});
props.onPropChanged("name", ev => {});
props.onPropChangeFailed("name", ev => {});
props.subscribeProp("name", newValue => {});

并且，你也可以对各属性的更改，添加一个统一的事件，使得任何一个或一批属性的值发生变更，都能获得一个汇总。该事件会创造一个数组，里面包含了所有的改动，该数组会以属性changes的形式，存在于注册事件的参数中。

props.onPropsChanged(ev => {
    console.info(`${ev.changes.length} properties are changed.`)
});

你也可以通过propsChanged只读属性获取该事件的观察者模型。

获取数据模型

你可以通过getKeys方法获取所有的属性名。

你还可以创建一个包含所有属性的数据模型副本，该副本与控制器没有任何绑定关联，可用于以普通对象的形式去访问其中的各属性。如下所示。

let modelCopy = props.copyModel();
modelCopy.name = "Kingcean";
console.info(`You may still see Lily here - ${props.getProp("name")}.`)

你也可以通过proxy属性，获得该数据模型副本，但该副本中各属性与控制器中各属性保持有双向绑定的关系，可以像访问普通对象的方式去读取和设置该副本中的各属性，包括添加属性。

预设动作

你可以预设一些动作。动作通常可以用于预定义一些标准行为，如按照某种形式来修改属性。

props.registerRequestHandler("taller", (acc, data) => {
    let height = props.proxy.height;
    if (height == null) height = 100;
    if (data == null) data = 1;
    props.proxy.height += data;
});

这样，只需发送动作请求，即可直接执行这些动作。

props.sendRequest("taller", 70);
console.info(props.getProp("height") + "cm"); // 170cm

创建观察者模型

当然，你也可以由此创建一个观察者模型，方便发送至其它模块中使用。该模型只包含读取、监听、订阅、收发广播和接受通知功能。

let propsObs = props.createObservable();
propsObs.onPropChanged("name", ev => {});

// All event listener and subscriber will be diposed if dispose this instance.
propsObs.dispose();

如果你希望拥有除订阅者模型的功能外，还要有设置、发送通知、注册预设动作等功能，可创建一个控制器的副本。

let propsClient = props.createClient();

类型PropsClient和PropsObservable都可以创建源自其自身的观察者模型。

除此之外，你可以可以针对其中属性来创建其观察者模型或控制器副本。

let nameObs = props.createPropObservable("name");
let nameClient = props.createPropClient("name");

广播和通知

广播消息用于将某一自定义对象发送至该实例相关的各控制器、控制器分身和观察者模型，以便响应一些特殊事件。

控制器、控制器分身和观察者模型都可以发送广播消息；并且，它们也都能接收该消息，即便是发自其自身。

value.onBroadcastReceived(ev => {
    console.info(ev);
});
valueObs.onBroadcastReceived(ev => {
    console.info(ev);
});
value.sendBroadcast("这是一条消息。");
valueObs.sendBroadcast("这是另一条消息。")

通知只能通过控制器及其分身发送，它们以及观察者模型都能接收，包括其自身所发的。通知通常用于响应来自修改者发送的额外对象所带的内容。

valueObs.onNotifyReceived(ev => {
    console.info(ev);
});
value.sendNotify("这是另一条通知。");

---

Back home