DIV CSS 佈局教程網

jQuery Deferred 與遞迴重試:語音合成批次處理實例
編輯:關於JavaScript     

當一個非同步任務可能失敗、且失敗後值得再試幾次時,該怎麼組織程式碼?本文以文字轉語音(TTS)的批次合成場景為例,說明如何用 jQuery Deferred 搭配遞迴,做出「失敗自動重試、超過次數則放棄」的流程。

單筆合成:包裝成 Promise

function runAsyncTTS(text, speecher, audiopath) {
  var def = jQuery.Deferred();
  var args = {
    "SynthText": text,
    "VoiceSpeecher": speecher,
    "WordSpeed": "3",
    "UseCSSML": "0",
    "AudioPath": audiopath
  };
  tts.asyncTTS(JSON.stringify(args), function(err, result) {
    def.resolve(result);
  });
  return def.promise();
}

這是最基本的 Promise 包裝:建立 Deferred,把 callback 風格的 API 包起來,最後回傳 promise 而非 deferred 本身。只回傳 promise 是刻意的——外部只能掛 done/fail,無法自行呼叫 resolve,狀態的所有權留在函式內部。

批次合成:把多筆拼成一次請求

function textToSpeechBat(metaJson, speecher, audioPath) {
  var def = $.Deferred();
  var result = { originalWords: "", resultJsonArr: [] };
  var jsons = "";

  for(var index = 0; index < metaJson.words.length; index++) {
    var audioName = metaJson.words[index]['audio'];
    audioName = audioName.replace('.mp3','');
    var audioFile = audioPath + "/" + audioName + '.wav';

    var args = '{"SynthText": "' + metaJson.words[index]['word'] +
               '", "VoiceSpeecher": "' + speecher +
               '", "WordSpeed": "3", "UseCSSML": "0", "AudioPath": "' +
               audioFile + '"}';

    jsons += args + "|";
  }

  jsons = jsons.substr(0, jsons.length - 1);

  tts.asyncTTSBat(jsons, function(err, ret) {
    result['resultJsonArr'] = ret.split('|');
    def.resolve(result);
  });

  return def.promise();
}

這裡用豎線作為分隔符,把多筆參數串成一串再送出,回傳後也用同一個符號切回陣列。最後那行 substr 是為了去掉尾端多餘的分隔符。

這個做法有明顯的風險:用字串拼接產生 JSON,只要 word 中出現引號或反斜線就會產生無效的 JSON。應改用 JSON.stringify();而自訂分隔符也可能與內容中的豎線衝突。若 API 支援,傳陣列會更穩妥。

帶重試的批次合成

function textToSpeechWithTryTimes(metaJson, speecher, audioPath, times) {
  var def = $.Deferred();
  var ttsRet = null;

  var ttsCallBack = function(index) {
    if(index < times) {
      textToSpeechBat(metaJson, speecher, audioPath).done(function (ret) {
        console.log("textToSpeechWithTryTimes: " + JSON.stringify(ret));
        ttsRet = ret;
        var resultJsonArr = ret.resultJsonArr;
        var audioFlag = true;

        for(var i = 0; i < resultJsonArr.length; i++) {
          if(resultJsonArr[i] == "") {
            audioFlag = false;
            break;
          }
          var retObj = JSON.parse(resultJsonArr[i]);
          console.log(retObj['audioFlag']);
          if(retObj['audioFlag'] == 'false' || retObj['result'] == "") {
            audioFlag = false;
            break;
          }
        }
        console.log(audioFlag);

        if(audioFlag == false) {
          console.log("textToSpeechWithTryTimes 失敗,重試");
          ttsCallBack(++index);
        } else {
          console.log("textToSpeechWithTryTimes 成功,回傳");
          def.resolve(ret);
        }
      });
    }

    if(index == times) {
      console.log("textToSpeechWithTryTimes 已達重試上限,回傳");
      def.resolve(ttsRet);
    }
  };

  ttsCallBack(0);
  return def.promise();
}

這段程式在做什麼

核心是一個名為 ttsCallBack 的遞迴函式,它帶一個 index 計數器:

  1. 若 index 未達上限,就呼叫批次合成。
  2. 合成完成後,逐筆檢查回傳結果:有空字串就當失敗,有 JSON 解析後 audioFlag 為 false 或 result 為空也當失敗。
  3. 失敗則 index 加一後遞迴重試;全部成功則 resolve 並結束。
  4. index 達到上限時,resolve 最後一次結果(可能是失敗的),讓流程得以繼續而非永遠卡住。

這種「用遞迴取代 callback 巢狀」的寫法,在 Promise 出現前是處理序列式非同步的常見手法,可讀性明顯優於多層縮排的 callback hell。

可以怎麼改進

  • 用 jQuery.Deferred 的 pipe/then 串接,能把重試邏輯寫得更線性,不必自己管理計數器的遞迴入口。
  • 加一點延遲再重試。連續立即重試對伺服器不友善,實務上通常會用退避(backoff)策略,例如 setTimeout 遞增間隔。
  • 區分「可重試」與「不可重試」的錯誤。網路逾時值得重試,但參數錯誤重試幾次都一樣。範例中一律重試,會浪費資源。
  • 用 async/await 重寫會更清楚:
    async function withRetry(fn, times) {
      for (var i = 0; i < times; i++) {
        try { return await fn(); }
        catch (e) { if (i === times - 1) throw e; }
      }
    }
    迴圈取代遞迴,意圖一目了然。
  • 原範例的 resolve 邏輯略顯鬆散:達上限時無論成功失敗都 resolve,呼叫端難以分辨。用 reject 表達「重試耗盡仍失敗」語意更準確。

這個實例的價值在於展示了一個完整模式:把非同步 API 包成 promise、用遞迴實作重試、在成功與耗盡兩條路徑上都給出明確的結束點。理解它之後,改用 async/await 重寫會非常直觀。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved