U3D客户端框架之实现基于UnityWebRequest的Http服务 实现HttpCallBackArgs参数类、HttpRoutine访问器、HttpManager管理器

简介: Unity3D 在2018版本中弃用了WWW请求,使用UnityWebRequest 进行网络请求,这个方法是为了满足今天的 HTTP 通信的需求,而且诞生的新类,相对于WWW这个方法,会更灵活一些,但是用起来却很不方便。

1 Http服务 访问器设计思路


Unity3D 在2018版本中弃用了WWW请求,使用UnityWebRequest 进行网络请求,这个方法是为了满足今天的 HTTP 通信的需求,而且诞生的新类,相对于WWW这个方法,会更灵活一些,但是用起来却很不方便。


所以我将UnityWebRequest封装了一下。封装的目的有两个:1.封装后访问Http用着方便;2.在框架层上隔离原生API和具体业务,即使后续API变更也不会影响到业务逻辑,避免业务受影响。


f6163a07944372471e8690b777b2638e.png


2 代码实现


Get和Post的区别可以看 引用模块中 Get和Post对比的链接,那篇文章中详细讲解了Get和Post的异同和使用场景。


HttpCallBackArgs:Http请求的回调数据,包装了是否有错、返回值、数据Bytes数组;说明一下HttpCallBackArgs继承EventArgs,是为了准守规范,让看代码的人一看到这个类型,就知道这是一个事件类型,使用的时候直接吧EventArgs转换成具体的事件参数类即可。


HttpCallBackArgs.cs 代码实现


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Myh
{
    //http请求的回调数据
    public class HttpCallBackArgs : EventArgs
    {
        //是否有错(是否发生了错误)
        public bool HasError;
        //返回值 
        public string Value;
        //字节数据 
        public byte[] Data;
    }
}


HttpRoutine:Http访问Url的轮询器,核心代码的所在文件;内部实现了GetUrl、PostUrl,状态监测、回调处理、对失败情况下的重试逻辑


HttpRoutine.cs 代码实现


