Skip to content
This repository was archived by the owner on Aug 5, 2023. It is now read-only.

Update To EntityRelations

yueyinqiu edited this page Aug 4, 2023 · 1 revision

更新到 YiJingFramework.EntityRelations

目前,我们已经发布了新的包 YiJingFramework.EntityRelations 。实际上,它就相当于是此包的更新版本,但有非常巨大的结构性变化。从它的名字变短了非常多就可以看出这一点。根据原本的名称,既然有 Most Accepted ,那就应该要有 Not That Accepted 。虽然事实上,关于易学的很多内容就是存在争议,但我们现在意识到,这些少数的才是特殊的,而 Most Accepted 应该是默认的选择,因此它根本不需要额外的标注。

同时,在旧的设计中,我们尽可能地在把功能细分。举例而言,我们曾把阴阳和五行给分到了两个命名空间,这是考虑到如子平使用的阴阳和我们给出的是不同的,因此它可能想要使用五行,但不使用阴阳,因此区分到两个命名空间会比较方便。但实际上,这种区分不是必要的,因为它专门给出一个不同名称的 ZipingYinyang() 也就可以了,即使存在另一个 Yinyang() 也无所谓,这样反而可以减少误用。此外,我们正在考虑会加入一些运行期或者编译期的检查,比如提前设定好某些扩展方法是不可调用的,编译期就直接给出警告等。

总之,这个包将不再受到支持,我们建议更换到新的包。不过,新的包发生了一些结构性的变动和名词的改变,需要注意。总体而言,有代码补全的帮助,一般不会产生太大的问题。如果遇到问题,可以参考新包的文档,也欢迎在 Issues 中咨询。


Update to YiJingFramework.EntityRelations

Currently, we have published a new package YiJingFramework.EntityRelations. Actually, it is a just a update of this package, but includes some structural changes, which also exist in its much shortened name. The original "Most Accepted" is somewhat indicating that there is another "Not That Accepted". Although there are many things in the region of Yi that are still being argued, we now realized that the minor ones should be handled specially and "Most Accepted" should be the default choice with no need of extra tags.

Meanwhile, in the original design, we tried to separate the features as much as possible. For example, we put the entities' Yinyang and Wuxing to two different namespaces, which is because in some cases like Ziping is using the different Yinyang but the same Wuxing. But actually this separateness is not necessary since one can just provide a method with another name like ZipingYinyang(), which on the contrary can reduce misuse, compared with two Yinyang() in different namespace.

So anyway, this package is no longer under support and we recommend the new one. However, the new package has some structural changes, which need to be noted. Generally, with the help of code completion, it won't bring too many problems. If you unfortunatly got a problem, you can check the document of the new package, and feel free to ask for our help in the Issues of the new package.

Clone this wiki locally