.Net Core+Vue.js+ElementUI 实现前后端分离

  • Post author:
  • Post category:vue


.Net Core+Vue.js+ElementUI 实现前后端分离

Tags: Vue


架构

前端采用:Vue.js、Element-UI、axios

后端采用:.Net Core Mvc

本项目是基于Vue.js的多页应用,由于是后端开发对不擅长Node.js开发并且希望使用传统的方式进行权限管控及生产发布,所以.Net Core Mvc 承担了所有的页面路由管控及页面级权限控制,Vue.js只是作为视图渲染及页面交互使用。

准备工作

Node安装及配置

node -v
  • 配置淘宝npm镜像
 # 临时使用
 npm --registry https://registry.npm.taobao.org install express
 
 # 永久使用
 npm config set registry https://registry.npm.taobao.org
 
 # 配置后可通过下面方式来验证是否成功 
 npm config get registry

客户端实现



搭建vue脚手架

  • 使用npm全局安装vue-cli脚手架构建工具

    vue-cli 提供一个官方命令行工具,可用于快速搭建大型单页应用。该工具提供开箱即用的构建工具配置,带来现代化的前端开发流程。只需几分钟即可创建并启动一个带热重载、保存时静态检查以及可用于生产环境的构建配置的项目:
npm install -g vue-cli
  • 创建一个基于 webpack 模板的新项目
# vue-multiple为自定义名称,注意项目名称不能大写
vue init webpack vue-multiple

# 初始化配置中 Install vue-router? 选择 no, 不使用vue-router,其他配置项默认即可

执行初始化命令后需要输入以下内容:

 1. Project name (my-project) # 项目名称(我的项目) 
 2. Project description (A Vue.js project) # 项目描述一个Vue.js 项目 
 3. Author 作者(你的名字) 
 4. Install vue-router? (Y/n)# 是否安装Vue路由,也就是以后是spa(但页面应用需要的模块) 
 5. Use ESLint to lint your code? (Y/n) # 使用 ESLint 到你的代码? (Y [ yes ] / N [ no ]) 
 6. Pick an ESLint preset (Use arrow keys) # 选择一个预置ESLint(使用箭头键) Setup unit tests with
 7. Karma + Mocha? (Y/n) # 设置单元测Karma + Mocha? (Y/ N) Setup e2e tests
 8. with Nightwatch? (Y/n) # 设置端到端测试,Nightwatch? (Y/ N)
  • 安装项目所需要的依赖
cd vue-multiple

# 本地安装npm依赖包,保存至 ./node_modules目录

npm install

chromedriver@2.38.3 install:

node install.js

报错解决办法:

 1.全局安装 chromedriver
npm install chromedriver -g

 2.指定淘宝镜像安装
npm install chromedriver --chromedriver_cdnurl=http://cdn.npm.taobao.org/dist/chromedriver
  • 运行项目
#运行dev命令 启动server服务器,并监听8080端口,开发环境测试使用

npm run dev 

#看到  I  Your application is running here: http://localhost:8080 并且能够成功访问  http://localhost:8080   表示项目创建成功 


修改项目模板目录

build/                       #webpack打包配置
    build.js                 #构建生产代码
    check-versions.js        #检测node及npm版本
    vue-loader.conf.js       #处理Vue文件中的样式 vue开发环境的wepack相关配置文件,主要用来处理各种文件的配置
    utils.js                 #额外的通用方法
    webpack.base.conf.js     #默认的webpack配置
    webpack.dev.conf.js      #本地开发的webpack配置
    webpack.prod.conf.js     #构建生产的webpack配置
config/   配置文件
    dev.env.js
    index.js                 #定义开发环境和生产环境中所需要的参数
    pord.env.js
    test.env.js
src/
    assets/                  #放资源
    components/              #公共组件
    views/                   #页面模块
        home/                #子页面
            index.html       #模版页面
            index.js         #js入口
        // 注意,这里的html和js的文件名要一致,如上面就是index    
dist/                        #最后打包生成的资源


修改webpack打包配置以支持多页应用开发

webpack中文

  • 修改build/utils.js文件,添加以下代码:
