Model

使用 Model 可以将一个复杂的应用分割成许多较小的模块。每个 Model 都拥有自己的 defaultArgs，initialState，selectors，reducers，effects 和 epics。

const Model = createModel(
class extends ModelBase {
// ...
}
);

当创建应用后，可以使用 registerModels 注册这些 Model。

info

同一 Model 只能被注册一次。

const { registerModels } = createNyax(/* options */);
registerModels({
app: AppModel,
user: UserModel,
entity: {
foo: EntityFooModel,
bar: EntityBarModel,
},
});

Dynamic Model

默认的 Model 是静态的，在注册 Model 的时候会自动注册其唯一 Container。当我们需要注册同一个 Model 的多个相互独立的 Container 时，我们可以将 Model 配置为 Dynamic Model。

当 Model 为 Dynamic Model 时，我们在获取 Container 时需要额外提供 containerKey 作为标识。默认情况下 Dynamic Model 对应的 Container 需要显式注册。

const Model = createModel(
class extends ModelBase {
// ...
},
{
isDynamic: true, // Model is dynamic
}
);
const container = getContainer(Model, "someContainerKey");
container.register(); // container needs to be registered explicitly

Lazy Model

默认的 Model 是非惰性的。这意味着对于 Static Model 会立即注册其唯一的 Container；对于 Dynamic Model 则会要求显式注册其每一个 Container。如果我们希望 Model 对应的 Container 能够按需注册，则可以配置 Model 为 Lazy Model。

当 Model 为 Lazy Model 时，Static Model 对应的 Container 不会立即注册，所有的未注册 Container 在分发 action 时会自动进行注册。

info

Container 自动注册时会使用默认参数。请确保对应 Model 的 defaultArgs 中不包含必要参数，否则会抛出错误。

const Model = createModel(
class extends ModelBase {
// ...
},
{
isDynamic: true,
isLazy: true, // Model is lazy
}
);
const container = getContainer(Model, "someContainerKey");
container.actions.someAction.dispatch({}); // container will be registered automatically

合并 Model

多个 Model 可以被合并成一个新的 Model，每个 Model 的定义会被递归地合并。

info

多个 Model 不允许对相同的 key 进行重复定义。

const AModel = createModel(
class extends ModelBase {
public initialState() {
return {
a: "A",
};
}
}
);
const BModel = createModel(
class extends ModelBase {
public initialState() {
return {
b: "B",
};
}
}
);
const Model = mergeModels(AModel, BModel);
const container = getContainer(Model);
container.state.a; // "A"
container.state.b; // "B"

合并 Sub Model

多个 Model 可以作为 Sub Model 被合并为一个新的 Model，每个 Model 的定义会被放到相应的 namespace 下。

const AModel = createModel(
class extends ModelBase {
public initialState() {
return {
name: "A",
x: "X",
};
}
}
);
const BModel = createModel(
class extends ModelBase {
public initialState() {
return {
name: "B",
y: "Y",
};
}
}
);
const Model = mergeSubModels({
a: AModel,
b: BModel,
});
const container = getContainer(Model);
container.state.a.name; // "A"
container.state.b.name; // "B"
container.state.a.x; // "X"
container.state.b.y; // "Y"

重写 Model 定义

可以在新的 Model 中重写被继承的 Model 的定义。

const BaseModel = createModel(
class extends ModelBase {
public effects() {
return {
someEffect: async () => {
console.log("Base");
},
};
}
}
);
const Model = createModel(
class extends BaseModel {
public effects() {
return {
...super.effects(),
someEffect: async () => {
console.log("B");
},
};
}
}
);