重算與播放器¶
〈重新計算已完成的步驟串〉怎麼與播放共用播放器:由誰執行、執行時按鈕與其他請求會怎樣、哪些請求被拒絕,以及取消或出錯時留下了什麼。
重算跑在播放器執行緒上,所以它絕不會與播放同時進行。
- 播放器閒置時。 以單次工作(one-shot)的形式執行。計算期間狀態徽章顯示
Running;暫停會讓它停在區塊邊界,停止則在該處取消它。這段期間POST /api/Execution/start與run-step會以Start--BusyOneShot拒絕,run-line則以RunLine--BusyOneShot拒絕。在應用程式裡,重算執行中時開始不能按;重算暫停時這顆按鈕顯示為繼續,按下會讓重算繼續;會碰到這兩個拒絕的按鈕,是重算暫停時的執行單步與執行單行 NC。這段期間另一個請求發出的工件呼叫——匯出、Diff——會在兩個區塊之間執行並在那裡回應,暫停中的重算仍保持暫停。等重算回應之後再開始:它在單次工作結束之後才回應;除非它算完時恰好有另一個請求的工件呼叫進來——那個呼叫接著先執行,在它結束之前開始都會被拒絕。 - 任務正在播放或暫停於播放器上時。 它會被排入播放的下一個步進點,一個區塊接一個區塊地跑,並把播放持在那裡,直到重算完成。暫停與續播對它的作用和對播放完全一樣;暫停中的播放會先為了重算而續播,算完再回到暫停。若播放在時限內到不了步進點,請求會被撤回(
--BusyPacePointTimeout;等待時間是 LocalProjectService.RecomputePacePointTimeout (API),預設 30 秒)。 - 由另一條執行緒在本工作階段播放 NC 程式時——主機直接發出的播放請求,此時播放器閒置而步驟串仍在增長——會以
--BusyAnotherThread拒絕。已有一次重算在進行中時,第二次以--Busy拒絕。播放器閒置時是立刻拒絕;播放中則看前一次怎麼跑。前一次是任務自己跑的——腳本的RecomputeStepPhysics(),或任務清單裡明示的安裝角估算——它的區塊邊界就是播放的步進點:請求在下一個步進點就被取出並拒絕,之後也不會執行;請等前一次結束後再重算。前一次本身也是排在步進點上的——另一個請求,或待命的安裝角估算——第二次就排在它後面:前一次在上述時限內結束,第二次接著執行;時限已過而前一次還在跑,才拒絕(前一次在重算時以--Busy,待命的估算還在估算時以--BusyPacePointTimeout)。另一個請求要求的工件呼叫——匯出或Diff,不論是在播放的步進點上,還是在閒置的播放器上以單次工作執行——正佔著播放器時要求的重算,會在那個呼叫之後執行;到了上述時限呼叫還在跑,就以--BusyBehindMeshedGeomCall撤回,訊息裡帶著那個呼叫的名稱:等它做完再重算一次。播放器閒置而主機正在拆除工作階段時——專案正在更換,或播放器以外的呼叫正在重置執行環境或結束工作階段——要求的重算以--BusyReset拒絕、什麼都不重算;排在播放的步進點上、在工作階段的拆除開始之後才被播放取出的——主機的拆除,或播放器自己的「重置」——也以--BusyReset拒絕;播放還沒取出它就結束的——被這樣的拆除或被「停止」停掉,或因錯誤而結束——以--CanceledBeforePacePoint結束、什麼都不重算。在播放器的這次執行正在收尾、已不再接受工作的那一刻送到的,以--BusyRunEnding拒絕。兩者都稍後再試即可。沒有工作階段的——從未開始,或請求讀到的那個在播放器取出重算之前已結束或被換掉(例如被「重置」)——以--NoSession拒絕、什麼都不重算:先播放程式,再重算。經 HTTP 時,完全沒有工作階段的請求會先碰到路由的409(〈透過 HTTP〉)。有一份播放結果正開著回顧、或另一個請求正在開啟回顧時要求的重算,以--Reviewing拒絕、什麼都不重算:先關閉回顧——播放器的「重置」、CloseNcResultReview(),或回顧播放結果命令的關閉回顧。另一個請求正在開啟或關閉回顧、而那一刻沒有回顧開著——多半是關閉正在清掉它的時候——要求的重算,以--BusyReview拒絕、什麼都不重算:等那個請求回應之後再重算。
取消會保留已經寫下的部分:回報的步驟區間帶著新值,其餘保留原值,--Canceled 會說明這件事。要做完就再重算一次:它會從這項更動的鏈起點重新開始——已經改寫過的步驟會再算一次,更動需要力核心的就再過一次力核心、再耗一次授權步數——不會把被取消那次的邊界當成已收斂。被取消那次寫入時用的輸入會留在紀錄裡、和先前的值並存,所以之後把輸入改回原值,仍然會重算。在開始之前就被取消的重算——「停止」之後腳本才執行到的 RecomputeStepPhysics(),或在重算開始之前落下的「停止」——什麼都不寫,也不在紀錄裡留下任何輸入;--CanceledBeforeStart 會說明這件事。要套用這項更動就再重算一次。已經開始(說過 --Start)之後的取消說 --Canceled,一個區塊都還沒做完時,回報的區間是空的。
重算寫過之後才因錯誤結束——步驟儲存庫或訊息通道在某個區塊裡出錯,或播放器自己的步進點在兩個區塊之間出錯——寫下的部分也同樣保留。已經提交的區塊帶著新值,其餘保留原值;--Fault 會說出錯誤,它前面的 --FaultKeptRange 會說出已取代的區間;那次寫入時用的輸入會留在紀錄裡、和先前的值並存;LocalProjectService.StepPhysicsRecomputed (API) 會回報那個區間,和取消之後一樣。請求以那個區間的 Canceled 作答——不算成功,HTTP 和應用程式裡都是——什麼都不會被退回。要做完就再重算一次:它會從這項更動的鏈起點重新開始,和取消之後完全一樣。第一個區塊還沒寫下就出錯的,什麼都不會改,答 Refused。從任務腳本或主控台直接呼叫時,不作答而是把錯誤拋出,也不發這兩則訊息;保留區間、發事件、記下輸入這些收尾照樣做完。
延伸閱讀¶
- 重新計算已完成的步驟串 —— 每一種改動重算會重跑什麼、什麼時候改要求重新播放、怎麼執行與怎麼讀結果