支持所有JavaScript运行时的HTTP网络库-Fly.js

fly.png

Fly.js 的定位是成为 Javascript http请求的终极解决方案,也就是说,在任何能够执行 Javascript 的环境,只要具有访问网络的能力,Fly都能运行在其上,并提供统一的Promise based API。

Github: github.com/wendux/fly

已支持的平台

Fly.js 官方支持的Javascript运行时包括:浏览器、node、微信小程序。这意味着你可以在这些平台使用同一份代码来发起http请求。值得一提是集成到web应用时(浏览器环境), fly.js的大小只有4.7KB, 非常轻量。

统一的用户层API

Fly.js 支持的JavaScript运行时是不同的,但提供的用户层API是统一的,API是基于Promise的,风格和 axios 很像(但不完全相同),下面看几个例子:

发起GET请求

var fly=require("flyio")
//通过用户id获取信息,参数直接写在url中
fly.get('/user?id=133')
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

//query参数通过对象传递
fly.get('/user', {
      id: 133
  })
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

发起POST请求

fly.post('/user', {
    name: 'Doris',
    age: 24
    phone:"18513222525"
  })
  .then(function (response) {
    console.log(response);
  })
  .catch(function (error) {
    console.log(error);
  });

发起多个并发请求

function getUserRecords() {
  return fly.get('/user/133/records');
}

function getUserProjects() {
  return fly.get('/user/133/projects');
}

fly.all([getUserRecords(), getUserProjects()])
  .then(fly.spread(function (records, projects) {
    //两个请求都完成
  }))
  .catch(function(error){
    console.log(error)
  })

…….

上面只是Fly.js的简单使用,Fly.js 除了支持Promise风格的API之外,另外还支持:

  1. 支持请求/响应拦截器。
  2. 自动转换 JSON 数据。
  3. 浏览器端支持全局Ajax拦截。
  4. API支持typeScript。
  5. 支持请求配置
  6. H5页面内嵌到原生 APP 中时,支持将 http 请求转发到 Native,支持直接请求图片。

详细的文档请参考 github fly .

支持多平台的原理

Fly 引入了Http Engine 的概念,所谓 Http Engine,就是真正发起 http 请求的引擎,这在浏览器中一般都是XMLHttpRequest,而在其它JavaScript运行时下,需要提供相应平台的Http Engine,Fly 正是通过切换不同平台的 Http Engine 而实现同时支持不同JavaScript运行时的 。

Http Engine 是一个标准的接口协议,内部实现了真正的HTTP请求逻辑,不同JavaScript运行时只需要实现Http Engine的接口协议,就可以无缝集成到Fly.js中。

如何支持新的JavaScript运行时

如上所述,要支持新的JavaScript运行时时,我们需要实现该平台下的Http Engine即可,但是从头实现一个Http Engine 是非常复杂的,为此,Fly 官方提供了一个 EngineWrapper 帮助工具,它可以通过一个adapter(适配器)生成一个完整的 Http Engine,所以,我们只需要实现一个adapter就行。

一个简单的例子

var engine= EngineWrapper(function (request,responseCallback) {
            responseCallback({
                statusCode:200,
                responseText:"你变或者不变,我都不变😜。",
                extraFeild:"自定义字段"
            })
        })
fly.engine=engine;

fly.get("../package.json").then(d=>{
    log(d.data)
    log(d.extraFeild)
})

控制台输出

> 你变或者不变,我都不变😜。
> 自定义字段

EngineWrapper的参数就是adapter, 在这个例子中,adapter 并没有真正发起 http 请求,而是直接返回了固定内容,这样 fly 上层请求任何接口收到的内容永远都是相同的。完整的示例请移步:Fly.js-Http Engine .

远程Http Engine

我们说过,在浏览器环境中,fly 使用的默认engine 就是 XMLHttpRequest。现在我们想想混合APP, 如果能在 Native(Android、IOS) 上实现一个engine,然后供浏览器中的 fly 使用,那么也就会将原本应该在浏览器中发起的请求重定向到了 Native 上。而这个在 Native 上实现的 engine,我们称其为远程 Http Engine,这是因为调用者和执行者并不在同一个环境。

通过远程Http Engine, Fly.js可以实现一个逆天的功能--请求重定向。它可以将本来会在浏览器中发起的http请求重定向到Native, 这样就可以在Native 上进行统一的请求管理、cookie同步、证书检验、缓存和访问控制等,详细的内容请参考: Fly.js 请求重定向

最后

贴出Fly.js的Github源码地址:https://github.com/wendux/fly , 详细的文档请移步github, 如果你喜欢Fly.js,欢迎star.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,875评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,569评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,475评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,459评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,537评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,563评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,580评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,326评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,773评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,086评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,252评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,921评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,566评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,190评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,435评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,129评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,125评论 2 352

推荐阅读更多精彩内容