using LitJson;
using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using UnityEngine;
using UnityEngine.Networking;
using YouYou;
namespace Myh
{
    //Http发送数据的回调委托 
    public delegate void HttpSendDataCallBack(HttpCallBackArgs args);
    //Http访问器
    public class HttpRoutine
    {
        //Http请求回调
        private HttpSendDataCallBack m_CallBack;
        //Http请求回调数据
        private HttpCallBackArgs m_CallBackArgs;
        //是否繁忙
        public bool IsBusy
        {
            get;
            private set;
        }
        //当前重试次数(尝试重新访问次数?)
        public int m_CurrRetry = 0;
        //URL
        private string m_Url;
        //是否是Get
        private bool m_IsGetData = false;
        //是否是Post
        private bool m_IsPost = false;
        //发送的数据
        private Dictionary<string, object> m_Dic;
        public HttpRoutine()
        {
            m_CallBackArgs = new HttpCallBackArgs();
        }
        #region SendData 发送Web数据
        public void SendData(string url, HttpSendDataCallBack cb, bool isPost = false,
                             bool isGetData = false, Dictionary<string, object> dic = null)
        {
            if (IsBusy)
                return;
            m_Url = url;
            m_CallBack = cb;
            m_IsPost = isPost;
            m_IsGetData = isGetData;
            m_Dic = dic;
            SendData();
        }
        private void SendData()
        {
            //不是post模式
            if (!m_IsPost)
            {
                GetUrl(m_Url);
            }
            else
            {
                //把数据存到字典里
                if (m_Dic != null)
                {
                    //设备唯一Id
                    m_Dic["deviceIdentifier"] = DeviceUtil.DeviceIdentifier;
                    //设备型号
                    m_Dic["deviceModel"] = DeviceUtil.DeviceModel;
                    //服务器时间 TODO:
                    //还没有和服务器同步时间,暂时先用本地时间
                    long t = DateTime.Now.Ticks;
                    //用当前服务器时间 和 设备id 算一个md5出来 作为本地请求的签名(签名具有时效性,超时无效)
                    string md5 = string.Format("{0}:{1}",t,DeviceUtil.DeviceIdentifier);
                    m_Dic["sign"] = EncryptUtil.Md5(md5);
                    //时间戳
                    m_Dic["t"] = t;
                }
                string json = string.Empty;
                if (m_Dic != null)
                {
                    json = JsonMapper.ToJson(m_Dic);
                    //不是get的方式
                    if (!m_IsGetData)
                    {
#if DEBUG_LOG_PROTO && DEBUG_MODEL
                        GameEntry.Log(LogCategory.Proto, "<color=#ffa200>发送消息:</color><color=#FFFB80>" + m_Url + "</color>");
                        GameEntry.Log(LogCategory.Proto, "<color=#ffdeb3>==>>" + json + "</color>");
#endif 
                    }
                    GameEntry.Pool.EnqueueClassObject(m_Dic);
                }
                PostUrl(m_Url,json);
            }
        }
        #endregion
        #region GetUrl Get请求
        //Get请求
        private void GetUrl(string url)
        {
            UnityWebRequest request = UnityWebRequest.Get(url);
            YouYou.GameEntry.Instance.StartCoroutine(Request(request));
        }
        #endregion
        #region PostUrl Post请求
        //Post请求
        private void PostUrl(string url, string json)
        {
            //定义一个表单
            WWWForm form = new WWWForm();
            //给表单添加值
            form.AddField("json",json);
            //把url 和表单传入进去
            UnityWebRequest request = UnityWebRequest.Post(url,form);
            GameEntry.Instance.StartCoroutine(Request(request));
        }
        #endregion
        #region Request 请求服务器
        /*
         * 功能:请求Web服务器
         * request:UnityWebRequest请求的实体
         */
        private IEnumerator Request(UnityWebRequest request)
        {
            //阻塞方法  和目标服务器建立连接,返回结果后才继续下一步
            yield return request.SendWebRequest();
            //如果有错误,重试与目标服务器连接(通信)
            if (request.isNetworkError || request.isHttpError)
            {
                //报错了进行重试
                if (m_CurrRetry > 0)
                {
                    //过一段时间后再重新判断
                    yield return new WaitForSeconds(GameEntry.Http.RetryInterval);
                }
                //重试次数+1
                ++m_CurrRetry;
                //如果<=配置的重试次数
                if (m_CurrRetry <= GameEntry.Http.Retry)
                {
#if DEBUG_LOG_PROTO && DEBUG_MODEL
                    //通过宏开关,决定要不要打印log
                    GameEntry.Log(LogCategory.Proto, "<color=#00eaff>请求URL:</color> <color=#00ff9c>{0}失败 当前重试次数{1}</color>", m_Url, m_CurrRetry);
#endif
                    //调用SendData,重新发送数据
                    SendData();
                    //结束本次携程
                    yield break;
                }
                //超过次数了,状态设置成有错误
                IsBusy = false;
                if (null != m_CallBack)
                {
                    m_CallBackArgs.HasError = true;
                    m_CallBackArgs.Value = request.error;
                    //不是GetData 方式的话 打印一个log
                    if (!m_IsGetData)
                    {
#if DEBUG_LOG_PROTO && DEBUG_MODEL
                        GameEntry.Log(LogCategory.Proto, "<color=#00eaff>接收消息:</color> <color=#00ff9c>" + request.url + "</color>");
                        GameEntry.Log(LogCategory.Proto, "<color=#c5e1dc>==>>" + JsonUtility.ToJson(m_CallBackArgs) + "</color>");
#endif
                    }
                    m_CallBack(m_CallBackArgs);
                }
            }
            //与主机建立连接
            else
            {
                IsBusy = false;
                if(null!=m_CallBack)
                {
                    m_CallBackArgs.HasError = false;
                    m_CallBackArgs.Value = request.downloadHandler.text;
                    if (!m_IsGetData)
                    {
#if DEBUG_LOG_PROTO && DEBUG_MODEL
                        GameEntry.Log(LogCategory.Proto, "<color=#00eaff>接收消息:</color> <color=#00ff9c>" + request.url + "</color>");
                        GameEntry.Log(LogCategory.Proto, "<color=#c5e1dc>==>>" + JsonUtility.ToJson(m_CallBackArgs) + "</color>");
#endif
                    }
                    m_CallBackArgs.Data = request.downloadHandler.data;
                    m_CallBack(m_CallBackArgs);
                }
            }
            //重试完毕,或者下载完毕
            m_CurrRetry = 0;
            m_Url = null;
            if (null != m_Dic)
            {
                m_Dic.Clear();
                m_Dic = null;
            }
            m_CallBackArgs.Data = null;
            request.Dispose();
            request = null;
            //把Http访问器回池
            GameEntry.Pool.EnqueueClassObject(this);
        }
        #endregion
    }
}


