学习RxJS:Cycle.js

综合编程 2016-06-16

是什么

Cycle.js 是一个极简的JavaScript框架(核心部分加上注释125行),提供了一种函数式,响应式的人机交互接口(以下简称 HCI ):

函数式

Cycle.js 把应用程序抽象成一个纯函数 main() ,从外部世界读取副作用( sources ),然后产生输出( sinks ) 传递到外部世界,在那形成副作用。这些外部世界的副作用,做为Cycle.js的插件存在(drivers),它们负责:处理DOM、提供HTTP访问等。

响应式

Cycle.js 使用 rx.js 来实现关注分离,这意味着应用程序是基于事件流的,数据流是 Observable 的:

HCI

HCI 是双向的对话,人机互为观察者:

在这个交互模型中,人机之间的信息流互为输出输出,构成一个循环,也即 Cycle这一命名所指,框架的Logo更是以莫比乌斯环贴切的描述了这个循环。

唯一的疑惑会是:循环无头无尾,信息流从何处发起?好问题,答案是:

However, we need a .startWith() to give a default value. Without this, nothing would be shown! Why? Because our sinks is reacting to sources , but sources is reacting to sinks . If no one triggers the first event, nothing will happen. —— via examples

有了 .startWith() 提供的这个初始值,整个流程得以启动,自此形成一个闭环,一个事件驱动的永动机

Drivers

driver 是 Cycle.js 主函数 main() 和外部世界打交道的接口,比如HTTP请求,比如DOM操作,这些是由具体的driver 负责的,它的存在确保了 main() 的纯函数特性,所有副作用和繁琐的细节皆由 driver来实施——所以 @cycle/core 才125 行,而 @cycle/dom 却有 4052 行之巨。

driver也是一个函数,从流程上来说,driver 监听 sinksmain() 的输出)做为输入,执行一些命令式的副作用,并产生出 sources 做为 main() 的输入。

DOM Driver

即 @cycle/dom,是使用最为频繁的driver。实际应用中,我们的 main() 会与DOM进行交互:

  • 需要传递内容给用户时, main() 会返新的DOM sinks,以触发 domDriver() 生成 virtual-dom ,并渲染
  • main() 订阅 domDriver() 的输出值(做为输入),并据此进行响应

组件化

每个Cycle.js应用程序不管多复杂,都遵循一套输入输出的基本法,因此,组件化是很容易实现,无非就是函数对函数的组合调用

实战

准备工作

安装全局模块

npminstall -g http-server

依赖模块一览

"devDependencies": {
  "babel-plugin-transform-react-jsx": "^6.8.0",
  "babel-preset-es2015": "^6.9.0",
  "babelify": "^7.3.0",
  "browserify": "^13.0.1",
  "uglifyify": "^3.0.1",
  "watchify": "^3.7.0"
},
"dependencies": {
  "@cycle/core": "^6.0.3",
  "@cycle/dom": "^9.4.0",
  "@cycle/http": "^8.2.2"
}

.babelrc (插件支持JSX语法)

{
  "plugins": [
    ["transform-react-jsx", { "pragma": "hJSX" }]
  ],
  "presets": ["es2015"]
}

Scripts(热生成和运行服务器)

"scripts": {
  "start": "http-server",
  "build": "../node_modules/.bin/watchify index.js -v -g uglifyify -t babelify -o bundle.js"
}

