摘要：本文最初發布于我的個人博客咀嚼之味是一個簡單的訪問量統計工具。如何從版本遷移到我已經把遷移的成本降到最低，只要替換引入的文件即可老版本需要引入的文件新版本需要引入的文件因為版本基于的服務，所以需要額外引入的一個庫文件。

本文最初發布于我的個人博客：咀嚼之味

Hit Kounter 是一個簡單的訪問量統計工具。據我從數據庫里的數據目測，現在已經擁有了 9 位用戶！不過我要對這九位用戶說聲抱歉啦。

Hit Kounter 原本部署于 SAE 上，而近期 SAE 針對使用 MySQL 的應用開始收費。本項目只是一個本人使用業余時間開發的小工具；它本身包含的功能也很精簡，并不適合使用付費服務。所以我已經將 Hit Kounter 服務遷移至 LeanCloud 上。原本部署在 SAE 上的服務預計在 五一假期 后下線，對已經使用 Hit Kounter 的一些用戶，我再次表達我的歉意！

由于此次改版改動比較大，我是 fork 了一份代碼出來進行修改的；改版后的 Hit Kounter 在 Github 上倉庫地址是 zry656565/Hit-Kounter-LC，區別于原來的 Hit Kounter PHP 版：zry656565/Hit-Kounter

使用方式上，目前 v0.2 版本相比于 v0.1 并沒有什么改變，接下來會從以下幾個方面介紹一下：

如何為你的博客添加訪問統計

Hit Kounter 的 JS 接口

如何從 v0.1.1 版本遷移到 v0.2.0

小結：Hit Kounter 的未來

如果你是 Hit Kounter v0.1 的用戶，可以直接閱讀 如何從 v0.1.1 版本遷移到 v0.2.0。

首先，在你的頁面中引入這兩個腳本，第一個腳本是 LeanCloud 的庫腳本，引入了它我們才能使用 LeanCloud 的服務；由于你可能在每個頁面都需要顯示訪問量，把它加入根模板也許是個不錯的選擇。

 - 

你可以在頁面的任何地方插入這句 HTML 片段，你之前引入的腳本會自動檢查當前頁面上帶有 data-hk-* 屬性的元素，并針對你給出的屬性值向服務器請求數據，最后把得到的結果替換到上面的標簽內?？梢詤⒖?我博客中的例子。

如果你希望在文章列表頁中顯示各個頁面的訪問量分別是多少，那么你就要使用一個 url 來填充 data-hk-page 的屬性值，就像這樣：

 - 

那么 Hit Kounter 檢測到這個標簽以后，就會向服務器請求該地址的具體訪問量，并將默認值 - 替換為實際值?？梢詤⒖?我博客中的例子。

Hit Kounter 會在全局注入 Icarus 對象，它是與服務器交互的數據接口。通過它，我們就可以直接向服務器發送請求。先看看下面這個例子：

Icarus.request({
  api: "hk.page.get",
  v: "1.0",
  data: {
    pages: [
      { url: "http://test.com/1" },
      { url: "http://test.com/2" },
      { url: "http://test.com/3" }
    ]
  },
  success: function(results) {
    for (var i = 0; i < results.length; i++) {
      console.log(results[i].domain, results[i].url, results[i].count);
    }
  },
  failure: function(code, err) {
    console.log(code, err);
  }
});

上面這個例子中，我們主要是獲取了三個頁面的具體訪問量；目前 Icarus 支持的接口有四個（具體可以參考 Hit-Kounter-LC Wiki）：

hk.page.increment

hk.page.get

hk.page.getTop

hk.page.getByDomain

至于如何使用就由你們自由發揮啦。

我已經把遷移的成本降到最低，只要替換引入的文件即可：

因為 v0.2 版本基于 LeanCloud 的服務，所以需要額外引入 LeanCloud 的一個庫文件。另外需要注意的是，第二個文件除了版本號做了更新，還多了 -lc 幾個字符哦。

本次更新在將后端服務從 SAE 替換為 LeanCloud 的同時并沒有做太多的功能改進。最主要的一點功能改進是引入緩存機制，在數據超過默認的五分鐘之前，Icarus 不會向服務器發送新的 get 請求。（increment 請求當然還是照發不誤的啦）

Icarus 接口所接受的多余的參數現在需要放在 data 對象中，注意對你之前的代碼做一定修改。直接看例子可能比較直觀：

/*================
 * 老版本調用方式
 *================*/
Icarus.request({
  api: "hk.page.get",
  v: "1.0",
  pages: [                          // <---
    { url: "http://test.com/1" }    // <---
  ],                                // <---
  success: function(results) {},
  failure: function(code, err) {}
});

/*================
 * 新版本調用方式
 *================*/
Icarus.request({
  api: "hk.page.get",
  v: "1.0",
  data: {                           // <---
    pages: [                        // <---
      { url: "http://test.com/1" }  // <---
    ]                               // <---
  },                                // <---
  success: function(results) {},
  failure: function(code, err) {}
});

當然，Hit Kounter 未來會加入越來越多的功能，包括但不限于：

添加一個能夠獲得全站的訪問總量的 API

通過添加

• 上一篇：一個App完成入門篇（二）-搭建主框架
• 下一篇：編寫可維護的JavaScript