Unity StrangeIoc框架 （一）

2022-11-08 11:35:23

最近想项目中需要使用这个架构  因此 上网看了很多资料摸索   但是对于初学者来说大多数的资料不是那么容易理解 而且文档也是英文的阅读起来有点吃力  所以记录一下自己阅读的过程  方便以后翻阅和跟我一样的新人学习其中也借鉴了一些前辈的资料 如有反感请联系我   立马进行修改  谢谢

文档坐标   http://strangeioc.github.io/strangeioc/TheBigStrangeHowTo.html

StrangeIoc 是依据控制反转和解耦原理设计的，支持依赖注入。

控制反转即Ioc（Inversion of Control） 它把传统上由程序代码直接操控的对象的调用权交给容器，通过容器来实现对象组件的装配和管理。所为的“控制反转”概念就是对组件对象控制权的转移，从程序代码本身转移到了内部的容器。

依赖注入（Dependency Injection）    依赖注入的基本原则是：应用组件不应该负责查找资源或者其他依赖的写作对象。配置对象的工作应该由Ioc容器负责，

在使用时

Bingding（绑定)

strange的核心是绑定，我们可以将一个或多个对象与另外一个或多个对象绑定（连接）在一起，将接口与类绑定来实现接口，将事件与事件接收绑定在一起。或者绑定两个类，一个类被创建时另一个类自动创建。

strange的binding由两个必要部分和一个可选部分组成，必要部分是a key and a value  key触发value，因此一个事件可以触发回调，一个类的实例化可以触发另一个类的实例化。可选部分是name，他可以区分使用相同key的两个binding 下面三种绑定方法其实都是一样的，语法不同而已

1. Bind<IRoundLogic>().To<RoundLogic>();

2. Bind(typeof(IRoundLogic)).To(typeof(RoundLogic));

3. IBinding binding = Bind<IRoundLogic>();     //使用IBinding 的时候需要引用strange.framework.api; 命名空间

   binding.To<RoundLogic>();

Bind<IRoundLogic>().To<RoundLogic>().ToName(“Logic”);　　　　//使用非必要部分name

绑定从层次上分为3种： injectionbinding           ,commandbinding,           mediationbing

注入绑定injectionbinding主要是用来绑定该类型对象到上下文，这样使得程序中各个地方可以通过contextview访问得到该对象。这种绑定会生成对象。这种绑定是为了生成对象并且注入到指定对象中用的

commandbinding是为了将命令绑定到方法中用的

mediationbing则是为了拦截view消息，而将view注入中介mediator中，然后在view的awake方法里面生成meidtaor对象