以下实例需要运行时,可以开两个shell,一个跑热编译,一个起http-server(爱用currently亦可

$ npmrunbuild
$ npmstart

交互实例1

HTML代码 (实例2同,略



    
    components


index.js

importCyclefrom '@cycle/core'
import { makeDOMDriver, hJSX } from '@cycle/dom'
 
function main({ DOM }) {
  const decrement$ = DOM.select('.decrement').events('click').map(_ => -1)
  const increment$ = DOM.select('.increment').events('click').map(_ => +1)
  const count$ = increment$.merge(decrement$)
    .scan((x, y) => x + y)
    .startWith(0)
  return {
    DOM: count$.map(count =>
      
Clicked {count} times~
) } } Cycle.run(main, { DOM: makeDOMDriver('#container'), })

不难看出:

  • main() 是个纯函数,从始至终不依赖外部状态,它的所有动力来自于DOM事件源click,这个状态机依靠 Observable.prototype.scan() 得以计算和传递,最后生成 sinks 传递给DOM driver以渲染;
  • 启动了这个循环是 .startWith() ;
  • Cycle.run是应用程序的入口,加载 main() 和DOM driver,后者对一个HTML容器进行渲染输出

交互实例2

  • 功能: 一个button一个框,输入并点button后,通过Github api搜索相关的Repo,回显总数并展示第一页Repo列表

index.js

importCyclefrom '@cycle/core'
import { makeDOMDriver, hJSX } from '@cycle/dom'
import { makeHTTPDriver } from '@cycle/http'
 
const GITHUB_SEARCH_URL = 'https://api.github.com/search/repositories?q='
 
function main(responses$) {
  const search$ = responses$.DOM.select('input[type="button"]')
    .events('click')
    .map(_ => { return { url: GITHUB_SEARCH_URL } })
 
  const text$ = responses$.DOM.select('input[type="text"]')
    .events('input')
    .map(e => { return { keyword: e.target.value } })
 
  const http$ = search$.withLatestFrom(text$, (search, text)=> search.url + text.keyword)
    .map(state => { return { url: state, method: 'GET' } })
 
  const dom$ = responses$.HTTP
    .filter(res$ => res$.request.url && res$.request.url.startsWith(GITHUB_SEARCH_URL))
    .mergeAll()
    .map(res => JSON.parse(res.text))
    .startWith({ loading: true })
    .map(JSON => {
        return 

{JSON.loading ? 'Loading...' : `total: ${JSON.total_count}`}
    { JSON.items && JSON.items.map(repo =>
    repo.full_name { repo.html_url }
    ) }
} ) return { DOM: dom$, HTTP: http$, } } const driver = { DOM: makeDOMDriver('#container'), HTTP: makeHTTPDriver(), } Cycle.run(main, driver)

有了实例1做铺垫,这段代码也就通俗易懂了,需要提示的是:

  • Rx的Observable对象,命名上约定以$符为结束,以示区分
  • Observable.prototype.withLatestFrom() 的作用是:在当前Observable对象的事件触发时(不同于 combineLatest ),去合并参数的目标Observable对象的最新状态,并传递给下一级Observer
  • 以上项目完整实例,可在 /rockdragon/rx_practise/tree/master/src/web 找到

小结

寥寥数语,并不足以概括Cycle.js,比如 MVI设计模式Driver的编写awesome-cycle 这些进阶项,还是留给看官们自行探索吧。

责编内容by:莫邪 (源链)。感谢您的支持!

您可能感兴趣的

从时间旅行的乌托邦,看状态管理的设计误区... Redux 的状态管理理念非常优雅,随之附带的时间旅行调试支持也非常酷炫。但这个特性是否是传说中的银弹,又会给使用者带来什么额外的负担呢?让我们重新思考一下吧。 什么是时间旅行? 在 2015 年的 React Europe 会议上,Dan Abramov 展示了通过 Redux De...
RxJS学习笔记(1) RxJS 概述 RxJS全名Reactive Extensions for JavaScript,起源于Reactive Extensions项目,该项目主要实现各种语言的响应式编程(Reactive programming)库,被认为是观察者模式与函数式编程相结合的最佳实践。官方是这样吹嘘...
调试 RxJS 第2部分: 日志篇 原文链接: https:// blog.angularindepth.com /debugging-rxjs-part-2-logging-56904459f144 本文为 RxJS 中文社区 翻译文章,如需转载,请注明出处,谢谢合作! 如果你也想和我们一起...
RxJS: Avoiding switchMap-Related Bugs A while ago, Victor Savkin tweeted about a subtle bug that occurs through the misuse of switchMap in NgRx effects in Angular appli...
精读《react-rxjs》 本周精读的代码是 react-rxjs 。 1 引言 本周精读的是 git 仓库 - react-rxjs,它给出了一个思路,让 rxjs 更好的与 react 结合。 2 概述 View 层 View 层设计没商量,至少应该看不出 rxj...