今天，我們打算花幾分鐘時間建立一個自己用來測試的 MockUp 伺服器。

因為我是前端開發，所以這裡使用 Node.js 建立一個簡單的迷你工程來完成！

目標

用 curl 訪問 mockserver 可以獲得自己想要的結果

>>> node client1.js
>>> curl http://localhost:1080/api/demo
{"name":"value"}

>>> curl -X POST 'http://localhost:1080/api/demo2?test=true' -d someBody
{"name":"value"}

• 1
• 2
• 3
• 4
• 5
• 6

• 1
• 2
• 3
• 4
• 5
• 6

我喜歡上程式碼

直接建立一個起步目錄

npm init

• 1

• 1

用 Java 安裝 mockserver（最簡單）

總結起來就是：

>>> wget http://search.maven.org/remotecontent?filepath=org/mock-server/mockserver-netty/3.10.1/mockserver-netty-3.10.1-jar-with-dependencies.jar -O mockserver-netty-3.10.1-jar-with-dependencies.jar

>>> java -jar mockserver-netty-3.10
 
.1-jar-with-dependencies.jar -serverPort 1080 -proxyPort 1090

• 1
• 2
• 3

• 1
• 2
• 3

用 Node.js 安裝 mockserver

安裝必要的 Grunt 工具和部件

# 全域性安裝 Grunt 客戶端
npm install -g grunt-cli

# NPM 工程安裝 Grunt 以及 Grunt 外掛
npm install grunt --save-dev
npm install mockserver-grunt --save-dev

# 建立 Gruntfile.js
參考官方文件進行配置

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9

然後建立一個檔案 Gruntfile.js

/*File: Gruntfile.js*/
module.exports = function(grunt) {

grunt.initConfig({
    start_mockserver: {
        start: {
            options: {
                serverPort: 1080,
                proxyPort: 1090
            }
        }
    },
    stop_mockserver: {
        stop: {
        }
    }
});

grunt.loadNpmTasks('mockserver-grunt');

  // 預設被執行的任務列表。
  grunt.registerTask('default', ['start_mockserver']);
  grunt.registerTask('stop', ['stop_mockserver']);
  grunt.registerTask('start', ['start_mockserver']);

};

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26

現在，通過執行下邊命令即可啟動一個 Mock Server 了

grunt start

• 1

• 1

建立 MockServer Client

那麼，接下來建立一個客戶端檔案 client1.js 用來註冊自己需要如何 MockUp 一個 API 介面。

首先安裝依賴：

npm install mockserver-client

• 1

• 1

然後建立檔案 client1.js：

/*File: client1.js*/
var mockServer = require('mockserver-client'),
    mockServerClient = mockServer.mockServerClient, // MockServer client
    proxyClient = mockServer.proxyClient; // proxy client

var remote = mockServerClient('localhost', 1080),
    remoteProxy = proxyClient('localhost', 1090);

// 使用之前清除伺服器裡邊已經註冊的 mockup 資訊，因為可能會影響當前測試結果或者開發結果呢。
remote.reset();

// 簡單的設定想要的response資訊
// curl -X POST http://localhost:1080/api/demo
remote.mockSimpleResponse('/api/demo', { name: 'value'}, 203);

// 精確的設定想要的response訊息，會參考輸入的情況來判斷怎麼跑
// curl -X POST 'http://localhost:1080/api/demo2?test=true' -d someBody
remote.mockAnyResponse({
  'httpRequest': {
    'method': 'POST',
    'path': '/api/demo2',
    'queryStringParameters': [
      {
        'name': 'test',
        'values': [ 'true' ]
      }
    ],
    'body': {
      'type': "STRING",
      'value': 'someBody'
    }
  }, /*httpRequest*/
  'httpResponse': {
    'statusCode': 200,
    'body': JSON.stringify({name: 'value'}),
    'delay': {
      'timeUnit': 'MILLISECONDS',
      'value': 250
    }
  }, /*httpResponse*/
  'times': {
    'remainingTimes': 1,
    'unlimited': false
  }
});

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45

好了，搞定！

使用一下試試

$ npm install

$ node client1.js

# 再在此使用我們的目標命令即可，見文章最上邊

• 1
• 2
• 3
• 4
• 5

• 1
• 2
• 3
• 4
• 5

想某些請求被現網伺服器呼叫？

也許想同時使用現網伺服器的登陸功能？

>>> curl -X POST http://localhost:1080/user/login -d account=demo_user -d password=demo_password
{"status":"LOGIN_SUCCESS","token":"abcdefgxxxxxxxx"}
# 期望這個請求被配置好的現網伺服器處理

• 1
• 2
• 3

• 1
• 2
• 3

配置一個新的請求，放到 client1.js 中：

/*File: client1.js*/

// 建立 bypass 請求，符合要求的請求會透傳給真的伺服器處理。
// curl -X POST http://localhost:1080/user/login -d account=demo_user -d password=demo_password
remote.mockAnyResponse({
  httpRequest: {
    method: 'POST',
    path: '/user/login'
  },
  httpForward: {
    host: '192.168.1.101',
    port: 8080,
    schema: "HTTP"
  },
  times: {
    remainingTimes: 1,
    unlimited: false
  }
});

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

然後再重新註冊一下 mock 訊息試試：

>>> node client1.js
>>> # 執行curl命令

• 1
• 2

• 1
• 2

支援跨域

如果需要跨域的話，需要在 Reponse 訊息中配置：

{ // Response 新增 headers 配置
  'httpResponse': {
    'headers': [
      {name: 'Access-Control-Allow-Origin', values: ['*']},
      {name: 'Access-Control-Allow-Methods', values: ['POST', 'GET', 'OPTIONS']}
    ]
  }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

搞定！