錯誤影像

錯誤響應影像。 當出現錯誤時，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

本頁內容