org.ietf.jgss
類別 MessageProp

java.lang.Object
  org.ietf.jgss.MessageProp

public class MessageProp
extends Object

這是一個在 per-message GSSContext 方法中使用的、用來傳送 per-message 屬性的實用工具類別。

當與 GSSContext 介面的 wrap 和 getMIC 方法一起使用時，此類別的一個實例用於指示需要的“Quality-of-Protection”（保護質量，即 QOP），並請求是否將機密性服務應用於調用者提供的資料（僅限於 wrap）。要請求預設的 QOP，應該使用 0 值。

當與 GSSContext 介面的 unwrap 和 verifyMIC 方法一起使用時，此類別的一個實例用於指示在提供的訊息上所應用的 QOP 和機密性服務。如果使用 verifyMIC，則機密性狀態將始終為 false。從這些方法返回後，此物件還將包含可用於處理過的標記的任何增補狀態值。增補狀態值可以表示舊的標記、無序列標記、間距標記或重複的標記。

從以下版本開始：

1.4

另請參見：

GSSContext.wrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.unwrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.getMIC(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.verifyMIC(byte[], int, int, byte[], int, int, org.ietf.jgss.MessageProp)

建構子摘要

MessageProp(boolean privState)
設置所需私密狀態的建構子。

MessageProp(int qop, boolean privState)
設置 qop 和私密狀態值的建構子。

方法摘要

int	getMinorStatus() 檢索基礎驗證機制可能已經為此 per-message 操作設置的次要狀態碼.
String	getMinorString() 檢索解釋次要狀態碼的字元串。
boolean	getPrivacy() 檢索私密狀態。
int	getQOP() 檢索 QOP 值。
boolean	isDuplicateToken() 測試此標記是否為先前標記的一個副本。
boolean	isGapToken() 測試是否未接收到需要的標記（即一個或多個原先的標記尚未成功處理）。
boolean	isOldToken() 測試此標記是否還有效（即是否標記已經太陳舊而無法檢查其複製情況）。
boolean	isUnseqToken() 測試後面的標記是否已進行處理。
void	setPrivacy(boolean privState) 設置私密狀態。
void	setQOP(int qop) 設置 QOP 值。
void	setSupplementaryStates(boolean duplicate, boolean old, boolean unseq, boolean gap, int minorStatus, String minorString) 此方法將設置 MessageProp 中的增補資訊標記的狀態和次要狀態。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

MessageProp

public MessageProp(boolean privState)

設置所需私密狀態的建構子。所用的 QOP 值為 0。

參數：

privState - 私密（亦即機密性）狀態

MessageProp

public MessageProp(int qop,
                   boolean privState)

設置 qop 和私密狀態值的建構子。

參數：

qop - QOP 值

privState - 私密（亦即機密性）狀態

方法詳細資訊

getQOP

public int getQOP()

檢索 QOP 值。

返回：

表示 QOP 值的 int

另請參見：

setQOP(int)

getPrivacy

public boolean getPrivacy()

檢索私密狀態。

返回：

如果私密（即機密性）狀態為 true，則返回 true，否則，則返回 false。

另請參見：

setPrivacy(boolean)

setQOP

public void setQOP(int qop)

設置 QOP 值。

參數：

qop - 將 QOP 設置為的 int 值

另請參見：

getQOP()

setPrivacy

public void setPrivacy(boolean privState)

設置私密狀態。

另請參見：

getPrivacy()

isDuplicateToken

public boolean isDuplicateToken()

測試此標記是否為先前標記的一個副本。

返回：

如果是副本，則返回 true，否則返回 false。

isOldToken

public boolean isOldToken()

測試此標記是否還有效（即是否標記已經太陳舊而無法檢查其複製情況）。

返回：

如果標記的有效期已過，則返回 true，否則返回 false。

isUnseqToken

public boolean isUnseqToken()

測試後面的標記是否已進行處理。

返回：

如果後面的標記已經處理，則返回 true，否則返回 false。

isGapToken

public boolean isGapToken()

測試是否未接收到需要的標記（即一個或多個原先的標記尚未成功處理）。

返回：

如果未接收到需要的 per-message 標記，則返回 true，否則返回 false。

getMinorStatus

public int getMinorStatus()

檢索基礎驗證機制可能已經為此 per-message 操作設置的次要狀態碼.

返回：

int 次要狀態

getMinorString

public String getMinorString()

檢索解釋次要狀態碼的字元串。

返回：

一個與次要狀態碼對應的字元串。當未曾設置次要狀態碼時，將返回 null。

setSupplementaryStates

public void setSupplementaryStates(boolean duplicate,
                                   boolean old,
                                   boolean unseq,
                                   boolean gap,
                                   int minorStatus,
                                   String minorString)

此方法將設置 MessageProp 中的增補資訊標記的狀態和次要狀態。它不是由應用程序使用，而是由 GSS 實作使用，用來將此資訊返回到 per-message context 方法的調用者。

參數：

duplicate - 如果標記是先前標記的一個副本，則返回 true，否則，返回 false

old - 如果標記的有效期已過，則返回 true，否則，返回 false

unseq - 如果後面的標記已處理過，則返回 true，否則，返回 false

gap - 如果一個或多個原先的標記尚未成功處理過，則返回 true，否則，返回 false

minorStatus - per-message 操作的 int 次要狀態碼

minorString - minorStatus 值的文本表示形式