const glob = require('glob')
// 页面模板
const HtmlWebpackPlugin = require('html-webpack-plugin')
// 取得相应的页面路径,因为之前的配置,所以是src文件夹下的views文件夹
const PAGE_PATH = path.resolve(__dirname, '../src/views')
// 用于做相应的merge处理
const merge = require('webpack-merge')

// 多页面入口配置,通过glob模块读取views文件夹下所有对应文件夹下的js后缀文件,作为入口文件处理
exports.entries = function () {
  var entryFiles = glob.sync(PAGE_PATH + '/*/*.js')
  var entries = {},
    basename,
    tmp,
    pathname;
  entryFiles.forEach((entry) => {
    basename = path.basename(entry, path.extname(entry));
    tmp = entry.split("/").splice(-3);
    pathname = tmp.splice(1, 1) + "/" + basename; // 正确输出js和html的路径
    entries[pathname] = entry;
  })
  return entries
}
// 多页面输出配置,与上面的多页面入口配置相同,读取views文件夹下的对应的html后缀文件,然后放入数组中
exports.htmlPlugin = function () {
  let entryHtml = glob.sync(PAGE_PATH + '/*/*.html')
  let htmlentries = []
  let basename,
    tmp;
  entryHtml.forEach((filePath) => {
    basename = path.basename(filePath, path.extname(filePath));
    tmp = filePath.split("/").splice(-3);
    let filename = tmp.splice(1, 1) + "/" + basename; // 正确输出js和html的路径
    let conf = {
      // 模板来源
      template: filePath,
      // 文件名称
      filename:  filename + '.html',
      // 页面模板需要加对应的js脚本,如果不加这行则每个页面都会引入所有的js脚本
      chunks: ['manifest', 'vendor', filename],
      inject: true
    }
    if (process.env.NODE_ENV === 'product') {
      conf = merge(conf, {
        minify: {
          removeComments: true,
          collapseWhitespace: true,
          removeAttributeQuotes: true
        },
        chunksSortMode: 'dependency'
      })
    }
    htmlentries.push(new HtmlWebpackPlugin(conf))
  })
  return htmlentries
}
  • 修改webpack.base.conf.js:配置多个页面的js入口
module.exports = {
  entry: utils.entries(), //设置多个页面的js入口
  ...
}
  • 修改webpack.dev.conf.js:本地开发的多页面配置
plugins: [
    ...
    // 注释HtmlWebpackPlugin相关配置
    // new HtmlWebpackPlugin({
    //   filename: 'index.html',
    //   template: 'index.html',
    //   inject: true
    // }),
    ...
  ].concat(utils.htmlPlugin()) //添加Html模板集合
  • 修改webpack.prod.conf.js:构建生产的多页面配置
 plugins: [
    ...
    // 注释HtmlWebpackPlugin相关配置
    // new HtmlWebpackPlugin({
    //   filename: process.env.NODE_ENV === 'testing' ?
    //     'index.html' :
    //     config.build.index,
    //   template: 'index.html',
    //   inject: true,
    //   minify: {
    //     removeComments: true,
    //     collapseWhitespace: true,
    //     removeAttributeQuotes: true
    //     // more options:
    //     // https://github.com/kangax/html-minifier#options-quick-reference
    //   },
    //   // necessary to consistently work with multiple chunks via CommonsChunkPlugin
    //   chunksSortMode: 'dependency'
    // }),
    ...
  ].concat(utils.htmlPlugin())  //添加Html模板集合

如何去除js、css文件名hash值

    // 删除filename中的contenthash配置去除css文件名hash
    new ExtractTextPlugin({
      filename: utils.assetsPath('css/[name].css'),
      allChunks: true,
    })
    
    // 删除filename和chunkFilename中的chunkhash配置去除js文件名hash
    output: {
    path: config.build.assetsRoot,
    filename: utils.assetsPath('js/[name].[chunkhash].js'),
    chunkFilename: utils.assetsPath('js/[id].[chunkhash].js')
    }
    
    
  
  • 执行npm run build 指令测试打包是否成功
打包成功生成以下目录及文件
dist\
    home\
        index.html
    static
        css
            home
                index.css
        js
            home index.js
        manifest.js
        vender.js

github地址:https://github.com/chubin518/vue-multiple.git

