深入淺出的webpack4構建工具--webpack4+vue+vuex+mock模擬后台數據(十九)


mock的官網文檔

mock官網

關於mockjs的優點,官網這樣描述它:
1)可以前后端分離。
2)增加單元測試的真實性(通過隨機數據,模擬各種場景)。
3)開發無侵入(不需要修改既有代碼,就可以攔截 Ajax 請求,返回模擬的響應數據。)
4)用法簡單。
5)數據類型豐富(支持生成隨機的文本、數字、布爾值、日期、郵箱、鏈接、圖片、顏色等)。
6)方便擴展(支持支持擴展更多數據類型,支持自定義函數和正則。)

總之:在開發中並不依賴后端的接口,我們自己根據接口文檔,在真實的請求上攔截ajax后,且根據mock的數據規則,使用mock隨機生成和真實類似結構的數據。這樣我們就可以使用這些數據來調式對應的接口。編寫我們前端業務邏輯代碼。

在學習之前,我們項目的目錄結構如下:

### 目錄結構如下:
demo1                                       # 工程名
|   |--- dist                               # 打包后生成的目錄文件             
|   |--- node_modules                       # 所有的依賴包
|   |--- app
|   | |---index
|   | | |-- views                           # 存放所有vue頁面文件
|   | | | |-- parent.vue                    # 父組件
|   | | | |-- child.vue                     # 子組件
|   | | | |-- index.vue
|   | | |-- components                      # 存放vue公用的組件
|   | | |-- js                              # 存放js文件的
|   | | |-- store                           # store倉庫
|   | | | |--- actions.js
|   | | | |--- mutations.js
|   | | | |--- state.js
|   | | | |--- mutations-types.js
|   | | | |--- index.js
|   | | |-- app.js                          # vue入口配置文件
|   | | |-- router.js                       # 路由配置文件
|   |--- views
|   | |-- index.html                        # html文件
|   |--- webpack.config.js                  # webpack配置文件 
|   |--- .gitignore  
|   |--- README.md
|   |--- package.json
|   |--- .babelrc                           # babel轉碼文件

一:mock安裝和使用
進入項目的根目錄下,執行mock安裝命令如下:

npm i -D mockjs

使用:
1. 比如生成列表數據,基本代碼(在vue中演示)

<template>
  <div>
  </div>
</template>
<script type="text/javascript">
  import Mock from 'mockjs';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      
    },
    methods: {
      
    },
    mounted() {
      const d = Mock.mock({
        /*
         屬性 list 的值是一個數組,其中含有 1 到 10 個元素,
         屬性 id 是一個自增數(key),起始值為 1,每次增 1
         數組里面的數量是隨機的,1-10個中隨機生成幾個
        */
        'list|1-10': [
          {
            'id|+1': 1
          }
        ]
      });
      // "list": [{ "id": 1 }, { "id": 2 }]
      console.log(d); 
    }
  }
</script>

具體的mock數據含義對應的文檔,可以看這個對應的API文檔。這里就不講解基本語法了。

Mock 數據的語法如下:

Mock.mock(rurl?, rtype?, template|function(options))

參數rurl: [可選],表示需要攔截的url,可以是url字符串或url正則。
參數rtype: [可選],表示需要攔截的ajax請求的類型,比如 GET、POST、PUT、DELETE、等。
參數 template: [可選],表示數據模板,可以是對象或字符串。比如:{ 'data|1-10': [{}]}, '@EMAIL'.
參數 function(options) [可選],表示用於生成響應數據的函數。
參數options 指向本次請求的ajax數據。

Mock.mock()(提供五種參數格式以及語法規范的使用)

1. Mock.mock(template),跟進數據模板生成模擬數據。 如下demo代碼:

<template>
  <div>
  </div>
