2020计算机博弈大赛幻影围棋分组第一天

从学长那拿到了2018，2019年参加幻影围棋比赛的代码，咸鱼了几天之后，我组三人正式开始准备2020年的比赛，这篇博客主要记录我参与的部分。
在看到源码的时候，不禁感叹，源码之混乱(毕竟祖传代码传了不止一代)，所以下决心对源码进行重构，并且加深对源码的理解。
首先来看学长给的程序结构图，这张结构图清晰易懂，重构的大体框架还是按他这个来。

首先从最简单也是最基础的信息交互模块开始写

信息交互模块

这个模块的功能与平台进行信息交互，从评估系统模块接收下棋点，更新棋盘信息等等。
引擎与平台通信的技术是进程间通信，所以我们只需要用标准输入输出函数即可实现与平台的通信。
这是平台与引擎的通信协议规范
链接: https://pan.baidu.com/s/1OxH4YbOE5pEIk21rPn0pHQ
提取码: u54e
引擎向平台发送的指令只有move, 表明在哪下棋, 格式为 move + ’ ’ + positionlist, 例如

printf("move %c%c\n",step.point.x+'A',step.point.y+'A');

幻影围棋允许pass

printf("move pass\n");

鉴于平台可能有更改通信格式的可能，所以我们将输出封装为一些函数，引擎调用该方法即可，命令格式改变不会影响整体程序的的运行。

""" 这里有向平台发送命令和参数的函数, 已经封装好了 """

def sendMove(point):
    """ 与平台通信，发送Move命令 格式 move 12 12是坐标1, 2 :param point: 向平台提交下棋的点坐标 :return: None """
    print("move {0}{1}".format(chr(point.x + ord('A')), chr(point.y + ord('A'))))


def sendMoveByXY(x, y):
    """ 与平台通信，发送Move命令 格式 move 12 12是坐标1, 2 :param point: 向平台提交下棋的点坐标 :return: None """
    print("move {0}{1}".format(chr(x + ord('A')), chr(y + ord('A'))))

def sendMovePass():
    print("move pass")

def sendName(name):
    """ 向平台发送引擎名称 :param name:名称 :return: None """
    print("name {0}".format(name))

信息交互模块中，当平台向引擎发送指令以及数据时，对于不同的指令都会有一些处理逻辑，最后可能导致信息交互模块文件if/else每条分支都很长，代码可读性和可维护性都大大降低。所以这里我们将处理每条指令的逻辑都封装为一个方法。

class BoardControlInterface(object):
    """ 这是一个棋盘控制的接口,所有的棋盘控制类都应该继承他，并且实现里面的方法 """
    def move(self, msg):
        """ :param msg: 平台发送过来的信息 :return: """
        print("move action")
        pass

    def accept(self):
        """ 如果下法被平台接受了，则执行这个方法 :return: """
        print("accept action")
        pass

    def refuse(self):
        """ 如果被平台拒绝了则执行这个方法 :return: """
        print("refuse action")
        pass

    def take(self):
        """ 如果我方提子，则执行这个方法 :return: """
        print("take action")
        pass

    def taked(self, msg):
        """ 如果我方被对方提子，则执行这个方法 :param msg:平台发送过来的信息 :return: """
        print("taked action")
        pass

    def new(self, msg):
        """ 新建对局 :param msg:平台发送过来的信息 :return: """
        print("new action")
        pass

接收平台信息的模块，原来的模块代码量大，处理逻辑复杂，重构就要解决这个问题，提高程序的可读性和可维护性。没有什么是加一层不能解决的，如果有，那就加两层，这里将原来的信息交互模块分为了两层，一层负责接收，另一层负责处理。

import sys
import go_configuration.game_conf as gf
import go_interaction.order_to_be_send as order
import go_board_control.board_control_interface as BoardControl

sys.path.append("..")

""" 这里是总控制文件,当处理的条件少的时候直接用if/else结构简单清晰，条件变多的时候建议用反射机制实现 """

def run():
    boardControl = BoardControl.BoardControlInterface()
    while True:
        sys.stdout.flush()
        msg = input().split(" ")
        sys.stdin.flush()

        if gf.GameStatus.isGuessMode == True:
            pass
        elif 'new' in msg[0]:
            boardControl.new(msg)
            pass
        elif 'move' in msg[0]:
            boardControl.move(msg)
            order.sendMove(1, 2)
            pass
        elif 'accept' in msg[0]:
            boardControl.accept()
            pass
        elif 'refuse' in msg[0]:
            boardControl.refuse()
            pass
        elif 'take' in msg[0]:
            boardControl.take()
            pass
        elif 'taked' in msg[0]:
            boardControl.taked(msg)
            pass
        elif 'error' in msg[0]:
            pass
        elif 'name?' in msg[0]:
            order.sendName("Blizzard")
        msg.clear()

    pass

总结：

1. 对于经常用到的语句，都把他们封装为函数，以函数调用的方式执行，让程序的可维护性大大提高。

2. 对于代码逻辑复杂，单文件过长导致可读性和可维护性都低的情况，可以在原有基础上分层，每层尽量只做一件事情。

戳它戳它戳它-> 幻影围棋第二天 围棋规则学习