前言:

  18年年底,就一个字,忙,貌似一到年底哪个公司都在冲业绩,包括我们自己开发自己公司的项目也一样得加把劲。自从18年年初立了个flag17年年终总结——走过2017,迎来2018Flag到现在又一年了。想想当时立的flag还是很多没有完成到,说的第一点就没有完成了(ps:这确实不能怪我,真的忙),健身也是落下了,而node.js的呢还在进程中,说不定稍后会出了系列的文章(ps:当然不会像之前那几篇那样,感觉写得有点云里雾里的)。当然,今天的重点不是说这些,而是我在vue项目上实践的一些小汇总和踩坑指南。另,结尾有福利喔~~~

正文:

  这一年前前后后大概做了有四个vue相关的项目(ps:vue-cli脚手架搭建),其中包括两个移动端和两个管理后台的(ps:有一个管理端还在进行中),其中不免遇到了不少坑,还有不少的总结。

  vue-cli开发相关

  一、一般的vue-cli src的项目骨架:

├── App.vue
├── main.js
├── permission.js
├── router
│   └── index.js
├── api
│   └── index.js
│   └── xx.js
├── assets
│   ├── images
│   ├── flexible.js
│   └── common
│       └── common.less
│       └── mixin.less
├── components
├── utils
├── store
│   ├── index.js
│   └── xxStore.js
└── views
    ├── index.vue
    └── xx.vue

  对vue-cli有了解的应该知道一般我们的源码就写在src文件夹下面。其中App.vue就是根组件,其他的组件我们就可以通过App.vue的

<router-view/>渲染;main.js就是入口文件,一般用于引入通用组件,UI框架,router,axios,store挂载等;permission.js则用于在路由渲染先后需要设置的权限之类的;components则为通用组件的封装;utils则为通用的方法的封装;api则为通用api的封装调用等。

  例如:main.js

import 'babel-polyfill'
import Vue from 'vue'
import Es6Promise from 'es6-promise'
require('es6-promise').polyfill()
Es6Promise.polyfill()
import App from './App'
import './assets/flexible'
import axios from 'axios'
import router from './router'
import store from './store'
import './permission'
import {WechatPlugin,LoadingPlugin,ToastPlugin,AlertPlugin,ConfirmPlugin } from 'vux'
import VueLazyload from 'vue-lazyload'

//挂载axios
Vue.prototype.axios=axios

//配置微信jssdk,通过Vue.wechat直接访问wx
Vue.config.productionTip = false
Vue.use(WechatPlugin)
Vue.use(LoadingPlugin)
Vue.use(ToastPlugin)
Vue.use(AlertPlugin)
Vue.use(ConfirmPlugin)
Vue.use(VueLazyload,{
  error:require('./assets/images/activity_default_loading.png'),
  loading:require('./assets/images/activity_default_loading.png')
})

/* eslint-disable no-new */
new Vue({
  el: '#app',
  router,
  store,
  components: { App },
  template: '<App/>'
})

  二、axios api接口的统一封装

  现在的vue-cli开发,一般都是使用axios进行接口请求,其中一大好处就是可以进行请求和响应的拦截,进而进行一些通用的配置,所以能很好的做到了接口的封装。

  例如:request.js

import axios from 'axios'
import { AlertModule } from 'vux'

// 创建axios实例
const service = axios.create({
  //baseURL: process.env.ENV_CONFIG=='dev'?'/api':'', // api的base_url
  baseURL: process.env.ENV_CONFIG=='dev'?'/api':process.env.BASE_API,
  //timeout: 10000, // 请求超时时间
  headers:{

  }
})

// request拦截器
service.interceptors.request.use(
  config => {
    if( config.method === 'post' ){
      config.data.http_headers={

      }
    }
    return config
  },
  error => {
    // Do something with request error
    // for debug
    console.log(error)
    Promise.reject(error)
  }
)

// respone拦截器
service.interceptors.response.use(
  response => {
    if (response.data.result && response.data.result==='failed') {
      AlertModule.show({
        title:'提示',
        content:response.data.text,
        /*onHide () {
          router.push({
            name:'index'
          })
        }*/
      })
      return
    }
    else{
      return response.data
    }
  },
  error => {
    console.log('err' + error) // for debug
    /*AlertModule.show({
      title:'斑马提示',
      content:'链接超时,请重新尝试',
    })*/
    return Promise.reject(error)
  }
)

export default service

  之后,我们就可以通过api目录暴露封装的接口调用

import request from '@/utils/request'

