利用Node.js爲Node.js生成HttpStatusCode輔助類併發布到npm

      做爲一個好的Restfull Api不只在於service url的語義,可讀性,冪等,正交，做爲http狀態碼也很重要，一個好的Http Status Code給使用者一個很好的響應，好比200表示正常成功，201表示建立成功，409衝突，404資源不存在等等。因此在作一個基於node.js+mongodb+angularjs的demo時發現node.js express沒有提供相應的輔助類，可是本人不喜歡將201,404這類毫無語言層次語義的東西處處充斥着，因此最後決定本身寫一個，可是同時本人也很懶，不喜歡作重複的苦力活，怎麼辦？那就從我最熟悉的c#中HttpStatusCode枚舉中copy出來吧，最後爲了簡便在mac上因此採用了利用node.js去解析msdn關於httpstatuscode的文檔生成node.js的輔助類。

    代碼很簡單：

var http = require('http');
var fs = require('fs');
var $ = require('jquery');
var output = "httpStatusCode/index.js";
(function(){
   
    String.format = function() {
        var s = arguments[0];
        for (var i = 0; i < arguments.length - 1; i++) {
            var reg = new RegExp("\\{" + i + "\\}", "gm");
            s = s.replace(reg, arguments[i + 1]);
        }

 
        return s;
    };

 
    var options = {
        host:'msdn.microsoft.com',
        port:80,
        path:'/zh-cn/library/system.net.httpstatuscode.aspx'
    };

 
    http.get(options,function (response) {
        var html = "";
        response.on("data",function (chunk) {
            html += chunk;
        }).on("end", function () {
            handler(html);
        }).on('error', function (e) {
            console.log("Got error: " + e.message);
        });

 
    function getHttpStatusCode(htmlString) {
        var $doc = $(html);
        var rows = $doc.find("table#memberList tr:gt(0)");
        var status = {};
        rows.each(function(i,row){
            status[$(row).find("td:eq(1)").text()] =
                parseInt($(row).find("td:eq(2)").text().match(/\d+/).toString());
        });
       return status;
    };
    
    function generateCode(status){
       var code = "";
       code += "exports.httpStatusCode = " + JSON.stringify(status) + ";";
       return code;
    };
   
    function writeFile(code){
        fs.writeFile(output, code, function(err) {
            if(err) {
                console.log(err);
            } else {
                console.log("The file was saved " + output + "!");
            }
        });
    };

 
    function handler(html){
       var status = getHttpStatusCode(html);
       var code = generateCode(status);
       writeFile(code);
    };

 
  });
})();

代碼寄宿在github：https://github.com/greengerong/node-httpstatuscode

最終生成類爲：

exports.httpStatusCode = {
    "Continue": 100,
    "SwitchingProtocols": 101,
    "OK": 200,
    "Created": 201,
    "Accepted": 202,
    "NonAuthoritativeInformation": 203,
    "NoContent": 204,
    "ResetContent": 205,
    "PartialContent": 206,
    "MultipleChoices": 300,
    "Ambiguous": 300,
    "MovedPermanently": 301,
    "Moved": 301,
    "Found": 302,
    "Redirect": 302,
    "SeeOther": 303,
    "RedirectMethod": 303,
    "NotModified": 304,
    "UseProxy": 305,
    "Unused": 306,
    "TemporaryRedirect": 307,
    "RedirectKeepVerb": 307,
    "BadRequest": 400,
    "Unauthorized": 401,
    "PaymentRequired": 402,
    "Forbidden": 403,
    "NotFound": 404,
    "MethodNotAllowed": 405,
    "NotAcceptable": 406,
    "ProxyAuthenticationRequired": 407,
    "RequestTimeout": 408,
    "Conflict": 409,
    "Gone": 410,
    "LengthRequired": 411,
    "PreconditionFailed": 412,
    "RequestEntityTooLarge": 413,
    "RequestUriTooLong": 414,
    "UnsupportedMediaType": 415,
    "RequestedRangeNotSatisfiable": 416,
    "ExpectationFailed": 417,
    "UpgradeRequired": 426,
    "InternalServerError": 500,
    "NotImplemented": 501,
    "BadGateway": 502,
    "ServiceUnavailable": 503,
    "GatewayTimeout": 504,
    "HttpVersionNotSupported": 505
};

 

最後考慮到或許還有不少像我同樣懶散的人，因此共享此代碼發佈到了npm，只須要npm install httpstatuscode，即可以簡單實用，以下是一個測試demo：

var httpStatusCode = require("httpstatuscode").httpStatusCode;

 
var toBeEqual = function (actual,expected){
    if(actual !== expected){
     throw  (actual + " not equal " + expected);
    }
};

 
toBeEqual(httpStatusCode.OK,200);
toBeEqual(httpStatusCode.Created,201);
toBeEqual(httpStatusCode.BadRequest,400);
toBeEqual(httpStatusCode.InternalServerError,500);

 
console.log(httpStatusCode);
console.log("success");

懶人的文章老是代碼多餘文字，我喜歡代碼說明一切，感謝各位能閱讀此隨筆。