next.js 的服务端渲染机制(二)

本文是next.js 的服务端渲染机制(一)的后续

server/render.js这个模块是服务端渲染的核心模块,它主要完成了三个环节:

  • URL path 到组件的文件路径的匹配;
  • 调用 react 的服务端渲染方法,拼接出完整的 html 字符串;
  • document 请求应答。

承接next.js 的服务端渲染机制(一),先看renderToHTML()方法,我们定位到它调用了一个doRender()函数。

async function doRender(
  req,
  res,
  pathname,
  query,
  {
    err,
    page,
    buildId,
    buildStats,
    hotReloader,
    assetPrefix,
    availableChunks,
    dir = process.cwd(),
    dev = false,
    staticMarkup = false,
    nextExport = false,
  } = {},
) {
  page = page || pathname;

  await ensurePage(page, { dir, hotReloader });

  const dist = getConfig(dir).distDir;

  // 引入当前url指定path的page
  let [Component, Document] = await Promise.all([
    requireModule(join(dir, dist, 'dist', 'pages', page)),
    requireModule(join(dir, dist, 'dist', 'pages', '_document')),
  ]);
  Component = Component.default || Component;
  Document = Document.default || Document;
  const asPath = req.url;
  // ctx传入源
  const ctx = { err, req, res, pathname, query, asPath };
  // 执行getInitialProps函数
  const props = await loadGetInitialProps(Component, ctx);

  // the response might be finshed on the getinitialprops call
  if (res.finished) return;

  const renderPage = (enhancer = Page => Page) => {
    // 生成用App包裹的page
    const app = createElement(App, {
      Component: enhancer(Component),
      props,
      router: new Router(pathname, query),
    });

    const render = staticMarkup ? renderToStaticMarkup : renderToString;

    let html;
    let head;
    let errorHtml = '';
    try {
      // 服务端渲染页面组件
      html = render(app);
    } finally {
      head = Head.rewind() || defaultHead();
    }
    // 获取到当前需要动态加载的模块的列表
    const chunks = loadChunks({ dev, dir, dist, availableChunks });

    if (err && dev) {
      errorHtml = render(createElement(ErrorDebug, { error: err }));
    }

    return { html, head, errorHtml, chunks };
  };

  // 执行document的getInitialProps
  const docProps = await loadGetInitialProps(Document, { ...ctx, renderPage });
  // While developing, we should not cache any assets.
  // So, we use a different buildId for each page load.
  // With that we can ensure, we have unique URL for assets per every page load.
  // So, it'll prevent issues like this: https://git.io/vHLtb
  const devBuildId = Date.now();

  if (res.finished) return;

  if (!Document.prototype || !Document.prototype.isReactComponent)
    throw new Error('_document.js is not exporting a React element');
  // 生成document对应的元素
  const doc = createElement(Document, {
    __NEXT_DATA__: {
      props,
      pathname,
      query,
      buildId: dev ? devBuildId : buildId,
      buildStats,
      assetPrefix,
      nextExport,
      err: err ? serializeError(dev, err) : null,
    },
    dev,
    dir,
    staticMarkup,
    ...docProps,
  });

  return '<!DOCTYPE html>' + renderToStaticMarkup(doc);
}

这段代码很长,我分段讲述。首先它完成了一个我们一直存疑的环节——路由到组件路径的匹配。通过一个简单的 require 模块,动态地引入 page component,并在同时将 page 目录下的_document组件也引入进来。

server / render.js
server / require.js

获取到对应的 page component 之后,next 显示地调用了这个组件的getInitialProps()方法。我们知道,getInitialProps()方法是 next 对react 组件生命周期的拓展,是一个只会在服务端执行的 hook 函数,页面首屏需要的数据信息一律都在这个钩子函数中作接口获取。而 ctx 正是我们在getInitialProps()中获取到的传参。

server / render.js

紧接着,next 定义了一个在后边执行的函数,这个函数的主要作用是利用 react 提供的 createElement()方法和renderToStaticMarkup() / renderToString()方法,将组件渲染成字符串,并且生成文档头部和获取到当前页面依赖的动态模块的chunk,一并返回回去。

server / render.js

这里边第一是用到了一个包裹组件——lib / app.js。它是业务组件外裹的第一层,主要用于: 1、将路由信息和 router 的一些方法聚合到一个对象上并挂载在组件的 props 中; 2、模拟浏览器实现对 hash 值的定位处理。
其次、loadchunks()用于获取当前需要加载的动态模块,而我们知道,动态模块是通过 next 提供的 dynamic 方法引入的,形如:

import dynamic from 'next/dynamic'
const DynamicComponent = dynamic(import('../components/hello'))

其机理是通过 dynamic 引入的模块,其逻辑代码会被 webpack 打包到另外的chunk,如果模块在当前服务端渲染中被需要时,dynamic 首先会把对应的 html 补充到前边的 page component 中,然后登记它的chunkName,而在这里就通过loadChunks这个方法把所有动态模块的chunk收集起来。

跟着,next 调用 Document 组件的getInitalProps()方法,并将获取到的
props,连同其它一些信息作为 Document 组件的 props,传入并实例化这个组件,最后执行该组件的服务端渲染。这个组件是 page component 最外层的组件,用于补充文档头部、script和样式,并填充渲染完的 content HTML,拼接成完整的 document。
最后,补充DOCTYPE,返回整个文档字符串。

server / render.js

相比,渲染完 HTML 字符串后执行的sendHTML()就显得很简单了。tag的生成和更新,缓存有效性判定,http header 的设置,请求应答,完事。
server / render.js

next 的整个服务端渲染流程就大概是这样子,大多为自己摸索,有错误还烦请指出。

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

推荐阅读更多精彩内容

  • 前后端同构,作为针对单页应用 SEO 优化乏力、首屏速度瓶颈等问题而产出的解决方案,近来在 react、vue 等...
    沐童Hankle阅读 9,444评论 0 8
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,815评论 25 707
  • 原教程内容详见精益 React 学习指南,这只是我在学习过程中的一些阅读笔记,个人觉得该教程讲解深入浅出,比目前大...
    leonaxiong阅读 2,813评论 1 18
  • YOUNG12阅读 349评论 16 14