錯誤影像

錯誤響應影像。 當出現錯誤時,Image Serving通常返回帶有文本消息的錯誤狀態。

attribute::ErrorImage 允許在出錯時配置要返回的映像、目錄條目或模板。

注意

也可以使用 attribute::DefaultImage

可以配置「影像服務」模板,該模板可能會將錯誤消息文本呈現到響應影像中。 以下預定義變數可包含在 $error.title 模板,用簡短的錯誤說明替換,和 $error.message,用更詳細的錯誤說明替換(詳細級別配置為 attribute::ErrorDetail)。

如果錯誤映像/模板可以成功處理,則返回HTTP狀態200。 如果在此處理過程中出現錯誤,則返回HTTP錯誤狀態和文本消息。

屬性

文本字串。 如果指定,則必須是影像目錄中的有效目錄::Id值或相對(至 attribute::RootPath)或映像伺服器可訪問的映像檔案的絕對路徑。

預設

繼承自 default::ErrorImage 的子菜單。 如果已定義但為空,則會禁用錯誤影像行為,即使 default::ErrorImage 定義,並返回HTTP錯誤狀態和文本消息。

範例

要獲取包含錯誤資訊的響應影像,必須先在影像目錄中定義模板。 在這種情況下,我們會在映像目錄中建立一個名為 onError,包含以下內容 catalog::Modifier:

size=300,300&bgc=ffffff&text=$error.message$

模板已註冊 attribute::ErrorImage:

ErrorImage=myCatalog/onError

在此示例中,使用預設字型、字型顏色和字型大小來呈現文本。

另請參閱

屬性::RootPath目錄::ID屬性::DefaultImage屬性::ErrorDetail

本頁內容