服务端实现

  • 打开VS创建Web应用,项目创建成功后删除不必要的js、css引用等。
  • 将生成的dist目录拷贝纸wwwroot文件加下
  • _layout.cshtml 模板页添加 vender.js 、 manifest.js 引用
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>@ViewData["Title"] - NetCoreVueMultiple</title>
    <link href="~/dist/static/css/main/index.css" rel="stylesheet" />
    @RenderSection("Styles", required: false)
</head>
<body>
    @RenderBody()
    <script src="~/dist/static/js/manifest.js"></script>
    <script src="~/dist/static/js/vendor.js"></script>
    <script src="~/dist/static/js/main/index.js"></script>
    @RenderSection("Scripts", required: false)
</body>
</html>

element-ui的引入方式

参考官网


本实例使用webpack一起打包进了vendor.js中

  • 修改Index.cshtml 如下:
@{
    ViewData["Title"] = "Home Page";
}
@section Styles{
    <link href="~/dist/static/css/home/Index.css" rel="stylesheet" />
}
<div id="app">
</div>
@section Scripts{
    <script src="~/dist/static/js/home/Index.js"></script>
}
  • 编译项目运行

github地址:https://github.com/chubin518/NetCoreVueMultiple.git

  • 也可将前后端项目合并,将vue项目相关文件复制到MVC项目根目录,修改config/index.js
  build: {
    // 输出打包后的文件至wwwroot下的dist文件夹,执行npm run build 会自动生成js至wwwroot/dist下
    assetsRoot: path.resolve(__dirname, '../wwwroot/dist'),
    }
  • 如果项目中已经已经以script的方式引入vue.js /element-ui 等框架时,再次引用manifest.js,vendor.js文件可能会引起js框架版本冲突等问题

此时可通过配置设置不打包公共组件,具体操作如下:

  • 修改webpack.base.conf.js,不打包的文件
let exten = {};
if (process.env.NODE_ENV === 'testing') {
// key 为应用的第三方库的名称,value为在项目中起的别名
  exten = { //不打包的文件
    jquery: 'jQuery',
    'element-ui': 'ElementUI',
    vue: "Vue",
    vuex: 'Vuex',
    axios: 'axios',
    moment: 'moment'
  }
}
module.exports = {
  entry: utils.entries(), //设置多个页面的js入口
  externals: exten,
  ...
  }
  • 复制 webpack.prod.conf.js 并重命名为 webpack.test.conf.js,修改webpack.test.conf.js配置
    // 注释 CommonsChunkPlugin 不生成manifest.js,vendor.js文件
    
    // new webpack.optimize.CommonsChunkPlugin({
    //   name: 'vendor',
    //   minChunks(module) {
    //     // any required modules inside node_modules are extracted to vendor
    //     return (
    //       module.resource &&
    //       /\.js$/.test(module.resource) &&
    //       module.resource.indexOf(
    //         path.join(__dirname, '../node_modules')
    //       ) === 0
    //     )
    //   }
    // }),
    
    // new webpack.optimize.CommonsChunkPlugin({
    //   name: 'manifest',
    //   minChunks: Infinity
    // }),
    
    // new webpack.optimize.CommonsChunkPlugin({
    //   name: 'app',
    //   async: 'vendor-async',
    //   children: true,
    //   minChunks: 3
    // }),
    
  • 复制 build.js 并重命名为 build.test.js,修改build.test.js配置
// 设置环境变量为testing
process.env.NODE_ENV = 'testing'
// 加载webpack.test.conf.js配置
const webpackConfig = require('./webpack.test.conf.js')
// 设置静态输出目录为test
config.build.assetsSubDirectory = "test"
  • 修改 build/utils.js 修改静态文件输出目录为test
exports.assetsPath = function (_path) {
  const assetsSubDirectory = process.env.NODE_ENV === 'production' ?
    config.build.assetsSubDirectory :
    process.env.NODE_ENV === 'testing' ? 
    "test" : config.dev.assetsSubDirectory

  return path.posix.join(assetsSubDirectory, _path)
}
  • 修改package.json 添加test环境编译指令
  "scripts": {
    ....
    "build": "node build/build.js",
    "build:test": "node build/build.test.js"
  },
  • 编译打包测试配置修改是否OK

转载于:https://www.cnblogs.com/AlvinLee/p/9116445.html