电梯运行模拟——三次作业总结
[TOC] 。。博客园不支持目录。。
总体遵循的设计思路
逻辑解耦
电梯与调度器解耦
在我的三次电梯作业里，追求的目标都是让电梯运行与调度器分离，电梯只负责按照指令运行，目前的最终版本中，指令有UP、DOWN、OPEN、CLOSE、STILL、STOP六条。
楼层信息的存储和变更与电梯、调度器解耦
从第二次作业开始，我建立了Stage类，负责保存楼层信息；
建立了Instruction类，负责描述电梯运行的指令以及对应的Stage的变化，Instruction类中有一个枚举类型表示指令类型，一个IntFunction类型函数表示楼层索引的变化。
调度器运行流程解耦
从第二次到第三次，我的调度器的逻辑部分都是解耦成如下4个部分：
- 获取主请求，也就是分发指令的依据
- 根据主请求分发指令
- 推送指令和需要进入电梯人员到与电梯交互的数据单元
- 检测电梯返还人员，从本调度器处理队列中删除，第三次添加了：如果需要转乘，则重新插入顶层调度器
这是一个轮询机制，顺序循环并分发指令，控制电梯。
第一次电梯，蠢笨串行先到先得电梯
类方法复杂度表
| Method | ev(G) | iv(G) | v(G) |
|---|---|---|---|
| "Main.main(String[])" | 1 | 1 | 1 |
| "elevator.Dispatcher.Dispatcher()" | 1 | 1 | 1 |
| "elevator.Dispatcher.getWaitingQueue()" | 1 | 1 | 1 |
| "elevator.Dispatcher.printQueue()" | 1 | 1 | 1 |
| "elevator.Dispatcher.run()" | 1 | 3 | 4 |
| "elevator.Elevator.Elevator(int|int|int)" | 1 | 1 | 1 |
| "elevator.Elevator.OutPersonThread.OutPersonThread(int|Vector
|
1 | 1 | 1 |
| "elevator.Elevator.OutPersonThread.run()" | 1 | 3 | 3 |
| "elevator.Elevator.addPassenger(int|int)" | 1 | 1 | 1 |
| "elevator.Elevator.getStage()" | 1 | 1 | 1 |
| "elevator.Elevator.getStatus()" | 1 | 1 | 1 |
| "elevator.Elevator.moveDown()" | 1 | 2 | 3 |
| "elevator.Elevator.moveTo(int)" | 1 | 5 | 5 |
| "elevator.Elevator.moveUp()" | 1 | 2 | 3 |
| "elevator.Elevator.release()" | 1 | 1 | 1 |
| "elevator.ElevatorOutput.formatOutput(Format|int)" | 2 | 2 | 4 |
| "elevator.ElevatorOutput.formatOutput(Format|int|int)" | 2 | 2 | 4 |
| "elevator.Person.Person(int|int|int)" | 1 | 1 | 1 |
| "elevator.Person.getFrom()" | 1 | 1 | 1 |
| "elevator.Person.getId()" | 1 | 1 | 1 |
| "elevator.Person.getTo()" | 1 | 1 | 1 |
| "elevator.TransferPersonRequest.TransferPersonRequest(Dispatcher)" | 1 | 1 | 1 |
| "elevator.TransferPersonRequest.run()" | 3 | 2 | 5 |
| "util.MultiMap.MultiMap()" | 1 | 1 | 1 |
| "util.MultiMap.get(K)" | 1 | 1 | 1 |
| "util.MultiMap.put(K|V)" | 1 | 1 | 2 |
| "util.MultiMap.remove(K)" | 1 | 1 | 1 |
| "util.MultiMap.toString()" | 1 | 1 | 1 |
可见的是，我的方法复杂度都很低，因为类也比较少，没什么衡量价值
第二次电梯，可捎带无限容量电梯
第二次电梯运作原理图
sequenceDiagram transfer ->> Dispatcher : 传递人员请求 Stage -->> Dispatcher : 拿到楼层信息，计算指令 Dispatcher ->> Elevator : 发送指令，如果是开门指令，则等待人员返还 Dispatcher ->> Stage : 在发送指令后变更楼层 Dispatcher ->> Elevator : 发送待上电梯人员 Elevator -->> Dispatcher : 返还待下电梯人员
从第二次电梯开始，我的电梯是按照如上的设计架构完成的，这是让我觉得比较舒服的架构设计，其设计方向是在于模拟，而不是为最优解设计的。
类方法复杂度表
| Method | ev(G) | iv(G) | v(G) |
|---|---|---|---|
| "Main.main(String[])" | 1 | 1 | 1 |
| "machine.Dispatcher.Dispatcher()" | 1 | 2 | 2 |
| "machine.Dispatcher.exec(Instruction)" | 1 | 7 | 7 |
| "machine.Dispatcher.getNewInstruction()" | 6 | 4 | 9 |
| "machine.Dispatcher.getNewMajorRequest()" | 8 | 4 | 11 |
| "machine.Dispatcher.run()" | 1 | 5 | 5 |
| "machine.Dispatcher.updatePersonMap()" | 1 | 3 | 3 |
| "machine.elevator.Elevator.Elevator(ReentrantLock)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.close()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.move()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.open()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.run()" | 2 | 5 | 8 |
| "machine.elevator.Elevator.setOutsideQueue(MapVisitor<Integer| Person>)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setStage(Stage)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setToBeExec(List<Instruction>)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setToBeRemoved(Queue<Person>)" | 1 | 1 | 1 |
| "machine.elevator.ElevatorOutput.formatOutput(Format|int)" | 2 | 2 | 5 |
| "machine.elevator.ElevatorOutput.formatOutput(Format|int|int)" | 2 | 2 | 4 |
| "machine.elevator.Stage.Stage()" | 1 | 1 | 1 |
| "machine.elevator.Stage.Stage(int)" | 1 | 1 | 2 |
| "machine.elevator.Stage.apply(IntFunction)" | 1 | 1 | 2 |
| "machine.elevator.Stage.checkIndex(int)" | 1 | 1 | 2 |
| "machine.elevator.Stage.checkStage(int)" | 3 | 1 | 3 |
| "machine.elevator.Stage.getStage()" | 1 | 1 | 1 |
| "machine.input.Person.Person(int|int|int)" | 1 | 1 | 2 |
| "machine.input.Person.equals(Object)" | 2 | 1 | 2 |
| "machine.input.Person.getFrom()" | 1 | 1 | 1 |
| "machine.input.Person.getId()" | 1 | 1 | 1 |
| "machine.input.Person.getSide()" | 1 | 1 | 1 |
| "machine.input.Person.getStatus()" | 1 | 1 | 1 |
| "machine.input.Person.getTo()" | 1 | 1 | 1 |
| "machine.input.Person.transSide()" | 1 | 1 | 2 |
| "machine.input.TransferPersonRequest.TransferPersonRequest(Queue<Person>)" | 1 | 1 | 1 |
| "machine.input.TransferPersonRequest.run()" | 3 | 2 | 4 |
| "machine.input.TransferRequest.TransferRequest(PersonMap)" | 1 | 1 | 1 |
| "machine.input.TransferRequest.run()" | 3 | 2 | 4 |
| "machine.instr.Instruction.Instruction(Instr|IntFunction)" | 1 | 1 | 1 |
| "machine.instr.Instruction.getFunc()" | 1 | 1 | 1 |
| "machine.instr.Instruction.getInstr()" | 1 | 1 | 1 |
| "util.MultiMap.MultiMap()" | 1 | 1 | 1 |
| "util.MultiMap.get(K)" | 1 | 1 | 1 |
| "util.MultiMap.put(K|V)" | 1 | 1 | 2 |
| "util.MultiMap.removeByKey(K)" | 1 | 1 | 1 |
| "util.MultiMap.removeValue(K|V)" | 1 | 2 | 2 |
| "util.MultiMap.toString()" | 1 | 1 | 1 |
| "util.PersonMap.PersonMap()" | 1 | 1 | 1 |
| "util.PersonMap.getFromPerson(int|Status)" | 2 | 2 | 2 |
| "util.PersonMap.getToPerson(int|Status)" | 2 | 2 | 2 |
| "util.PersonMap.hasElement(Person)" | 3 | 3 | 4 |
| "util.PersonMap.isEmpty()" | 5 | 4 | 7 |
| "util.PersonMap.putPerson(Person)" | 2 | 2 | 3 |
| "util.PersonMap.removePerson(Person)" | 2 | 4 | 4 |
| "util.PersonMap.toEnd()" | 2 | 2 | 2 |
| "util.PersonMap.toString()" | 1 | 1 | 1 |
可以看出加粗的三个方法复杂度较高，分别是获取主请求、根据主请求生成新命令、还有personMap的isEmpty方法。
获取主请求由于personMap的不合理，得在遍历时分别获取personMap的两个子map，即fromUp和fromDown两个map，所以复杂度很高。
根据主请求生成命令复杂度高跟上一个函数同理。
personMap的isEmpty方法就是因为personMap内部成员是4个map，对每一个都isEmpty然后与起来，复杂度就高了。
类复杂度表
| Class | OCavg | WMC |
|---|---|---|
| "Main" | 1.00 | 1 |
| "machine.Dispatcher" | 5.17 | 31 |
| "machine.elevator.Elevator" | 2.22 | 20 |
| "machine.elevator.Elevator.Format" | n/a | 0 |
| "machine.elevator.Elevator.Status" | n/a | 0 |
| "machine.elevator.ElevatorOutput" | 4.50 | 9 |
| "machine.elevator.Stage" | 1.67 | 10 |
| "machine.input.Person" | 1.38 | 11 |
| "machine.input.Person.Side" | n/a | 0 |
| "machine.input.Person.Status" | n/a | 0 |
| "machine.input.TransferPersonRequest" | 2.00 | 4 |
| "machine.input.TransferRequest" | 2.00 | 4 |
| "machine.instr.InstrFac" | n/a | 0 |
| "machine.instr.InstrFac.Instr" | n/a | 0 |
| "machine.instr.Instruction" | 1.00 | 3 |
| "util.MultiMap" | 1.33 | 8 |
| "util.PersonMap" | 2.44 | 22 |
可以看出，加粗的Dispatcher类和ElevatorOutput类复杂度较高，后者不说了，这个很难避免，前者复杂度高的原因是，目前大部分的逻辑处理部分在这一层，实现了轮询生成指令并分发，又有前述的两个方法加成，所以复杂度很高，当然，这个还与我的数据结构设计有一定的关系，personMap设计得很糟糕，如果改进数据结构并分离一些逻辑，想必复杂度会降下去的吧。
第三次电梯，可达楼层、运行速度和容量均不相同的多电梯
第三次电梯运作原理图
sequenceDiagram transfer ->> Scheduler : 传递人员请求 Scheduler ->> Dispatcher : 发送人员请求 Stage -->> Dispatcher : 拿到楼层信息，计算指令 Dispatcher ->> Elevator : 发送指令，如果是开门指令，则等待人员返还 Dispatcher ->> Stage : 在发送指令后变更楼层 Dispatcher ->> Elevator : 发送待上电梯人员 Elevator -->> Dispatcher : 返还待下电梯人员 Dispatcher -->> Scheduler : 返还需要转乘的人员请求
这里实际上scheduler是给三个Dispatcher发送不同的人员请求但是为了说明的简易，只画了一个Dispatcher、Stage、Elevator组。
类方法复杂度表
| Method | ev(G) | iv(G) | v(G) |
|---|---|---|---|
| "Main.main(String[])" | 1 | 1 | 1 |
| "machine.Scheduler.Scheduler()" | 1 | 1 | 1 |
| "machine.Scheduler.dispatchPerson()" | 1 | 1 | 1 |
| "machine.Scheduler.putPersonToElevator(Person)" | 1 | 2 | 2 |
| "machine.Scheduler.run()" | 1 | 4 | 4 |
| "machine.elevator.Dispatcher.Dispatcher(Stage，String，long，int，ReentrantLock)" | 1 | 1 | 1 |
| "machine.elevator.Dispatcher.exec(Instruction)" | 1 | 5 | 5 |
| "machine.elevator.Dispatcher.getNewInstruction()" | 11 | 7 | 13 |
| "machine.elevator.Dispatcher.getNewMajorRequest()" | 1 | 3 | 5 |
| "machine.elevator.Dispatcher.getPeopleMap()" | 1 | 1 | 1 |
| "machine.elevator.Dispatcher.run()" | 1 | 5 | 5 |
| "machine.elevator.Dispatcher.setToBePut(PeopleVector)" | 1 | 1 | 1 |
| "machine.elevator.Dispatcher.update()" | 1 | 3 | 3 |
| "machine.elevator.Elevator.Elevator(ReentrantLock，String，long，int)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.close()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.move()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.open()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.processInside()" | 1 | 1 | 1 |
| "machine.elevator.Elevator.processOutside()" | 2 | 1 | 2 |
| "machine.elevator.Elevator.run()" | 2 | 5 | 8 |
| "machine.elevator.Elevator.setOutsideQueue(MapVisitor<Integer， Person>)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setStage(Stage)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setToBeExec(List<Instruction>)" | 1 | 1 | 1 |
| "machine.elevator.Elevator.setToBeRemoved(Queue<Person>)" | 1 | 1 | 1 |
| "machine.elevator.Stage.Stage(int[])" | 1 | 2 | 3 |
| "machine.elevator.Stage.apply(IntFunction)" | 1 | 2 | 2 |
| "machine.elevator.Stage.checkIndex(int)" | 1 | 1 | 2 |
| "machine.elevator.Stage.couldStall()" | 1 | 1 | 1 |
| "machine.elevator.Stage.getStage()" | 1 | 1 | 1 |
| "machine.elevator.Stage.initStage(int)" | 1 | 2 | 2 |
| "machine.elevator.Stage.isReachable(int)" | 1 | 1 | 1 |
| "machine.elevator.Stage.isReachableByIndex(int)" | 2 | 2 | 2 |
| "machine.elevator.Stage.stageToIndex(int)" | 3 | 1 | 4 |
| "machine.elevator.Stage.toString()" | 1 | 1 | 1 |
| "machine.input.Person.Person(int,int,int)" | 1 | 1 | 2 |
| "machine.input.Person.equals(Object)" | 2 | 1 | 2 |
| "machine.input.Person.getDestination()" | 2 | 1 | 2 |
| "machine.input.Person.getFrom()" | 1 | 1 | 1 |
| "machine.input.Person.getId()" | 1 | 1 | 1 |
| "machine.input.Person.getSide()" | 1 | 1 | 1 |
| "machine.input.Person.getStatus()" | 1 | 1 | 1 |
| "machine.input.Person.getTo()" | 1 | 1 | 1 |
| "machine.input.Person.hashCode()" | 1 | 1 | 1 |
| "machine.input.Person.isOutside()" | 1 | 1 | 1 |
| "machine.input.Person.isUp()" | 1 | 1 | 1 |
| "machine.input.Person.needGetInside(int)" | 1 | 1 | 2 |
| "machine.input.Person.needGetOutside(Stage)" | 3 | 2 | 3 |
| "machine.input.Person.setMid(Stage,Stage)" | 6 | 6 | 12 |
| "machine.input.Person.toString()" | 1 | 1 | 1 |
| "machine.input.Person.transSide()" | 1 | 1 | 2 |
| "machine.input.Person.wantOne()" | 3 | 4 | 7 |
| "machine.input.TransferRequest.TransferRequest(PeopleVector,ReentrantLock)" | 1 | 1 | 1 |
| "machine.input.TransferRequest.run()" | 3 | 3 | 5 |
| "machine.instr.Instruction.Instruction(Type,IntFunction)" | 1 | 1 | 1 |
| "machine.instr.Instruction.getFunc()" | 1 | 1 | 1 |
| "machine.instr.Instruction.getType()" | 1 | 1 | 1 |
| "machine.output.Output.format(Format,int,String)" | 2 | 2 | 5 |
| "machine.output.Output.format(Format,int,int,String)" | 2 | 2 | 4 |
| "machine.util.PeopleMap.PeopleMap()" | 1 | 2 | 2 |
| "machine.util.PeopleMap.getCapcity()" | 1 | 1 | 1 |
| "machine.util.PeopleMap.getMap(Type)" | 1 | 1 | 1 |
| "machine.util.PeopleMap.getPerson(Type,int)" | 1 | 1 | 1 |
| "machine.util.PeopleMap.hasElement(Person)" | 3 | 4 | 5 |
| "machine.util.PeopleMap.isEmpty()" | 1 | 2 | 2 |
| "machine.util.PeopleMap.put(Type,Integer,Person)" | 1 | 1 | 1 |
| "machine.util.PeopleMap.putPerson(Person)" | 3 | 2 | 5 |
| "machine.util.PeopleMap.remove(Type,Integer,Person)" | 1 | 1 | 1 |
| "machine.util.PeopleMap.removePerson(Person)" | 2 | 2 | 4 |
| "machine.util.PeopleMap.toEnd()" | 1 | 2 | 2 |
| "machine.util.PeopleMap.toString()" | 1 | 1 | 1 |
| "machine.util.PeopleVector.PeopleVector()" | 1 | 1 | 1 |
| "machine.util.PeopleVector.putPerson(Person)" | 1 | 2 | 2 |
| "machine.util.PeopleVector.putPerson(Person,String)" | 1 | 2 | 3 |
| "machine.util.PeopleVector.toEnd()" | 1 | 3 | 3 |
| "util.MultiMap.MultiMap()" | 1 | 1 | 1 |
| "util.MultiMap.get(K)" | 1 | 1 | 1 |
| "util.MultiMap.isEmpty()" | 1 | 1 | 1 |
| "util.MultiMap.put(K,V)" | 1 | 2 | 3 |
| "util.MultiMap.removeByKey(K)" | 1 | 1 | 1 |
| "util.MultiMap.removeValue(K,V)" | 1 | 2 | 2 |
| "util.MultiMap.toString()" | 1 | 1 | 1 |
| "util.MultiMap.values()" | 1 | 1 | 1 |
加粗的两个方法复杂度飘红了，还是蛮高的，一个是与之前一样的getNewMajorRequest方法，获取新的主请求，因为遍历对象，还有判断person的逻辑比较复杂，所以复杂度很高；
相比上回的改进是getNewInstruction方法复杂度已经没那么高了，因为将一部分逻辑引导到了person类中。
另一个是person类的setMid方法，其作用是设置person的中转目的地，因为拿取了两个stage对象并循环调用对象isReachable函数判断，所以复杂度较高，但并不是太高，只是刚刚超出。
类复杂度表
| Class | OCavg | WMC |
|---|---|---|
| "Main" | 1.00 | 1 |
| "machine.Scheduler" | 1.75 | 7 |
| "machine.elevator.Dispatcher" | 3.88 | 31 |
| "machine.elevator.Elevator" | 1.91 | 21 |
| "machine.elevator.Elevator.Format" | n/a | 0 |
| "machine.elevator.Stage" | 1.70 | 17 |
| "machine.elevator.StageFac" | n/a | 0 |
| "machine.input.Person" | 1.94 | 33 |
| "machine.input.Person.Side" | n/a | 0 |
| "machine.input.Person.Status" | n/a | 0 |
| "machine.input.TransferRequest" | 2.00 | 4 |
| "machine.instr.Instr" | n/a | 0 |
| "machine.instr.Instr.Type" | n/a | 0 |
| "machine.instr.Instruction" | 1.00 | 3 |
| "machine.output.Output" | 4.50 | 9 |
| "machine.util.PeopleMap" | 1.92 | 23 |
| "machine.util.PeopleMap.Type" | n/a | 0 |
| "machine.util.PeopleVector" | 1.50 | 6 |
| "util.MultiMap" | 1.38 | 11 |
Dispatcher类有点积重难返的意思，目前架构是这样了，当然，Dispatcher类完全可以把功能分散到其他类中，最后让他起组合搭桥的作用，就是把之前就描述的DIspatcher类的四个函数分离开来，变成新的类的处理逻辑，这样，应该可以显著减少他的复杂度把；
Person类WMC过高的原因是方法太多了，获取成员、判断进出、判断上哪一个电梯，这么多内容夹杂在一起，内部还有其他的工具函数，导致Person类复杂度很高，如果重构，可以把新的person类变成几个接口的组合，一个获取ID、FROM、TO的借口，一个判断进出相关工具函数的接口，或者单独开个类，处理人员是否需要进出和向上哪一个电梯的类，后者让person专职其责，也能降低复杂度，更好一点把。
Output类。。不用说了。
第三次电梯的所有类图景