export function doXx(data) {
  return request({
    url:'/xx',
    method:'post',
    data
  })
}

  三、axios 请求不同数据格式的处理及表单提交处理

  看axios文档我们可以了解到,axios的其中一个特点就是将数据转换成json格式,但是有些接口由于历史等原因后台不方便调整的话,就需要前端做些处理了。

  例如,以formdata格式提交参数则可以通过axios内置的qs模块进行data的格式转换,然后设置请求头即可

export function XXRequest(data) {
  return request({
    transformRequest: [function(data) {      //在请求之前对data传参进行格式转换
      data = qs.stringify(data)
      return data
    }],
    url:'/xx.do',
    method:'post',
    data,
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
    }
  })
}

  又例如,后台返回一个form表单,需要前端提交form表单,则需要,通过路由的resolve对象,this.$router.resolve解析接口回调参数并且打开空白页面并提交form表单

// res为回调参数
let routerData = this.$router.resolve({name:'apply',query:{htmls:res}})
window.open(routerData.href,'_ blank')
const div = document.createElement('div')
div.innerHTML = res
 document.body.appendChild(div)
document.forms [0] .submit()

apply.vue做法
<template>
   <div v-html ="apply">
     {{apply}}
   </div>
</template>

<script>
  export default {
    name:'apply',
    data(){
      return {
        apply:''
      }
    },
    mounted(){
      let form = this.$route.query.htmls
      this.apply = form
      this.$nextTick(()=> {
        document.forms [0].submit()
      })
    }
  }
  </script>

  四、引入css预处理器less

npm install less less-loader --save

修改webpack.base.conf.js rules
{
        test: /\.less$/,
        loader: "style-loader!css-loader!less-loader",
      }

  五、es6在低版本及IE下的不兼容

  部分低版本的手机或者IE下是不兼容es6中的promise的,如果用到了promise语法的话,就需要进行es6编译es5,所以做法需要引入

es6-promise并且在main.js中引入

npm install es6-promise --save

main.js中引入
import Es6Promise from 'es6-promise'
require('es6-promise').polyfill()
Es6Promise.polyfill()

  六、ico调整

  一般的ico都是设置在项目根目录下,然后调整build webpack.dev.conf.js和webpack.prod.conf.js中的new HtmlWebpackPlugin设置参数

favicon:path.resolve(__dirname,'xx.ico')即可。

  七、常用组件的引入

  一般常用的vue组件的引入,例如vue-lazyload、vue-scroller等一般可以上npm查看相关是使用方法即可。

  vue-cli单页面部署相关

  一、build路径问题

  一般项目都会部署到端口的某个文件夹下面,所以需要修改config index.js的assetsPublicPath路径

 index: path.resolve(__dirname, '../文件夹名/index.html'),

assetsRoot: path.resolve(__dirname, '../文件夹名'),
assetsSubDirectory: 'static',
assetsPublicPath: './',  // ./为相对文件夹路径,否则/为根目录

  二、部署到Nginx上

  由于打包完后的是静态文件,所以我们可以直接部署到Nginx上面,接口通过Nginx代理即可。但是刷新会丢失404,所以需要做个重定向即可。

location /{
            root   dist;
            index  index.html;
        try_files $uri $uri/ /dist/index.html;
}

  三、部署到Tomcat上

  部署到Tomcat上的话,一样存在刷新丢失的情况,我看有人提出配置web.xml进行404重定向,这个我司也是有实践了下

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>xxx</display-name>

  <error-page>
    <error-code>404</error-code>
    <location>/index.html</location>
  </error-page>
</web-app>

  但是,这样部署的话其实是第一次刷新ok的,但是再次刷新则还是404丢失。(ps:在移动设备上会,有知道的大佬可以留言喔~)

总结:

  其中,有了解过vue-cli开发的话,其实用vue开发在业务逻辑上是没有太大的问题的,因为很多大佬已经开发出各种组件供我们调用了,我呢,就在部署上面卡了很久,因为最初的想法是部署到Tomcat上的,所以一直尝试都没有成功,最初的原因的就是使用了es6的promise,然后呢又了解到了需要配置重定向xml。最后以为大功告成,还是存在二次刷新丢失的问题。所以部署到了Nginx上,然后设置重新定这样子解决。

  另,其中还有很多可能没有总结到位,到时有补充的会补充在这里~

  再另,附福利

  winter大大,前手机淘宝前端负责人在极客时间上发了《重学前端》的课程,扫我的二维码报名的话可以找我分奖励喔,另外通过我二维码报名的加我wx:UEMtQWFyb24= (ps:base64转码)可得vue教程一套。嘻嘻

vue开发小结(内有福利)-LMLPHP

01-15 23:24