MQHeaderFactory

所有已知實作類別:

PCFHeaderFactory, PCFHeaderFactory
```
公用介面 MQHeaderFactory
```
MQHeaderFactory 用來動態建立新的 MQHeader 實例。這在解碼 (剖析) 訊息中的標頭內容時，或在工具應用程式中建立新標頭實例之類的作業時使用。例如，工具應用程式可以提供可用來編寫訊息的標頭類型型錄。大部分應用程式都不需要直接使用 MQHeaderFactory 介面 ;MQHeaderRegistry 會封裝一組涵蓋標準 MQ 標頭類型的 MQHeaderFactory 實例，新的標頭類型可以直接登錄，而不需要定義新的 MQHeaderFactory 類型。
個別 MQHeaderFactory 可以處理單一或多個訊息格式。 MQHeaderFactories 已向「登錄」登錄，可讓您依格式或類型來查閱它們。預設 MQHeaderRegistry 實例具有標準 MQ 標頭類型及格式 (包括 PCF) 的預先登錄 Factory。

另請參閱:

MQHeaderRegistry, MQHeaderIterator

巢狀類別摘要

巢狀類別
修飾元和類型介面和說明

static interface MQHeaderFactory.Registry
代表 MQHeaderFactories 登錄及其支援的類型和格式的介面。

巢狀類別
修飾元和類型	介面和說明
`static interface`	`MQHeaderFactory.Registry` 代表 MQHeaderFactories 登錄及其支援的類型和格式的介面。

方法摘要

所有方法實例方法抽象方法
修飾元和類型	方法和說明
`MQHeader`	`create(java.lang.String type)`
`MQHeader`	`decode(MQHeaderContext message)` 從訊息解碼 (剖析) MQHeader 實例。
`java.util.Collection<?>`	`getSupportedFormats()`
`java.util.Collection<?>`	`getSupportedTypes()`

- 方法詳細資料
  - 建立
```
MQHeader create (java.lang.String type)
         throws java.lang.InstantiationException
```
    參數：
    
    type-
    
    傳回:
    
    具名類型的 MQHeader 實例。標頭 Factory 已知的類型可以從 getSupportedTypes 方法取得。這些類型對應於 MQHeader 實例上類型方法所傳回的值。
    
    擲出:
    
    java.lang.InstantiationException
  - 解碼
```
MQHeader 解碼 (MQHeaderContext 訊息)
         throws java.lang.Exception ，
                MQDataException,
                java.io.IOException
```
    從訊息解碼 (剖析) MQHeader 實例。訊息環境定義物件包含與訊息或位元組串流中現行位置相關聯的格式、編碼及 CCSID。 MQHeaderFactory 履行此方法的作業基本上是:
    1. 識別接下來出現在訊息中的標頭類型。這可能是由 Factory 直接識別，且與格式相關聯; 或者 MQHeaderFactory 可能需要查看訊息內容來偵測類型。
    2. 已識別正確類型，請實例化該類型的 MQHeader 實例。
    3. 在訊息上呼叫標頭物件的讀方法。
    4. 選擇性地更新訊息環境定義物件的格式、編碼及文字集成員。
    5. 傳回標頭實例。
    如果沒有其他標頭，或此 MQHeaderFactory 無法在訊息中的現行位置識別標頭，則此方法可能會傳回空值。
    參數：
    
    message-標頭環境定義。
    
    傳回:
    
    剖析的 MQHeader
    
    擲出:
    
    java.lang.Exception-(容許 com.ibm.pcf 類別擲出 MQException)
    
    MQDataException
    
    java.io.IOException
  - getSupportedFormats
```
java.util.Collection<?> getSupportedFormats()
```
    傳回:
    
    與此 MQHeaderFactory 所支援的標頭類型相關聯的格式名稱集。 MQHeaderFactory 實例能夠解碼這些格式的訊息。
  - getSupportedTypes
```
java.util.Collection<?> getSupportedTypes()
```
    傳回:
    
    此 MQHeaderFactory 支援的標頭類型集。 MQHeaderFactory 實例可以建立這些類型的新實例。

建立

解碼

getSupportedFormats

getSupportedTypes