HttpManager:Http服务器的管理类,记录了账号服务器的Url,通过HttpManager开启HttpRoutine。


HttpManager.cs 代码实现


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Myh
{
    public class HttpManager : ManagerBase, IDisposable
    {
        //正式服 账号服务器url
        private string m_WebAccountUrl;
        //测试服 账号服务器url
        private string m_TestWebAccountUrl;
        //是否是测试环境
        private bool m_IsTest;
        //真实账号服务器Url
        public string RealWebAccountUrl
        {
            get
            {
                return m_IsTest ? m_TestWebAccountUrl : m_WebAccountUrl;
            }
        }
        //连接失败后重试次数
        public int Retry
        {
            get;
            private set;
        }
        //连接失败后重试间隔(单位:秒)
        public float RetryInterval
        {
            get;
            private set;
        }
        public override void Init()
        {
            //TODO:这些应该都要从设置里读取,可是现在没有,到时候回来改
            m_WebAccountUrl = "";
            m_TestWebAccountUrl = "";
            m_IsTest = true;
            Retry = 5;
            RetryInterval = 2f;
        }
        public void SendData(string url, HttpSendDataCallBack cb, bool isPost = false, 
                             bool isGetData = false, Dictionary<string, object> dic = null)
        {
            //从类对象池里,获取http访问器
            HttpRoutine httpRoutine = YouYou.GameEntry.Pool.DequeueClassObject<HttpRoutine>();
            httpRoutine.SendData(url, cb, isPost, isGetData, dic);
        }
        public void Dispose()
        {
        }
    }
}


3 代码测试


Get访问网页会把网页内的Html代码读出来;Getzip会把zip下载下来。


using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Myh;
using YouYou;
using UnityEngine;
public class TestHttp : ITest
{
    private void TestGetWebUrl()
    {
        GameEntry.Http.SendData("https://www.baidu.com", (HttpCallBackArgs args) =>
        {
            GameEntry.Log(LogCategory.Normal, "httpCallbackArgs hasError:{0} Value:{1} data str:{2}",
                args.HasError, args.Value, Encoding.UTF8.GetString(args.Data));
        });
    }
    private void TestGetDownloadUrl()
    {
        //从web站点上下载eee.zip文件
        GameEntry.Http.SendData("https://www.xxx.com/s/eee.zip", (HttpCallBackArgs args) =>
        {
            GameEntry.Log(LogCategory.Normal, "httpCallbackArgs hasError:{0} Value:{1} data str:{2}",
                args.HasError, args.Value, Encoding.UTF8.GetString(args.Data));
        });
    }
    public void OnTestStart()
    {
    }
    public void OnTestUpdate()
    {
        if (Input.GetKeyDown(KeyCode.Q))
        {
            TestGetWebUrl();
        }
        else if (Input.GetKeyDown(KeyCode.E))
        {
            TestGetDownloadUrl();
        }
    }
}


4 引用


Get和Post对比:HTTP请求中Get和Post的区别是什么?_天才小熊猫oo的博客-CSDN博客