The injection extension(注入扩展）

在绑定扩展中最接近控制反转的思想是注入

接口本身没有实现方法，只定义类中的规则

interface ISpaceship

{

    void input(float angle, float velocity);

    IWeapon weapon{get;set;}

}

//使用另一个类实现这个接口，写法如下

Class Spaceship : ISpaceship

{

    public void input(float angle, float velocity)

    {

        //do

    }

    public IWeapon weapon{get;set;}

}

如果采用上面的写法，Spaceship类里面不用再写检测输入的功能了，只需要处理输入就可以了input只需要控制移动，不需要管是何种输入方式  是手柄键盘或是其他  只需要进行处理

也不需要武器的逻辑，仅仅是注入武器实例就可以了。但是我们需要知道武器是什么样的武器 不同的武器造成不同的掉血  所以这块的逻辑是需要处理的

public interface IWeapon

{

    void Attack();

}

public class PhaserGun : IWeapon

{

    public void Attack(){//掉血逻辑

    }

}

public class SquirtCannon : IWeapon

{

    public void Attack(){//掉血逻辑

    }

}

在ISpaceship中的代码进行一点修改

interface ISpaceship

{

    void input(float angle, float velocity);

    [Inject]

    IWeapon weapon{get;set;}

}

加上Inject标签  这样就可以进行绑定了   将接口与类绑定来实现接口

[Inject]标签实现接口，而不是实例化类

injectionBinder.Bind<IWeapon>().To<PhaserGun >();

单例映射

injectionBinder.Bind<IWeapon>().To<PhaserGun >().ToStringleton();

IWeapon weapon = PhaserGun.Get();

在绑定多个的时候就需要利用  名称映射来进行区分

injectionBinder.Bind<ISocialService>()

    .To<TwitterService>().ToSingleton()

    .ToName(ServiceTypes.PRIMARY);

injectionBinder.Bind<ISocialService>()

    .To<TwitterService>().ToSingleton()

    .ToName(ServiceTypes.SECONDARY);

injectionBinder.Bind<ISocialService>()

    .To<TwitterService>().ToSingleton()

    .ToName(ServiceTypes.TERTIARY);

在[Inject]标签处 也需要进行添加名称

[Inject (ServiceTypes.TERTIARY)] //We mapped TwitterService to TERTIARY

public ISocialService socialService{get;set;}

值的映射

Configuration myConfig = loadConfiguration();

injectionBinder.Bind<IConfig>().ToValue(myConfig);

具体还有几种映射就不说了  需要的可以去看看文档

The reflector extension(反射扩展)

反射列表

List<Type> list = new List<Type> ();

list.Add (typeof(Borg));

list.Add (typeof(DeathStar));

list.Add (typeof(Galactus));

list.Add (typeof(Berserker));

//count should equal 4, verifying that all four classes were reflected.

int count = injectionBinder.Reflect (list);

反射所有已经通过injectionBinder映射的所有

injectionBinder.ReflectAll();

The dispatcher extension（调度程序扩展）

dispatcher相当于观察者模式中的公告板，允许客户监听他，并且告知当前发生的事件。在strangeioc中，通过EventDispatcher方式实现，EventDispatcher绑定触发器来触发带参数/不带参数的方法   触发器通常是String或枚举类型（触发器可以理解为key，或者事件的名称，名称对应着触发的方法）

如果有返回值，他将存在IEvent，一个简单的值对象包含与该事件相关的任何数据，你可以写你自己的事件满足IEvent接口，strangeioc事件叫TmEvent

如果你再使用MVCSContext 有一个全局的EventDispatcher 叫contextDispatcher 会自动注入，你可以用来传递事件

有两种基本的事你可以去做EventDipatcher调度事件和监听他们

dispatcher.AddListener("FIRE_MISSILE", onMissileFire);

事件会处于监听状态，知道FIRE_MISSILE事件被处罚，然后执行对应的onMissileFire方法

也可以通过枚举实现

dispatcher.AddListener(AttackEvent.FIRE_MISSILE, onMissileFire);

移除监听

dispatcher.RemoveListener(AttackEvent.FIRE_MISSILE, onMissileFire);

更新监听

dispatcher.UpdateListener(true, AttackEvent.FIRE_MISSILE, onMissileFire);

调用的方法可以有一个参数或者没有，这取决于你关心的事件效率

private void onMissileFire()

{

    //this works...

}

private void onMissileFire(IEvent evt)

{

    //...and so does this.

    Vector3 direction = evt.data as Vector3;

}

调度事件

dispatcher.Dispatch(AttackEvent.FIRE_MISSILE);

这种形式的调度将生成一个新的TmEvent  调用任何监听对象,但是因为你没有提供数据,数据字段的TmEvent当然会是零。 你也可以调度和提供数据:

Vector3 orientation = gameObject.transform.localRotation.eulerAngles;

dispatcher.Dispatch(AttackEvent.FIRE_MISSILE, orientation);

可以自己创建TmEvent调度

Vector3 orientation = gameObject.transform.localRotation.eulerAngles;
TmEvent evt = new TmEvent(AttackEvent.FIRE_MISSILE, dispatcher, this.orientation);

dispatcher.Dispatch(evt);

The command extension(命令扩展)

除了绑定事件的方法，可以将其绑定到Commands。命令是控制器结构MVC的指挥者在strangeioc的MVCSContext中 CommandBinder监听每一个dispatcher的调度（当然你可以改变这个如果你想在自己的上下文）。信号,下面描述,也可以绑定到命令。当一个事件或信号被调度，

using strange.extensions.command.impl;

using com.example.spacebattle.utils;

namespace com.example.spacebattle.controller

{

    class StartGameCommand : EventCommand

    {

        [Inject]

        public ITimer gameTimer{get;set;}

        override public void Execute()

        {

            gameTimer.start();

            dispatcher.dispatch(GameEvent.STARTED);

        }

    }

}

但异步命令, 像网络请求   可以这样做   Retain() and Release()

using strange.extensions.command.impl;

using com.example.spacebattle.service;

namespace com.example.spacebattle.controller

{

    class PostScoreCommand : EventCommand

    {

        [Inject]

        IServer gameServer{get;set;}

        override public void Execute()

        {

            Retain();

            int score = (int)evt.data;

            gameServer.dispatcher.AddListener(ServerEvent.SUCCESS, onSuccess);

            gameServer.dispatcher.AddListener(ServerEvent.FAILURE, onFailure);

            gameServer.send(score);

        }

        private void onSuccess()

        {

            gameServer.dispatcher.RemoveListener(ServerEvent.SUCCESS, onSuccess);

            gameServer.dispatcher.RemoveListener(ServerEvent.FAILURE, onFailure);

            //...do something to report success...

            Release();

        }

        private void onFailure(object payload)

        {

            gameServer.dispatcher.RemoveListener(ServerEvent.SUCCESS, onSuccess);

            gameServer.dispatcher.RemoveListener(

            ServerEvent.FAILURE, onFailure);

            //...do something to report failure...

            Release();

        }

    }

}

如果使用完不进行Release（）可能会导致内存泄露

映射命令

commandBinder.Bind(ServerEvent.POST_SCORE).To<PostScoreCommand>();

您可以将多个命令绑定到单个事件如果你喜欢

commandBinder.Bind(GameEvent.HIT).To<DestroyEnemyCommand>().To<UpdateScoreCommand>();

解除命令绑定Unbind

commandBinder.Unbind(ServerEvent.POST_SCORE);

一次性的指令

commandBinder.Bind(GameEvent.HIT).To<DestroyEnemyCommand>().Once();

按顺序执行绑定   InSequence  会一直执行到最后的命令 或者其中一个命令失败。  命令可以在任何时候调用Fail()   这会打破这个序列  这可以用于建立一个链相关的事件  为构建有序的动画,或制定一个守卫,以确定是否应该执行一个命令。

commandBinder.Bind(GameEvent.HIT).InSequence()

    .To<CheckLevelClearedCommand>()

    .To<EndLevelCommand>()

    .To<GameOverCommand>();

The signal extension（消息扩展）

信号是一个调度机制，另一种选择EventDispatcher 相比于EventDispatcher  信号有两个优点  1. 分发结果不再创建实例，因此也不需要GC回收更多的辣鸡  2. 更安全 当消息与回调不匹配时会断开执行，官网也推荐使用Singal来兼容后续版本

创建两个信号，每一个都有一个参数

Signal<int> signalDispatchesInt = new Signal<int>();

Signal<string> signalDispatchesString = new Signal<string>();

signalDispatchesInt.AddListener(callbackInt);　　　　　　//Add a callback with an int parameter
signalDispatchesString.AddListener(callbackString);　　　　//Add a callback with a string parameter

signalDispatchesInt.Dispatch(42);　　　　　　　　//dispatch an int
signalDispathcesString.Dispatch("Ender wiggin");　　　　　　//dispatch a string

void callbackInt(int value){
　　　　//Do something with this int
}

void callbackString(string value){
　　　　//Do something with this string
}

消息最多可以使用四个参数

Signal<T, U, V, W> signal = new Signal<T, U, V, W>();

子类可以编写自己的信号

    using System;

    using UnityEngine;

    using strange.extensions.signal.impl;

    namespace mynamespace

    {

        //We're typing this Signal's payloads to MonoBehaviour and int

        public class ShipDestroyedSignal : Signal<MonoBehaviour, int>

        {

        }

    }

信号映射到命令

protected override void addCoreComponents()

{

    base.addCoreComponents();

    injectionBinder.Unbind<ICommandBinder>();

    injectionBinder.Bind<ICommandBinder>().To<SignalCommandBinder>().ToSingleton();

}

这告诉strangeioc 我们做了默认CommandBinder SignalCommandBinder取而代之。 所以是信号触发命令 而不是事件 。 strangeioc  只支持 事件或者信号中的一个映射命令，而不是两个都是。

信号绑定   依旧使用commandBinder

commandBinder.Bind<SomeSignal>().To<SomeCommand>();

映射一个信号到命令  会自动创建一个injection映射  你可以通过[Inject]标签 检索

[Inject]

public ShipDestroyedSignal shipDestroyedSignal{get; set;}

commandBinder.Bind<ShipDestroyedSignal>().To<ShipDestroyedCommand>();

在ShipMediator,我们注入信号,然后调度

[Inject]

public ShipDestroyedSignal shipDestroyedSignal{get; set;}

private int basePointValue; //imagining that the Mediator holds a value for this ship

//Something happened that resulted in destruction

private void OnShipDestroyed()

{

    shipDestroyedSignal.Dispatch(view, basePointValue);

}

派遣一个信号通过SignalCommandBinder映射结果的实例化ShipDestroyedCommand:

using System;

using strange.extensions.command.impl;

using UnityEngine;

namespace mynamespace

{

    //Note how we extend Command, not EventCommand

    public class ShipDestroyedCommand : Command

    {

        [Inject]

        public MonoBehaviour view{ get; set;}

        [Inject]

        public int basePointValue{ get; set;}

        public override void Execute ()

        {

            //Do unspeakable things to the destroyed ship

        }

    }

}

如您所见,映射的方法非常类似于信号命令的方法使用事件

两个重要问题:第一,而信号支持多个相同类型的参数,注射。 因此不可能对一个信号与相同类型的两个参数映射到一个命令

//This works

Signal<int, int> twoIntSignal = new Signal<int, int>();

twoIntSignal.AddListener(twoIntCallback);

//This fails

Signal<int, int> twoIntSignal = new Signal<int, int>();

commandBinder.Bind(twoIntSignal).To<SomeCommand>();
override public void Launch()

{

    base.Launch();

    //Make sure you've mapped this to a StartCommand!

    StartSignal startSignal= (StartSignal)injectionBinder.GetInstance<StartSignal>();

    startSignal.Dispatch();

}

映射没有命令的信号

一个信号映射到一个命令会自动创建一个映射,您可以检索通过注入到其他地方   但是如果你想注入信号没有绑定到一个命令  使用injectionBinder只需将它映射

injectionBinder.Bind<ShipDestroyedSignal>().ToSingleton();

The mediation extension（调解器（中介模式））

MediationContext是唯一一个专为unity设计的部分，因为mediation关心的是对view（GameObject）的操作。由于view部分天生的不确定性，我们推荐view由两种不同的monobehavior组成：View and Mediator

view就是mvc中的v，一个view就是一个你可以编写的逻辑，控制可见部分的monobehavior 这个类可以附加（拖拽）到unity编辑器来管理GameObject 但是不建议将mvc中的models和controller逻辑卸载view中

Mediator类的职责是执行view和整个应用的运行。他会获取整个app中分发和接收时间和消息。但是因为mediator的设计，建议使用命令模式（command）来做这部分功能

using Strange.extensions.mediation.impl;

using com.example.spacebattle.events;

using com.example.spacebattle.model;

namespace com.example.spacebattle.view

{

    class DashboardMediator : EventMediator

    {

        [Inject]

        public DashboardView view{get;set;}

        override public void OnRegister()

        {

            view.init();

            dispatcher.AddListener

                (ServiceEvent.FULFILL_ONLINE_PLAYERS, onPlayers);

            dispatcher.Dispatch

                (ServiceEvent.REQUEST_ONLINE_PLAYERS);

        }

        override public void OnRemove()

        {

            dispatcher.RemoveListener

                (ServiceEvent.FULFILL_ONLINE_PLAYERS, onPlayers);

        }

        private void onPlayers(IEvent evt)

        {

            IPlayers[] playerList = evt.data as IPlayers[];

            view.updatePlayerCount(playerList.Length);

        }

    }

}

1.DashboardView注入可以使 Mediator 知道具体的view

2.注入完成后OnRegister（）方法会立即执行，可以用这个方法来做初始化  像上面做的那样 初始化 然后做重要的数据请求

3.contextDispatcher可以扩展任何的EventMediator

4.OnRemove（）清理时使用，当一个view销毁前被调用，移除时记得删除你的监听

5.例子中的view暴露两个接口init（）和updatePlayerCount（float value），但是程序在设计时 你需要更多，但是原则是相同的  限制中介除了薄任务之间的传递信息的查看和其他应用程序

绑定一个界面到Mediator

mediationBinder.Bind<DashboardView>().To<DashboardMediator>();

值得注意的几点

1.不是所有的MonoBehaviour被限制为一个View

2.中介者绑定是实例对实例的，也就是说一个view对应一个mediator，如果有很多view，也就会有很多的mediator

The context extension(上下文扩展)

MVCSContext包含EventDispatcher（事件分发），injectionBinder（注入绑定），MediationBinder（中介绑定），CommandBinder（命令绑定）

可以重新将CommandBinder绑定到SignalCommandBinder   命令和中介依托注入，context可以为命令和中介的绑定提供关联

建立一个项目，需要重新MVCSContext或者Context，一个app也可以包换多个Contexts 这样可以使你的app更高的模块化，因此，一个app可以独立的设计为聊天模块，社交模块  最终他们会整合到一起成为一个完整的app

暂时记录到这里 剩下的 下一章补完

上一篇：win32 api ShouCursor 根据内部计数器 是否>= 0 决定是否 显示光标，每true时计数器+1，每false-1


下一篇：CDC 虚拟com口