BeetleX.FastHttpApi 搭建应用程序微服务

园子里有同学介绍 BeetleX.FastHttpApi 组件，可以在应用程序或服务中搭建 web 服务，看起来挺强大的。通过 html + css + js 做为应用程序UI ，winform 做为后端，完美替代 WPF + WCF。搭建要点如下:

1. BeetleX.FastHttpApi 通过 Nuget 包管理器获取。其宿主环境需运行在 .net framework 4.6.1 以上版本。

2. 官方示例下载地址：

https://github.com/IKende/FastHttpApi/tree/master/samples/WinWebSample

控制器示例下载地址:

https://github.com/IKende/FastHttpApi/tree/master/samples/HttpApiServer.HttpAndWebsocketApi

3.web 服务器默认将 views 文件夹做为 root 目录 , 通过 HttpOptions.StaticResourcePath 参数值调整 root 路径，也可通过 HttpApiServer.Debug 调整该参数。

4.BeetleX.FastHttpApi 启动时，会将包含 Controller 属性类都做为控制器方法，通过 BaseUrl 指定调用方法路径。

控置器与前端脚本交互示例:

[Controller(BaseUrl = "course/")]
public class WebAction
{

    public object GetStarted(string email)
    {
        return new TextResult($"{email} {DateTime.Now}");
    }
    
    [NotAction]
    public void Init(BeetleX.FastHttpApi.HttpApiServer server,string path)
    {
        mServer = server;
    }

    [Post]
    public bool EditEmployee(int id,Employee emp, IHttpContext context)
    {
        Employee record = mEmployees.Find(e => e.EmployeeID == id);
        if (record != null)
        {
            record.City = emp.City; 
            record.Address = emp.Address;
            record.Title = emp.Title;
            record.HomePhone = emp.HomePhone;
            return true;
        }
        return false;
    }    
}

前端调用:

    function GetStarted(email) {
            $.get('/course/GetStarted?email=' + email, function (result) {
                alert(result);
            });
        }

Controller 类，设置 SingleInstance 可配置为单例模式 , BaseUrl 设定路由地址。

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Interface)]
    public class ControllerAttribute : Attribute
    {
        public string BaseUrl
        {
            get;
            set;
        }

        public bool SingleInstance
        {
            get;
            set;
        }

        public ControllerAttribute()
        {
            SingleInstance = true;
        }
    }

5. 在 winform 中通过 WebBrower 访问Web 服务，可通过如下方法设置IE 版本，否则默认 WebBrower 版本是 IE7 。

  private void SetIE()
        {
            int BrowserVer, RegVal;
            BrowserVer = webBrowser1.Version.Major;
            if (BrowserVer >= 11)
                RegVal = 11001;
            else if (BrowserVer == 10)
                RegVal = 10001;
            else if (BrowserVer == 9)
                RegVal = 9999;
            else if (BrowserVer == 8)
                RegVal = 8888;
            else
                RegVal = 7000;
            string productName = AppDomain.CurrentDomain.SetupInformation.ApplicationName;//获取程序名称
            RegistryKey key = Registry.CurrentUser;
            RegistryKey software =
                key.CreateSubKey(
                    @"Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION\" + productName);
            if (software != null)
            {
                software.Close();
                software.Dispose();
            }
            RegistryKey wwui =
                key.OpenSubKey(
                    @"Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION", true);
            if (wwui != null) wwui.SetValue(productName, RegVal, RegistryValueKind.DWord);
            webBrowser1.Url = new Uri("http://192.168.1.178:12345");
        }

6.在应用程序根目录添加 HttpConfig.json做为服务初使化配置，注意通过 Host 可限制网络访问权限。

{
  "HttpConfig": {
    "Host": "0.0.0.0",
    "Port": 12345,
    "SSL": false,
    "CertificateFile": "",
    "CertificatePassword": "",
    "MaxBodyLength": 20097152,
    "OutputStackTrace": true,
    "StaticResurceType": "xml;svg;woff;woff2;jpg;jpeg;gif;png;js;html;htm;css;txt;ico;zip;rar",
    "DefaultPage": "index.html;index.htm",
    "NotLoadFolder": "\\Files;\\Images;\\Data",
    "NoGzipFiles": "xml;svg;woff;woff2;jpg;jpeg;gif;png;js;html;htm;css;txt;ico;zip;rar",
    "CacheFiles": "",
    "BufferSize": 8192,
    "WebSocketMaxRPS": 2000,
    "WriteLog": true,
    "LogToConsole": true,
    "LogLevel": "Warring"
  }
}

BeetleX.FastHttpApi 搭建应用程序微服务

猜你喜欢