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

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

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

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

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

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

如何為你的博客添加訪問統(tǒng)計

Hit Kounter 的 JS 接口

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

小結(jié)：Hit Kounter 的未來

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

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

 - 

你可以在頁面的任何地方插入這句 HTML 片段，你之前引入的腳本會自動檢查當(dāng)前頁面上帶有 data-hk-* 屬性的元素，并針對你給出的屬性值向服務(wù)器請求數(shù)據(jù)，最后把得到的結(jié)果替換到上面的標(biāo)簽內(nèi)。可以參考 我博客中的例子。

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

 - 

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

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

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

至于如何使用就由你們自由發(fā)揮啦。

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

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

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

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

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

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

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

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

通過添加

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