</template>
<script type="text/javascript">
  import Mock from 'mockjs';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      
    },
    methods: {
      
    },
    mounted() {
      var t = {
        'title': 'kongzhi',
        /* 通過重復 a 生成一個字符串,重復次數大於等於1,小於等於10 */
        'string1|1-10': 'a',
        /* 通過重復b生成一個字符串,重復的次數等於3 */
        'string2|3': 'b',

        /* 屬性值自動加1,初始值為100 */
         'number1|+1': 100,

        /* 生成一個大於等於1,小於等於100的整數,屬性值100只用來確定類型 */
         'number2|1-100': 100,

        /* 生成一個浮點數,整數部分大於等於1,小於等於100,小數部分保留1到10位 */
         'number3|1-100.1-10': 1,

        /* 生成一個浮點數,整數部分未123,小數部分1-10位 */
         'number4|123.1-10': 1,

        /* 生成一個浮點數,整數部分為123,小數部分3位 */
         'number5|123.3': 1,

        /* 生成一個浮點數,整數部分未123,小數部分為 10位 */
         'number6|123.10': 1.123,

        /* 隨機生成一個布爾值,值為true的概率為1/2, 值為false的概率是 1/2 */
         'boolean1|1': true,

        /* 隨機生成一個布爾值,值為true的概率是 1/(1+2), 值為false的概率是 2/(1+2) */
         'boolean2|1-2': true,

         /* 生成一個新對象,對象里面的屬性最小是2位,最大是4位 */
         'object1|2-4': {
            '110000': '北京市',
            '120000': '天津市',
            '130000': '河北省',
            '140000': '山西省'
         },
         /* 生成一個新對象,對象里面的屬性是2位 */
         'object2|2': {
            '310000': '上海市',
            '320000': '江蘇省',
            '330000': '浙江省',
            '340000': '安微省'
         },

         /* 從屬性值 ['AMD', 'CMD', 'UMD'] 中隨機選取1個元素,最為最終值 */
         'array1|1': ['AMD', 'CMD', 'UMD'],

         /* 通過重復屬性值 Mock.js生成一個新數組,重復的次數大於等於1,小於等於10 */
         'array2|1-10': ['Mock.js'],

         /* 通過重復屬性值 Mock.js, 生成一個新數組,重復的次數為3 */
         'array3|3': ['Mock.js'],

         /* 執行函數 function(){}, 該函數返回值作為最終的屬性值 */
         'function': function() {
            return this.title
         }
      };
      var d = Mock.mock(t);
      console.log(d);
    }
  }
</script>

輸出結果如下所示:

2. Mock.mock(rurl, template)

記錄數據模板,當攔截到匹配 rurl的ajax請求時,將根據數據模板 template生成模擬數據,並作為響應數據返回。

如下demo代碼:

<template>
  <div>
  </div>
</template>
<script type="text/javascript">
  import Mock from 'mockjs';
  import { mapActions } from 'vuex';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      this.testMock();
    },
    methods: {
      testMock() {
        Mock.mock('//xxx.abc.com/xxxx/yyy', {
          'code': 0,
          'list|1-10': [{
            'id|+1': 1,
            'email': '@EMAIL'
          }]
        });
        // 請求的地址是 '//xxx.abc.com/xxxx/yyy'
        Promise.all([this.commonActionGet(['getPower', {}])]).then((res) => {
          console.log(res);
        });
      },
      ...mapActions(['commonActionGet', 'commonActionGetJSON', 'commonActionPost', 'commonActionPostJSON'])
    },
    mounted() {

    }
  }
</script>

如上請求后,打印出 console.log(res); 后,打印出如下圖所示:

3. Mock.mock(rurl, function(options))

記錄用於生成響應數據的函數,當攔截匹配到 rurl的Ajax請求時,函數 function(options)將被執行,並把執行結果作為響應數據返回。

如下代碼演示:

<template>
  <div>  
  </div>
</template>
<script type="text/javascript">
  import Mock from 'mockjs';
  import { mapActions } from 'vuex';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      this.testMock();
    },
    methods: {
      testMock() {
        Mock.mock('//xxx.abc.com/xxxx/yyy', function(options){
          return options;
        });
        // 請求的地址是 '//xxx.abc.com/xxxx/yyy'
        Promise.all([this.commonActionGet(['getPower', {}])]).then((res) => {
          console.log(res);
        });
      },
      ...mapActions(['commonActionGet', 'commonActionGetJSON', 'commonActionPost', 'commonActionPostJSON'])
    },
    mounted() {

    }
  }
</script>

打印 console.log(res) 結果如下:

4. Mock.mock(rurl, rtype, template)

記錄數據模板,當攔截到匹配 rurl和rtype的ajax請求時,將根據數據模板template生成模擬數據,並作為響應數據返回。
如下代碼演示:

<template>
  <div>
  </div>
