《网络斗地主服务端项目文档.doc

安卓组开发V1.0 文档版本记录 版本号 修改日期 作者 更改说明 V1.0 2012/01/06 史进鹏 文档创建 0 阅读说明 黑色粗体 表示需要重点阅读，蓝色代表MINA框架类的方法，红色代表类名。 文档分4个部分： (1) 1-5牌类游戏服务端基类； (2) 6-8继承第一部分基类，定义斗地主游戏服务端主要的类，并在这些类中定义了处理消息队列线程需要的方法 (3) 9-12定义第二部分类的数据管理 13数据库数据初始化到内存的方法类 (4) 服务端交互部分，14-19是MINA服务端监听接收，发送，编解码；20-23创建4个线程对交互数据的处理；24-27定义把不同的协议归成属于哪些服务类，规范处理。 1 房间Room类 (1) 属性 房间名称、房间类型、房间内桌子的数量、房间内的桌子列表、房间内的在线人数 (2) 方法 a 构造方法：构造器默认构造 b 获取房间名称方法 参数：无 返回值：房间名称 c 设置房间名称方法 参数：房间名称 返回值：无 d 获取房间类型方法 注释：获取房间类型(如：新手场、中级场、高级随意配桌) 参数：无 返回值：房间类型 e 设置房间类型方法 参数：房间类型 返回值：无 f 获取房间内桌子数量的方法 参数：无 返回值：房间内桌子的数量 g 设置房间内桌子数量的方法 参数：桌子的数量 返回值：无 h 获取房间内桌子列表的方法 参数：无 返回值：房间内桌子列表 i 设置房间内桌子列表的方法 参数：桌子的列表 返回值：无 j 获取房间内在线人数的方法 参数：无 返回值：房间内的在线人数 k 设置房间内在线人数的方法 参数：在线人数 返回值：无 l 进入房间时添加在线人数的方法 注释：进入房间添加在线人数，并且同一时间只能有一个线程执行此操作(synchronized修饰) 参数：无 返回值：无 m 退出房间时减少在线人数 注释：退出房间减少在线人数，并且同一时间只能有一个线程执行此操作(synchronized修饰) 参数：无 返回值：无 n 自动分配到桌子方法(子类中会实现) 注释：为玩家自动分配到一张桌子 参数：一个玩家的对象 返回值：分配到的桌子(null) 2 桌子Table类 (1)属性 桌子所属房间ID 、桌子名称(现在没用后面可能会用到)、桌子ID、桌子当前用户数、 桌子允许的最大用户数、桌子状态、用户列表(考虑用户数量不确定性用vector)、消息队列 (2)方法 a 构造方法：构造器默认构造 b 设置桌子所属房间的方法 注释：就是设置所在房间的房间类型，是新手场，中级场还是其他类型房间。 参数：房间ID 返回值：无 c 获取桌子所属房间的方法 注释：可在斗地主桌子类的换桌方法中使用，使玩家只能在同一房间内换桌 参数：无 返回值：得到桌子所属房间的ID d 设置桌子名称的方法 注释：在初始化桌子信息时把桌子名称设置成桌子ID的字符串 参数：桌子名称 返回值：无 e 获取桌子名称的方法 参数：无 返回值：得到桌子名称 f 设置桌子ID的方法 参数：桌子ID 返回值：无 g 获取桌子ID的方法 注释：用于在玩家成功进入桌子后，发送消息告诉玩家进入的是几号桌子 参数：无 返回值：得到桌子ID h 设置桌子用户数的方法 注释：只为当玩家退出或者进入桌子时要设置一下桌子的当前用户数，私有方法。进入和退出桌子的方法已经加了线程保护synchronized,所以此方法就不用加线程保护。 参数：桌子用户数 返回值：无 i 获取桌子用户数的方法 注释：在斗地主桌子类中给玩家找桌子的方法中会用到，主要配合方法k判断当前桌子玩家数有没有满 参数：无 返回值：得到桌子用户数 j 设置桌子允许最大用户数的方法 注释：在初始化桌子信息时，可根据游戏不同传入不同的参数 参数：桌子允许最大用户数 返回值：无 k 获取桌子允许最大用户数的方法 注释：主要用来判断当前桌子玩家数有没有满 参数：无 返回值：得到桌子允许最大用户数 l 设置桌子状态的方法 注释：如准备中、叫分中、玩牌中 参数：桌子的状态 返回值：无 m 获取桌子状态的方法 参数：无 返回值：得到桌子的状态 n 设置桌子用户列表的方法 注释：在桌子初始化时，给每个桌子加一个包含三个空对象的用户列表 参数：桌子的用户列表 返