本帖说明
该贴是对解读和补充，对于官网文档已有内容会以引用方式体现。由于官网demo在国内无法运行，该贴最后也提供了一个完整的可以运行的demo,帖子中提到的代码均是来自于该demo,供学习交流。
介绍
什么是服务器端渲染(SSR)？
Vue.js 是构建客户端应用程序的框架。默认情况下，可以在浏览器中输出 Vue 组件，进行生成 DOM 和操作 DOM。然而，也可以将同一个组件渲染为服务器端的 HTML 字符串，将它们直接发送到浏览器，最后将静态标记"混合"为客户端上完全交互的应用程序。
借助vue-server-renderer 将vue实例渲染为浏览器可以识别的html字符串。
为什么使用服务器端渲染(SSR)？
左侧为浏览器渲染，右侧为服务器渲染，从图中可以看出服务端渲染理论上明显少于浏览器渲染。
基本用法
安装
代码结构
代码详解
server.js 是服务端启动入口文件，接收客户端对页面的所有请求。
入口模板文件
/
indexHTML = parseIndex(fs.readFileSync(resolve('./dist/index.html'),'utf-8'))
} else {
/
开发环境，createRenderer将已经通过webpack打包好的server-bundle.js转化为一个可以操作的renderer对象。
/
require('./build/setup-dev-server')(app,{
bundleUpdated: bundle => {
renderer = createRenderer(bundle)
},indexUpdated: index => {//index为入口文件及index.html
indexHTML = parseIndex(index)
}
})
}
function createRenderer (bundle) {
return require('vue-server-renderer').createBundleRenderer(bundle,{
cache: require('lru-cache')({
max: 1,//1000,maxAge: 2000//1000 60 15
}),runInNewContext: false
})
}
/
读取入口文件
/
function parseIndex (template) {
const contentMarker = ''
const i = template.indexOf(contentMarker)
return {
head: template.slice(0,i),tail: template.slice(i + contentMarker.length)
}
}
const serve = (path,cache) => express.static(resolve(path),{
maxAge: cache && isProd ? 60 60 24 * 30 : 0
})
app.use('/dist',serve('./dist'))
app.get('*',(req,res) => {
if (!renderer) {
return res.end('waiting for compilation... refresh in a moment.')
}
res.setHeader('Content-Type','text/html')
res.setHeader('Server',serverInfo)
var s = Date.now()
const context = { url: req.url }
/
渲染vue实例，context对象上下文
/
const renderStream = renderer.renderToStream(context)
renderStream.once('data',() => {
res.write(indexHTML.head)
})
renderStream.on('data',chunk => {
res.write(chunk)
})
renderStream.on('end',() => {
if (context.initialState) {
res.write(
<script>window.__INITIAL_STATE__=${ serialize(context.initialState,{ isJSON: true }) }</script>
)
}
res.end(indexHTML.tail)
console.log(whole request: ${Date.now() - s}ms)
})
renderStream.on('error',err => {
if (err && err.code === '404') {
res.status(404).end('404 | Page Not Found')
return
}
res.status(500).end('Internal Error 500')
console.error(error during render : ${req.url})
console.error(err)
})
})
const port = process.env.PORT || 8080
app.listen(port,() => {
console.log(server started at localhost:${port})
})
服务端vue实例入口文件，通过上下文对象获取请求的url，映射给对应的组件。
*/
if (component.asyncData) {
return component.asyncData({
store,route: router.currentRoute
})
}
/*
<a href="https://www.jb51.cc/tag/zengjia/" target="_blank" class="keywords">增加</a>服务端数据预处理 end
*/})).then(() => {
isDev && console.log(data pre-fetch: ${Date.now() - s}ms)
context.initialState = store.state
return app
})
}
客户端vue实例入口文件.
*/
Vue.mixin({
beforeMount () {
const { asyncData } = this.$options
console.log('beforeMount',this.$store)
if (asyncData) {
// 将获取数据操作分配给 promise
// 以便在组件中，我们可以在数据准备就绪后
// 通过运行 this.dataPromise.then(...) 来执行其他任务
this.dataPromise = asyncData({
store: this.$store,route: this.$route
})
}
},beforeRouteUpdate (to,from,next) {
const { asyncData } = this.$options
console.log('beforeRouteUpdate',this.$store)
if (asyncData) {
asyncData({
store: this.$store,route: to
}).then(next).catch(next)
} else {
next()
}
}
})
/
更新客户端store，与服务端store同步
/
// store.replaceState(window.INITIAL_STATE)
if (window.INITIAL_STATE) {
store.replaceState(window.__INITIAL_STATE__)
}
// actually mount to DOM
router.onReady(() => {
/
挂载实例，客户端激活，所谓激活，指的是 Vue 在浏览器端接管由服务端发送的静态 HTML，使其变为由 Vue 管理的动态 DOM 的过程。注释掉app.$mount('#app') 可以清楚看到<div id="app" data-server-rendered="true"> 客户端通过data-server-rendered="true"知道该html是vue在服务端渲染的，并且不会在做多余的渲染。由于在服务端无法绑定事件，只有通过客户端vue处理。
/
app.$mount('#app')
})
