適用於 Java 的 Rapid SDK 中的例外處理
適用於 Java 的 Rapid SDK 使用執行期 (非受檢) 例外來傳遞錯誤。例外階層的根源為 OpenWorldException
,所有其他例外都由此衍生,OpenWorldException
永遠不會直接丟出。
OpenWorldException
分為兩類:
OpenWorldServiceException
:下游服務回傳錯誤時丟出,也就是說,服務成功接收到要求但無法處理。例外物件提供呼叫者多項關於錯誤的資訊,包含 HTTP 狀態碼和詳細訊息。OpenWorldAuthException
是該例外的子類別,認證失敗時丟出。OpenWorldClientException
:客戶端錯誤時丟出,無論是在嘗試傳送要求或剖析回覆。例如,如果未配置登入資訊,則會丟出OpenWorldConfigurationException
。
由於為非受檢例外,要處理哪些例外由呼叫者決定。原則上 OpenWorldClientException
不可重試,通常應於開發期間修復。OpenWorldServiceException
可能可以恢復,例如服務暫時不可用而導致的錯誤。因此,應著重於後者進行錯誤處理。