Scut快速开发

缺乏、安全感 2021-12-22 12:43 232阅读 0赞

# 1 开发环境 #

Scut Lib版本：5.2.3.2

**需要安装的软件**

a) IIS和消息队列(MSMQ)

b) 数据库，Sql2005以上版本

c) VS2010开发工具（.Net Framework 4.0以上）

d) Python2.6（ScutGame官网下载IronPython2.6.1 RC1 for .NET 4.0插件）

**工具**

a) 协议工具（目录Source\\Tools\\ContractTools）

# 2 代码框架 #

项目划分三层：实体层，组件层，业务逻辑层（脚本层）；模型层主要是数据实体映射，自定义缓存结构；组件层主要负责实现中层层扩展功能；业务逻辑层主要负责实现游戏功能；

## 2.1 数据库创建 ##

游戏划分成三个库：DemoConfig库（负责存储游戏配置数据） 、DemoData库(负责存储游戏玩家数据)和DemoLog库(游戏玩家日志记录数据)；如图

![21145241-a6845fa527e047b5942be0a7e1146e83.png][]

这里只为每个库建立一张表：

## 2.2 项目搭建 ##

### 2.2.1 创建解决方案 ###

打开VS2010 在菜单上选择 文件 -> 新建 -> 项目；弹出“新建项目”对话窗口，在左则展开“其它项目类型”，选择“Visual Studio解决方案”，选择“.Net Framework 4.0”后，输出项目名称及位置，再点击“确定”；如图：

![31115038-bd5c9ab1bb3a489cae4b806fc0c0cb9d.jpg][]

### 2.2.2 创建项目 ###

在“资源管理器”中添加新的几个项目Model、Lang、Com、Bll、HostServer；**Model****项目：**负责从数据库中导出表的数据实体类映射；

**Lang项目：**负责多语言包；

**Com项目：**负责中间层组件扩展处理，及中间层业务实体类；

**Bll项目：**负责业务逻辑处理；

**HostServer项目：**控制台启动程序，及脚本（Python）业务逻辑处理；

如图：

![31115206-05f43dfa0b5c4aad97301c4a52561f88.jpg][]

![31115221-62a27fadec314b4da1d85e1aff526068.jpg][]

创建项目结果如下：

![31115245-e637630c59574ef5bee31581ecff2cbb.jpg][]

设置控制台程序“HostServer”属性为“.Net Framework 4.0”

![31115314-dda13e07d3864966b00d8ab81c1a5919.jpg][]

设置成“Release”编译方式

![31115334-c5925162e31c4ed89475b31a78b1fb69.jpg][]

### 2.2.3 Model项目 ###

**组件引用**

**目录划分**

**划分配置库（****ConfigModel****）、玩家信息库（****DataModel****）、玩家日志库（****LogModel****）和自定义类型数据实体（****Model****）目录存储数据实体类；****Enum****目录存储自定枚举；**

**DbConfig****类**

**在生成实体类时，生成配置****ConnectKey****项中使用**

![复制代码][copycode.gif]

public class DbConfig
    {
        public const string Config = "DemoConfig";
        public const string Data = "DemoData";
        public const string Log = "DemoLog";
        public const int GlobalPeriodTime = 0;
        public const int PeriodTime = 0;
        public const string PersonalName = "UserId";
    }
    //UserId：是玩家库中表的主键字段名称; 红色部分是需要修改的

![复制代码][copycode.gif]

项目建立完成如图：

![31115809-41df2d970cab4ef3924597839459d360.jpg][]

**实体静态注入配置**

用记事本打开Demo.Model.csproj文件，在结尾增加如下配置:

![复制代码][copycode.gif]

![复制代码][copycode.gif]

### 2.2.4 Lang项目 ###

**组件引用**

![31134137-792c5002d85f4d85b87fa384fb5fe3c1.jpg][]

负责处理多语言包配置，需要实现中层提供的语言包；以下是定义类

**LanguageManager****类**

![复制代码][copycode.gif]

public class LanguageManager
 {
 private static object thisLock = new object();
 private static Dictionary<LangEnum, IGameLanguage> _langTable = new Dictionary<LangEnum, IGameLanguage>();
 private static LangEnum _langEnum;
 
 static LanguageManager()
 {
 _langEnum = (ConfigUtils.GetSetting("LanguageType", "0")).ToEnum<LangEnum>();
 LanguageHelper.SetLang(_langEnum);
 }
 
 public static IGameLanguage GetLang()
 {
 return GetLang(_langEnum);
 }
 
 public static IGameLanguage GetLang(LangEnum langEnum)
 {
 IGameLanguage lang = null;
 if (!_langTable.ContainsKey(langEnum))
 {
 lock (thisLock)
 {
 if (!_langTable.ContainsKey(langEnum))
 {
 switch (langEnum)
 {
 case LangEnum.ZH_CN:
 _langTable.Add(langEnum, new GameZhLanguage());
 break;
 default:
 throw new Exception("Language is error.");
 }
 }
 }
 }
 lang = _langTable[langEnum];
 return lang;
 }
 
 }

![复制代码][copycode.gif]

**IGameLanguage****接口**

![复制代码][copycode.gif]

public interface IGameLanguage : ILanguage
 {
 #region
 /// <summary>
 /// 君主帐号
 /// </summary>
 int SystemUserId { get; }
 /// <summary>
 /// 玩家名称
 /// </summary>
 string KingName { get; }
 string Date_Yesterday { get; }
 string Date_BeforeYesterday { get; }
 string Date_Day { get; }
 string St1002_GetRegisterPassportIDError { get; }
 string St1005_NickNameOutRange { get; }
 string St1005_NickNameExistKeyword { get; }
 string St1005_NickNameExist { get; }
 string St1006_PasswordTooLong { get;}
 string St1006_ChangePasswordError { get;}
 string St1006_PasswordError { get;}
 string St1066_PayError { get; }
 
 #endregion
 }

![复制代码][copycode.gif]

**GameZhLanguage****类**

![复制代码][copycode.gif]

class GameZhLanguage : BaseZHLanguage, IGameLanguage
    {
        public int SystemUserId
        {
            get { return 1000000; }
        }
     
        public string KingName
        {
            get { return "系统"; }
        }
     
        public string Date_Yesterday { get { return "昨天"; } }
        public string Date_BeforeYesterday { get { return "前天"; } }
        public string Date_Day { get { return "{0}天前"; } }
    
        public string St1002_GetRegisterPassportIDError { get { return "获取注册通行证ID失败!"; } }
     
        public string St1005_NickNameOutRange { get { return "您的昵称输入有误，请重新输入!"; } }
        public string St1005_NickNameExistKeyword { get { return "您输入的昵称存在非法字符，请重新输入!"; } }
        public string St1005_NickNameExist { get { return "您输入的昵称已存在，请重新输入!"; } }
     
        public string St1006_PasswordTooLong { get { return "输入错误，请输入4-12位数字或字母!"; } }
        public string St1006_ChangePasswordError { get { return "修改密码失败!"; } }
        public string St1006_PasswordError { get { return "密码格式错误!"; } }
        public string St1066_PayError { get { return "充值失败"; } }

![复制代码][copycode.gif]

### 2.2.5 Com项目 ###

**组件引用**

划分中间件业务实体（Model），聊天组件（Chat）与排行榜（Rank）等目录，如图：

![21150815-ecc252401e374cc18f1761cb606fed87.png][]

需要使用中间层的功能，请参考《中间层使用文档》

### **2.2.6** **Bll****项目** ###

**组件引用**

![31134655-f3ea505a28814eb9836b71e3b693d890.jpg][]

**功能划分**

创建Action目录划分接口协议处理逻辑；主要提供中间层定义的固定协议接口，如：登录（1004）与建角（1005）及充值中间层接口

**ActionIDDefine****类**

![复制代码][copycode.gif]

public class ActionIDDefine
 {
 ///<summary>
 ///客户端注册Socket
 ///</summary>
 public const Int16 Cst_Action100 = 100;
 
 ///<summary>
 ///错误日志
 ///</summary>
 public const Int16 Cst_Action404 = 404;
 
 ///<summary>
 ///注册通行证ID获取接口
 ///</summary>
 public const Int16 Cst_Action1002 = 1002;
 
 ///<summary>
 ///用户注册
 ///</summary>
 public const Int16 Cst_Action1003 = 1003;
 
 ///<summary>
 ///用户登录
 ///</summary>
 public const Int16 Cst_Action1004 = 1004;
 
 ///<summary>
 ///创建角色
 ///</summary>
 public const Int16 Cst_Action1005 = 1005;
 }

![复制代码][copycode.gif]

**BaseAction****类**

![复制代码][copycode.gif]

public abstract class BaseAction : AuthorizeAction
    {
        protected BaseAction(short actionID, HttpGet httpGet)
            : base(actionID, httpGet)
        {
        }
     
        protected override bool IgnoreActionId
        {
            get
            {
                //排除不需要登录授权的协议接口
                return actionId == ActionIDDefine.Cst_Action404;
            }
        }
    }

![复制代码][copycode.gif]

### 2.2.7 HostServer项目 ###

**组件引用**

<table style="text-transform:none;text-indent:0px;border-collapse:collapse;font:13px/23px Verdana, Arial, Helvetica, sans-serif;letter-spacing:normal;color:#333333;word-spacing:0px;border:#C0C0C0 1px solid;"> 
 <tbody> 
 <tr> 
 <td style="border-collapse:collapse;border:#C0C0C0 1px solid;"> 项目 </td> 
 <td style="border-collapse:collapse;border:#C0C0C0 1px solid;"> 引用路径 </td> 
 </tr> 
 <tr> 
 <td style="border-collapse:collapse;border:#C0C0C0 1px solid;"> HostServer </td> 
 <td style="border-collapse:collapse;border:#C0C0C0 1px solid;"> LibNewtonsoft.Json.dll LibNLog.dll Lib\protobuf-net.dll &nbsp; Lib\IronPython.dll Lib\IronPython.Modules.dll Lib\Microsoft.Dynamic.dll Lib\Microsoft.Scripting.dll &nbsp; Lib\ServiceStack.dll Lib\&nbsp;ServiceStack.Common.dll Lib\&nbsp;ServiceStack.Interfaces.dll Lib\&nbsp;ServiceStack.Redis.dll Lib\&nbsp;ServiceStack.Text.dll &nbsp; Lib\ZyGames.Framework.Common.dll Lib\ZyGames.Framework.dll Lib\ZyGames.Framework.Plugin.dll Lib\ZyGames.Framework.RPC.dll Lib\ZyGames.Framework.Game.Lang.dll Lib\ZyGames.Framework.Game.dll Lib\&nbsp;ZyGames.Framework.Game.Contract.dll Model Lang Com Bll </td> 
 </tr> 
 </tbody> 
</table>

**功能划分**

**划分****PyScript****目录，存放****Python****脚本文件；层次如图：**

![21150953-4c23e8cd1ad547a780fed291c929748f.png][]

**Action****目录：处理请求与响应的脚本，可以协议生成器工具中****Copy****部分模板；**

**Lib****目录：****Python****中间层脚本，复制****Scut****开发包中的****PythonLib****目录；**

**Remote****：应用程序之间内通讯，访问时有****IP****访问限制；**

**Route.config.xml****：是请求路由配置表，格式如下：**

![复制代码][copycode.gif]

<?xml version="1.0" encoding="utf-8" ?>
 <config>
 
 <lib path="D:\Python\Lib" />
 <route-list>
 
 <route action="404" path="Action\action404.py"/>
 <route action="1009" path="Action\action1009.py"/>
 </route-list>
 </config>

![复制代码][copycode.gif]

**GameHostApp****类**

![复制代码][copycode.gif]

class GameHostApp : GameSocketHost
    {
        private static GameHostApp instance;
    
        static GameHostApp()
        {
            instance = new GameHostApp();
        }
    
        private GameHostApp()
        {
        }
    
        public static GameHostApp Current
        {
            get { return instance; }
        }
    
        protected override void OnConnectCompleted(object sender, ConnectionEventArgs e)
        {
            Console.WriteLine("Client:{0} connect to server.", e.Socket.RemoteEndPoint);
        }
    
    
        protected override void OnRequested(HttpGet httpGet, IGameResponse response)
        {
            try
            {
                ActionFactory.Request(httpGet, response, null);
            }
            catch (Exception ex)
            {
                Console.WriteLine("{0}", ex.Message);
            }
        }
    
        protected override void OnStartAffer()
        {
            try
            {
                //时º¡À间?间?隔?更¨¹新?库a
                int cacheInterval = 600;
                GameEnvironment.Start(cacheInterval, () => true);
                Console.WriteLine("The server is staring...");
            }
            catch (Exception ex)
            {
                TraceLog.WriteError("The server start error:{0}",ex);
            }
        }
    
        protected override void OnServiceStop()
        {
            GameEnvironment.Stop();
        }
    
    }

![复制代码][copycode.gif]

**Program****类**

![复制代码][copycode.gif]

static void Main(string[] args)
    {
        try
        {
            GameHostApp.Current.Start();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
            TraceLog.WriteError("HostServer error:{0}", ex);
        }
        finally
        {
            Console.WriteLine("Press any key to exit the listener!");
            Console.ReadKey();
            GameHostApp.Current.Stop();
        }
    }

![复制代码][copycode.gif]

**宿主程序****Config****配置**

![复制代码][copycode.gif]

<?xml version="1.0"?>
 <configuration>
 
 <configSections>
 <section name="zyGameBaseBll" type="ZyGames.Framework.Game.Configuration.ZyGameBaseBllSection,ZyGames.Framework.Game"/>
 <section name="zyGameBase-GM" type="ZyGames.Framework.Game.Command.GmSection,ZyGames.Framework.Game"/>
 <section name="sdkChannel" type="ZyGames.Framework.Game.Sns.Section.SdkChannelSection,ZyGames.Framework.Game"/>
 </configSections>
 <appSettings>
 
 <add key="Product.Code" value="1" />
 <add key="Product.Name" value="" />
 <add key="Product.ServerId" value="1" />
 <add key="Game.Port" value="9701" />
 
 
 
 <add key="Game.Action.AssemblyName" value="ZyGames.Demo.Bll"/>
 <add key="MessageQueuePath" value=".\private$\DemoCmdSql"></add>
 <add key="Product.SignKey" value="44CAC8ED53714BF18D60C5C7B6296000"/>
 <add key="PublishType" value="Debug"/>
 <add key="EnableGM" value="true"/>
 <add key="Python_IsDebug" value="true" />
 <add key="PythonRootPath" value="..\..\PyScript" />
 
 
 
 <add key="PayDB_ConnectionString" value="Data Source={0};Database=PayDB;{1}; Pooling=true;" />
 <add key="PayDB_Server" value="." />
 <add key="PayDB_Acount" value="39B30ED8D3FA3A3E5B3B4CA4F9039D55" />
 <add key="Snscenter_ConnectionString" value="Data Source={0};Database=snscenter;{1}; Pooling=true;" />
 <add key="Snscenter_Server" value="." />
 <add key="Snscenter_Acount" value="39B30ED8D3FA3A3E5B3B4CA4F9039D55" />
 
 </appSettings>
 <connectionStrings>
 <add name="DemoConfig" providerName="" connectionString="Data Source=.;Database=DemoConfig;Uid=sa;Pwd=123; Pooling=true;"/>
 <add name="DemoData" providerName="" connectionString="Data Source=.;Database=Demo1Data;Uid=sa;Pwd=123; Pooling=true;"/>
 <add name="DemoLog" providerName="" connectionString="Data Source=.;Database=Demo1Log;Uid=sa;Pwd=123; Pooling=true;"/>
 </connectionStrings>
 
 
 <zyGameBaseBll>
 <login defaultType="ZyGames.Framework.Game.Sns.Login36you,ZyGames.Framework.Game">
 <retailList>
 <add id="0000" type="ZyGames.Framework.Game.Sns.Login36you,ZyGames.Framework.Game" args="Pid,Pwd,DeviceID"/>
 </retailList>
 </login>
 </zyGameBaseBll>
 
 <zyGameBase-GM>
 <command>
 
 </command>
 </zyGameBase-GM>
 
 <startup>
 <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
 </startup>
 </configuration>

![复制代码][copycode.gif]

## 2.3 定义协议 ##

打开协议生成器工具，增加一个“Demo”项目方案，接着在增加协议（或从现有项目中Copy相同的接口协议），接着定义客户端提供的请求参数和服务器下发的参数（支持多行的格式，字段类型：Record与End组合）；定义好客户端与服务器之前通讯的接口后，使用自动生成的服务端Python代码（客户端使用Lua脚本代码）复制到已创建的Python接口文件，如图：

![31135324-386c17293be2448db189ee2d8dd15d4d.jpg][]

**开源地址**  
**GitHub地址**：[https://github.com/ScutGame][https_github.com_ScutGame]

转载于:https://www.cnblogs.com/lancidie/p/3412417.html

[21145241-a6845fa527e047b5942be0a7e1146e83.png]: /images/20211220/6f18853ba50740b2bff1e5617b189f2a.png
[31115038-bd5c9ab1bb3a489cae4b806fc0c0cb9d.jpg]: /images/20211220/eb737ab2cdb14fe1baf23d474792f8a1.png
[31115206-05f43dfa0b5c4aad97301c4a52561f88.jpg]: /images/20211220/22806b77321246e9aa09b7baeb7a5026.png
[31115221-62a27fadec314b4da1d85e1aff526068.jpg]: /images/20211220/4d83ac67c461481384c18299cbbfc388.png
[31115245-e637630c59574ef5bee31581ecff2cbb.jpg]: /images/20211220/f6408f3ccb104a029a3fe8a143da8090.png
[31115314-dda13e07d3864966b00d8ab81c1a5919.jpg]: /images/20211220/3147f3bd0f3845028fb547899fe4b476.png
[31115334-c5925162e31c4ed89475b31a78b1fb69.jpg]: /images/20211220/ee2eab932db9458ea320fc96b191d94e.png
[copycode.gif]: /images/20211220/eb9c07e8f70943a9b11bb12eec04fc97.png
[31115809-41df2d970cab4ef3924597839459d360.jpg]: /images/20211220/9493258e833c44f08f43b7d197db853f.png
[31134137-792c5002d85f4d85b87fa384fb5fe3c1.jpg]: /images/20211220/de4796ab0c684d47b519a93ce2bc1893.png
[21150815-ecc252401e374cc18f1761cb606fed87.png]: /images/20211220/911246ece2ec4de9b885983f2eacb1d5.png
[31134655-f3ea505a28814eb9836b71e3b693d890.jpg]: /images/20211220/e8978692774d46e8bccb1a27d96b6c9d.png
[21150953-4c23e8cd1ad547a780fed291c929748f.png]: /images/20211220/75f64a165c244f5b8308715058146596.png
[31135324-386c17293be2448db189ee2d8dd15d4d.jpg]: /images/20211220/792c299fa0294c3381c3ad3547872bb0.png
[https_github.com_ScutGame]: https://github.com/ScutGame