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

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

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

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

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

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

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

Hit Kounter 的 JS 接口

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

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

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

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

 - 

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

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

 - 

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

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

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);
  }
});

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

hk.page.increment

hk.page.get

hk.page.getTop

hk.page.getByDomain

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

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

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

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

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

/*================
 * 老版本調(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 未來會(huì)加入越來越多的功能，包括但不限于：

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

通過添加

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