</template>
<script type="text/javascript">
  import Mock from 'mockjs';
  import { mapActions } from 'vuex';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      this.testMock();
    },
    methods: {
      testMock() {
        Mock.mock('//xxx.abc.com/xxxx/yyy', 'get', {
          'list': [{ 'name': 'kongzhi' }]
        });
        // 請求的地址是 '//xxx.abc.com/xxxx/yyy'
        Promise.all([this.commonActionGet(['getPower', {}])]).then((res) => {
          console.log(res);
        });
      },
      ...mapActions(['commonActionGet', 'commonActionGetJSON', 'commonActionPost', 'commonActionPostJSON'])
    },
    mounted() {
      
    }
  }
</script>

如下圖所示:

5. Mock.mock(rurl, rtype, function(options))
記錄用於生成響應數據的函數。當攔截到匹配 rurl 和 rtype的ajax請求時,函數 function(options) 將被執行,並把執行結果作為響應數據返回。

如下代碼演示:

<template>
  <div>
    
  </div>
</template>

<script type="text/javascript">
  import Mock from 'mockjs';
  import { mapActions } from 'vuex';
  export default {
    data() {
      return {
        
      }
    },
    created() {
      this.testMock();
    },
    methods: {
      testMock() {
        Mock.mock('//xxx.abc.com/xxxx/yyy', 'get', function(options) {
          return options;
        });
        // 請求的地址是 '//xxx.abc.com/xxxx/yyy'
        Promise.all([this.commonActionGet(['getPower', {}])]).then((res) => {
          console.log(res);
        });
      },
      ...mapActions(['commonActionGet', 'commonActionGetJSON', 'commonActionPost', 'commonActionPostJSON'])
    },
    mounted() {

    }
  }
</script>

如下圖所示:

二:mock數據如何區分開發環境和正式環境?

如上代碼雖然可以解決數據模擬,但是上面的代碼有一個明顯的缺點,就是在代碼內部,如果接口正常的話,那么我們需要把mock相關的模擬代碼刪除,如果是一個接口倒是好,但是如果頁面上有多個接口,並且一個項目對應多個單頁面的話,那么這種重復的工作就顯示非常麻煩,並且很不友好。

因此我這邊想這樣處理,在 app/index/ 下新建一個文件夾叫json文件夾,然后json文件夾里面放所有模擬相關的json文件,那么json文件的命名如何命名呢?比如一個pageA頁面有多個接口獲取數據,那么如果我直接以接口的名稱命名的話,那么過了一段時間后,我打開json文件,一眼看過去也分不清哪個json接口數據是那個頁面的,因此我這邊想這樣約定下 json文件名稱命名規范:頁面模塊名_接口名稱.json, 比如我vue頁面叫pageA頁面,然后pageA頁面有好多接口,比如其中一個接口是獲取產品名稱接口,假如接口名稱叫 getProdName, 那么我想json命名就叫 pageA_getProdName.json. 這樣的話,如果以后有多個json的話,一眼就可以看出是那個頁面的接口,並且該接口的作用是干什么用的。

app/index/json/parent_yyyy.json 這樣定義,在parent頁面內部,有個接口名稱叫 yyyy, 因此json文件
命名就叫 parent_yyyy.json; 假如接口返回的json數據如下:

{
    "data": [{
        "assignerId": 55,
        "assignerName": "仲宣",
        "auditStatus": 20,
        "auditTime": "2018-05-08 16:56:02",
        "borrowerIdCard": "130204199812050027",
        "borrowerName": "張小紅",
        "borrowerSign": "電信白名單用戶",
        "id": 1,
        "loanAmount": 3500,
        "loanPeriod": "12",
        "loanRate": 21.5,
        "loanTime": "2018-05-07 19:27:17",
        "loanUsage": "購物消費",
        "occurDate": 20180507,
        "orderId": "20180507175020345000034567893",
        "processInstanceId": 302,
        "taskId": 326,
        "prodName": "有借有還",
        "taskName": "人工審核",
        "userId": "68"
    }],
    "page": {
        "curPage": 1,
        "pageSize": 15
    },
    "query": {
        "assignerId": 55,
        "egtCreateTime": "2018-04-25 10:10:45",
        "isAssigned": 0
    },
    "code": 0,
    "message": "查詢成功"
}

現在項目的目錄結構變成如下了:

