.net core下使用FastHttpApi構建web聊天室

一般在dotnet core下構建使用web服務應用都使用asp.net core,但通過FastHttpApi組建也可以方便地構建web服務應用，在FastHttpApi功能的支持下構建多人聊天室是件非常簡單的事情，通過組件並不需要了解WebSocket知識即可簡單構建，以下講解一下通過FastHttpApi如何構建一個簡單的多人聊室。

創建項目

使用FastHttpApi構建一個WEB服務只需要創建一個普通ConsoleApp( 控制台應用) 

創建項目后需要在Nuget中添加引用FastHttpApi

只需要簡單地引用Beetlex.FastHttpApi即可構建基於Http和Websocket通訊應用。

創建邏輯

FastHttpApi對類和方法沒有太多規則約束，只需要在類上定義一個Controller標簽即可，接下來實現一個簡單的web聊天室

    [Controller]
    public class Controller
    {
        //用戶登陸
        public bool Login(string nickName, IHttpContext context)
        {
            context.Session.Name = nickName;
            ActionResult result = new ActionResult();
            result.Data = new { name = nickName, message = "login", type = "login", time = DateTime.Now.ToString("T") };
            context.SendToWebSocket(result);
            return true;
        }
        //獲取在線用戶
        public object ListOnlines(IHttpContext context)
        {
            return from r in context.Server.GetWebSockets()
                   where r.Session.Name != null
                   select new { r.Session.Name, IP = r.Session.RemoteEndPoint.ToString() };
        }

        //發送聊天信息
        public bool Talk(string nickName, string message, IHttpContext context)
        {
            ActionResult result = new ActionResult();
            result.Data = new { name = nickName, message, type = "talk", time = DateTime.Now.ToString("T") };
            context.SendToWebSocket(result);
            return true;
        }
    }

以上代碼分別定義登陸，獲取在線用戶和alk方法，方法的定義同樣也是沒有約束性，對於IHttpContext這些參數都是根據自己需要定義，如果不需要則不用在方法中定義它。接下來的事情就是要在頁面上調用它，大家知道在頁面調用http或websocket 需要定義一些代碼和指定相應的URL。但Beetlex.FastHttpApi提供一個非常便利的方式，通過安裝一個插件可以自動生成這些代碼插件安裝介紹(暫只支持vs2017).當插件安裝完成后只需要設置類文件的自定義工具即可

插件會在當前類文下生成一個js文件，文件里把調用方法的URL和參數都定義完成

var $Login$url='/login';
function $Login(nickName,useHttp)
{
    return api($Login$url,{nickName:nickName},useHttp).sync();
}
function $Login$async(nickName,useHttp)
{
    return api($Login$url,{nickName:nickName},useHttp);
}
var $ListOnlines$url='/listonlines';
function $ListOnlines(useHttp)
{
    return api($ListOnlines$url,{},useHttp).sync();
}
function $ListOnlines$async(useHttp)
{
    return api($ListOnlines$url,{},useHttp);
}
var $Talk$url='/talk';
function $Talk(nickName,message,useHttp)
{
    return api($Talk$url,{nickName:nickName,message:message},useHttp).sync();
}
function $Talk$async(nickName,message,useHttp)
{
    return api($Talk$url,{nickName:nickName,message:message},useHttp);
}

這個文件非常簡單，主要包括URL，同步方法和異步方法。這個js文件需要依賴FastHttpApi.js才能使用，所以在頁面上必須把這個文件也引用上。接下來就是頁面腳本的使用

   <script>
        function receive(result) {
            if (result.Data.type == 'login' || result.Data.type == 'quit') {
                $ListOnlines$async().execute(function (result) {
                    listUserControl.Data = result.Data;
                });
            }
            messages.push(result.Data);
            var objDiv = document.getElementById("lstTalk");
            objDiv.scrollTop = objDiv.scrollHeight;
        }

        async function sendMessage() {
            var msg = $('#talkMsg').val();
            if (!msg) {
                alert("enter message");
                return;
            }

            var result = await $Talk(nickName, msg);
            if (result.Code != 200)
                alert(result.Error);
            else
                $('#talkMsg').val('');

        }
        async function login() {
            nickName = $('#userName').val();
            if (!nickName) {
                alert("enter you name!")
                return;
            }
            var result = await $Login(nickName);
            if (result.Code == 200) {
                $('#loginBar').hide();
                $('#talkBar').show();
            }
            else {
                alert(result.Error);
            }
        }
    </script>

引用腳本后，直接通過方法調用即可，這種明確的方法調用比傳統的jquery.post有着調用的明確性和便利性，讓使用者不需要查看接口文檔即可以知道方法的調用參數。如果控制器定了XML幫助注釋，插件同樣也會把注釋生成到腳本中。

靜態文件存儲

組件通過固定的目錄來存放靜太資源，因此項目需要創建一個views目錄來存儲靜態資源，views目錄是web服務的根目錄。

由於靜態文件默認情況是不會被編譯處理，所以我們需要把文件設置成編譯嵌入模式或復制到輸出目錄中。如果是復制到輸出目錄下，可以在項目生成事件中添加一段復制代碼。

啟動服務

組件啟動服務很簡單，不過在啟動前需要注冊一下程序集，把控制器注冊到HTTP服務中。

        static void Main(string[] args)
        {
            mApiServer = new BeetleX.FastHttpApi.HttpApiServer();
            mApiServer.Debug();//只有在Debug模式下生產，把靜態資源加載目錄指向項目的views目錄
            mApiServer.Register(typeof(Program).Assembly);//加載程序集中所有控制器信息和靜態資源信息
            mApiServer.Open();
            Console.Write(mApiServer.BaseServer);
            Console.Read();
        }

 

組件默認是不需要配置即可啟動HTTP服務，默認端口是9090.不過這些信息也是可以通過配置文件加載，只要程序目錄存在HttpConfig.json文件組件即會加載配置文件中的配置信息來運行服務。配置文件詳解

這樣一個簡單多人web聊天室就完成，運行效果如下： 

在線演示

詳細代碼