/** 
 * 前端需要開啟history模式，而后端根據url并不知道前端在請求api還是在請求頁面，如localhost:4200/home這種url，前端理所當然認為“我需要得到html，并跳轉到首頁”，然而后端并不能區分。
 * 因此需要一種判斷機制，來使得后端能分析出前端的請求目的。
 * connect-history-api-fallback 這個中間件正好幫我們完成了上述分析操作，來看下它是怎么實現的吧！
 * 第一次把自己的源碼分析思路寫出來，說得不對的地方，請指出！
 */

'use strict';

var url = require('url');

exports = module.exports = function historyApiFallback(options) {
 // 接收配置參數
 options = options || {};
 // 初始化日志管理器
 var logger = getLogger(options);

 // 中間件是要返回一個函數的，函數形參有req, res, next
 return function(req, res, next) {
  var headers = req.headers;
  if (req.method !== 'GET') {
   // 如果請求方法不是GET類型，說明不需要返回html，那么就調用next()，把請求交給下一個中間件
   logger(
    'Not rewriting',
    req.method,
    req.url,
    'because the method is not GET.'
   );
   return next();
  } else if (!headers || typeof headers.accept !== 'string') {
   // 如果沒有請求頭，或者請求頭中的accept不是字符串，說明不是一個標準的http請求，也不予處理，把請求交給下一個中間件
   logger(
    'Not rewriting',
    req.method,
    req.url,
    'because the client did not send an HTTP accept header.'
   );
   return next();
  } else if (headers.accept.indexOf('application/json') === 0) {
   // 如果客戶端希望得到application/json類型的響應，說明也不是在請求html，也不予處理，把請求交給下一個中間件
   logger(
    'Not rewriting',
    req.method,
    req.url,
    'because the client prefers JSON.'
   );
   return next();
  } else if (!acceptsHtml(headers.accept, options)) {
   // 如果請求頭中不包含配置的Accept或者默認的['text/html', '*/*']，那么說明也不是在請求html，也不予處理，把請求交給下一個中間件
   logger(
    'Not rewriting',
    req.method,
    req.url,
    'because the client does not accept HTML.'
   );
   return next();
  }

  // 走到這里說明是在請求html了，要開始秀操作了

  // 首先利用url模塊的parse方法解析下url，會得到一個對象，包括protocol，hash，path, pathname, query, search等字段，類似瀏覽器的location對象
  var parsedUrl = url.parse(req.url);
  var rewriteTarget;
  // 然后得到配置中的rewrites，也就是重定向配置；
  // 重定向配置是一個數組，每一項都包含from和to兩個屬性；
  // from是用來正則匹配pathname是否需要重定向的;
  // to則是重定向的url，to可以是一個字符串，也可以是一個回調方法來返回一個字符串，回調函數接收一個上下文參數context，context包含三個屬性（parsedUrl，match，request）
  options.rewrites = options.rewrites || [];
  // 遍歷一波重定向配置
  for (var i = 0; i < options.rewrites.length; i++) {
   var rewrite = options.rewrites[i];
   // 利用字符串的match方法去匹配
   var match = parsedUrl.pathname.match(rewrite.from);
   if (match !== null) {
    // 如果match不是null，說明pathname和重定向配置匹配上了
    rewriteTarget = evaluateRewriteRule(parsedUrl, match, rewrite.to, req);

    if(rewriteTarget.charAt(0) !== '/') {
     // 推薦使用/開頭的絕對路徑作為重定向url
     logger(
      'We recommend using an absolute path for the rewrite target.',
      'Received a non-absolute rewrite target',
      rewriteTarget,
      'for URL',
      req.url
     );
    }

    logger('Rewriting', req.method, req.url, 'to', rewriteTarget);
    // 進行重定向url操作
    req.url = rewriteTarget;
    return next();
   }
  }

  var pathname = parsedUrl.pathname;
  // 首先說明一下：校驗邏輯默認是會去檢查url中最后的.號的，有.號的說明在請求文件，那就跟history模式就沒什么鳥關系了
  // 我暫且將上述規則成為“點號校驗規則”
  // disableDotRule為true，代表禁用點號校驗規則
  if (pathname.lastIndexOf('.') > pathname.lastIndexOf('/') &&
    options.disableDotRule !== true) {
   // 如果pathname的最后一個/之后還有.，說明請求的是/a/b/c/d.*的文件（*代表任意文件類型）;
   // 如果此時配置disableDotRule為false，說明開啟點號校驗規則，那么不予處理，交給其他中間件
   logger(
    'Not rewriting',
    req.method,
    req.url,
    'because the path includes a dot (.) character.'
   );
   return next();
  }

  // 如果pathname最后一個/之后沒有.，或者disableDotRule為true，都會走到最后一步：重寫url
  // 重寫url有默認值/index.html，也可以通過配置中的index自定義
  rewriteTarget = options.index || '/index.html';
  logger('Rewriting', req.method, req.url, 'to', rewriteTarget);
  // 重寫url
  req.url = rewriteTarget;
  // 此時再將執行權交給下一個中間件（url都換成index.html了，后面的路由等中間件也不會再處理了，然后前端接收到html就開始解析路由了，目的達到！）
  next();
 };
};

// 判斷重定向配置中的to
function evaluateRewriteRule(parsedUrl, match, rule, req) {
 if (typeof rule === 'string') {
  // 如果是字符串，直接返回
  return rule;
 } else if (typeof rule !== 'function') {
  // 如果不是函數，拋出錯誤
  throw new Error('Rewrite rule can only be of type string or function.');
 }

 // 執行自定義的回調函數，得到一個重定向的url
 return rule({
  parsedUrl: parsedUrl,
  match: match,
  request: req
 });
}

// 判斷請求頭的accept是不是包含在配置數組或默認數組的范圍內
function acceptsHtml(header, options) {
 options.htmlAcceptHeaders = options.htmlAcceptHeaders || ['text/html', '*/*'];
 for (var i = 0; i < options.htmlAcceptHeaders.length; i++) {
  if (header.indexOf(options.htmlAcceptHeaders[i]) !== -1) {
   return true;
  }
 }
 return false;
}

// 處理日志
function getLogger(options) {
 if (options && options.logger) {
  // 如果有指定的日志方法，則使用指定的日志方法
  return options.logger;
 } else if (options && options.verbose) {
  // 否則，如果配置了verbose，默認使用console.log作為日志方法
  return console.log.bind(console);
 }
 // 否則就沒有日志方法，就不記錄日志咯
 return function(){};
}