相关文章
|
10天前
|
JSON Java Apache
非常实用的Http应用框架,杜绝Java Http 接口对接繁琐编程
UniHttp 是一个声明式的 HTTP 接口对接框架,帮助开发者快速对接第三方 HTTP 接口。通过 @HttpApi 注解定义接口,使用 @GetHttpInterface 和 @PostHttpInterface 等注解配置请求方法和参数。支持自定义代理逻辑、全局请求参数、错误处理和连接池配置,提高代码的内聚性和可读性。
|
1月前
使用Netty实现文件传输的HTTP服务器和客户端
本文通过详细的代码示例,展示了如何使用Netty框架实现一个文件传输的HTTP服务器和客户端,包括服务端的文件处理和客户端的文件请求与接收。
43 1
使用Netty实现文件传输的HTTP服务器和客户端
|
27天前
|
前端开发 JavaScript 中间件
前端全栈之路Deno篇(四):Deno2.0如何快速创建http一个 restfulapi/静态文件托管应用及oak框架介绍
Deno 是由 Node.js 创始人 Ryan Dahl 开发的新一代 JavaScript 和 TypeScript 运行时,旨在解决 Node.js 的设计缺陷,具备更强的安全性和内置的 TypeScript 支持。本文介绍了如何使用 Deno 内置的 `Deno.serve` 快速创建 HTTP 服务,并详细讲解了 Oak 框架的安装和使用方法,包括中间件、路由和静态文件服务等功能。Deno 和 Oak 的结合使得创建 RESTful API 变得高效且简便,非常适合快速开发和部署现代 Web 应用程序。
|
1月前
|
JSON Java fastjson
Java Http 接口对接太繁琐?试试 UniHttp 框架吧
UniHttp 是一个声明式的 HTTP 接口对接框架,旨在简化第三方 HTTP 接口的调用过程。通过注解配置,开发者可以像调用本地方法一样发起 HTTP 请求,无需关注请求的构建和响应处理细节。框架支持多种请求方式和参数类型,提供灵活的生命周期钩子以满足复杂的对接需求,适用于企业级项目的快速开发和维护。GitHub 地址:[UniAPI](https://github.com/burukeYou/UniAPI)。
|
2月前
|
存储 JSON Go
在Gin框架中优雅地处理HTTP请求体中的JSON数据
在Gin框架中优雅地处理HTTP请求体中的JSON数据
|
1月前
|
Java 数据处理 开发者
Java Http 接口对接太繁琐?试试 UniHttp 框架~
【10月更文挑战第10天】在企业级项目开发中,HTTP接口对接是一项常见且重要的任务。传统的编程式HTTP客户端(如HttpClient、Okhttp)虽然功能强大,但往往需要编写大量冗长且复杂的代码,这对于项目的可维护性和可读性都是一个挑战。幸运的是,UniHttp框架的出现为这一问题提供了优雅的解决方案。
70 0
|
1月前
|
资源调度 编译器 Linux
Windows10系统安装Truffle框架,安装失败,提示:error An unexpected error occurred: “https://xxxxx
Windows10系统安装Truffle框架,安装失败,提示:error An unexpected error occurred: “https://xxxxx
76 0
|
3月前
|
机器学习/深度学习 Ubuntu Linux
在Linux中,如何按照该要求抓包:只过滤出访问http服务的,目标ip为192.168.0.111,一共抓1000个包,并且保存到1.cap文件中?
在Linux中,如何按照该要求抓包:只过滤出访问http服务的,目标ip为192.168.0.111,一共抓1000个包,并且保存到1.cap文件中?
|
3月前
|
XML 安全 Android开发
Flutter配置Android和IOS允许http访问
Flutter配置Android和IOS允许http访问
119 3
|
3月前
|
开发者 Python
深入解析Python `httpx`源码,探索现代HTTP客户端的秘密!
深入解析Python `httpx`源码,探索现代HTTP客户端的秘密!
89 1
下一篇
无影云桌面