### 目錄結構如下:
demo1                                       # 工程名
|   |--- dist                               # 打包后生成的目錄文件             
|   |--- node_modules                       # 所有的依賴包
|   |--- app
|   | |---index
|   | | |-- views                           # 存放所有vue頁面文件
|   | | | |-- parent.vue                    # 父組件
|   | | | |-- child.vue                     # 子組件
|   | | | |-- index.vue
|   | | |-- components                      # 存放vue公用的組件
|   | | |-- js                              # 存放js文件的
|   | | |-- json                            # 存放所有json模擬數據的文件
|   | | | |-- parent_yyyy.json              # json文件
|   | | |-- store                           # store倉庫
|   | | | |--- actions.js
|   | | | |--- mutations.js
|   | | | |--- state.js
|   | | | |--- mutations-types.js
|   | | | |--- index.js
|   | | |-- app.js                          # vue入口配置文件
|   | | |-- router.js                       # 路由配置文件
|   |--- views
|   | |-- index.html                        # html文件
|   |--- webpack.config.js                  # webpack配置文件 
|   |--- .gitignore  
|   |--- README.md
|   |--- package.json
|   |--- .babelrc                           # babel轉碼文件

那么我這邊就不使用mock數據隨機生成了,直接把接口文檔對應的數據格式貼到我對應json文件內部,然后在頁面
模擬的時候,需要配置下;

1. 首先需要安裝 cross-env 插件, 該插件的具體用途請看 (https://www.cnblogs.com/tugenhua0707/p/9780621.html) , 安裝命令如下:

npm install --save cross-env

2. 在package.json 文件中配置, 如下代碼:

"scripts": {
  "dev": "cross-env NODE_ENV=development webpack-dev-server --progress --colors --devtool cheap-module-eval-source-map --hot --inline",
  "build": "cross-env NODE_ENV=production webpack --progress --colors --devtool cheap-module-source-map",
  "build:dll": "webpack --config webpack.dll.config.js",
  "start": "webpack-dev-server --progress --colors --devtool cheap-module-eval-source-map --hot --inline",
  "mock": "cross-env NODE_ENV=mock npm run start"
},

如上命名配置,當我們使用 npm run mock 的話,那么就執行mock數據,當我們運行 npm run dev 的話,就是不mock數據,使用開發環境正式接口數據,當我們npm run build 的話,就是線上正式打包。

3. 在webpack中如何配置呢?

module.exports = {
  plugins: [
    // 設置環境變量信息
    new webpack.DefinePlugin({
      PRODUCTION: JSON.stringify(true),
      VERSION: JSON.stringify('5fa3b9'),
      BROWSER_SUPPORTS_HTML5: true,
      TWO: '1+1',
      'typeof window': JSON.stringify('object'),
      'process.env': {
        NODE_ENV: JSON.stringify(process.env.NODE_ENV)
      }
    })
  ]
}

4. 在vue頁面中如何使用呢?

<template>
  <div>
  </div>
</template>
<script type="text/javascript">
  import { mapActions } from 'vuex';
  export default {
    data() {
      return {
      }
    },
    created() {
      this.testMock();
    },
    methods: {
      testMock() {
        console.log(process.env.NODE_ENV);
        if (process.env.NODE_ENV === 'mock') {
          const Mock = require('mockjs');
          const json = require('../json/parent_yyyy.json');
          Mock.mock('//xxx.abc.com/xxxx/yyy', 'get', {
            'list': json
          });
        }
        // 請求的地址是 '//xxx.abc.com/xxxx/yyy'
        Promise.all([this.commonActionGet(['getPower', {}])]).then((res) => {
          console.log(res);
          let rets;
          if (process.env.NODE_ENV === 'mock') {
            rets = res[0].list;
          } else {
            rets = res;
          } 
          console.log(rets);
        });
      },
      ...mapActions(['commonActionGet', 'commonActionGetJSON', 'commonActionPost', 'commonActionPostJSON'])
    },
    mounted() {

    }
  }
</script>

打印如下圖所示:

可以看到設置環境為 mock了,並且模擬出了我們想要的數據,現在我們繼續 npm run dev 后,再來看看控制台就會看到不會使用mock數據了,而直接訪問接口,如下圖所示:

如上看到控制台輸出的是 developmemt 開發環境了。

同理,正式環境執行 npm run build 后打包,看到js文件也不會包含 mock相關的代碼了。這就可以在開發環境下mock數據了,並且不需要依賴開發的接口,直接根據文檔的接口數據,就可以直接模擬接口返回的數據了。

查看github上的代碼


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM