JavaTM 2 Platform
Standard Ed. 5.0

org.ietf.jgss
クラス MessageProp

java.lang.Object
  上位を拡張 org.ietf.jgss.MessageProp

public class MessageProp
extends Object

このユーティリティクラスは、メッセージごとの GSSContext メソッド内で使用して、メッセージごとのプロパティを設定します。

GSSContext インタフェースの wrap および getMIC メソッドと組み合わせてこのクラスのインスタンスを使用すれば、特定の保護品質 (QOP) を指定したり、機密性サービスを呼び出し側から渡されたデータに適用するかどうかを要求したり (wrap のみ) できます。デフォルトの QOP を要求する場合は、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()
          配下の機構がこのメッセージごとの操作に設定したマイナー状態コードを取り出します。
 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、そうでない場合は false
関連項目:
setPrivacy(boolean)

setQOP

public void setQOP(int qop)
QOP 値を設定します。

パラメータ:
qop - QOP 値が設定される int 値
関連項目:
getQOP()

setPrivacy

public void setPrivacy(boolean privState)
プライバシ状態を設定します。

パラメータ:
privState - プライバシ (機密性) 状態が真の場合は true、そうでない場合は false
関連項目:
getPrivacy()

isDuplicateToken

public boolean isDuplicateToken()
このトークンが以前のトークンの複製かどうかをテストします。

戻り値:
複製である場合は true、そうでない場合は false

isOldToken

public boolean isOldToken()
トークンの有効期限が切れているかどうか、つまりトークンが古いため重複を確認できないかどうかをテストします。

戻り値:
トークンの有効期限が切れている場合は true、そうでない場合は false

isUnseqToken

public boolean isUnseqToken()
後続のトークンがすでに処理されているかどうかをテストします。

戻り値:
後続のトークンがすでに処理されている場合は true、そうでない場合は false

isGapToken

public boolean isGapToken()
予期したトークンが着信しているかどうか、つまり先行するトークンが正常に処理されているかどうかをテストします。

戻り値:
予期したメッセージごとのトークンが着信しなかった場合は true、そうでない場合は false

getMinorStatus

public int getMinorStatus()
配下の機構がこのメッセージごとの操作に設定したマイナー状態コードを取り出します。

戻り値:
マイナー状態を表す int

getMinorString

public String getMinorString()
マイナー状態コードについて説明する文字列を取り出します。

戻り値:
マイナー状態コードに対応する String。マイナー状態コードが設定されていない場合は、null が返される

setSupplementaryStates

public void setSupplementaryStates(boolean duplicate,
                                   boolean old,
                                   boolean unseq,
                                   boolean gap,
                                   int minorStatus,
                                   String minorString)
このメソッドは、補足情報フラグの状態とマイナー状態を MessageProp に設定します。このメソッドは、アプリケーションではなく GSS 実装で使用し、メッセージごとの context メソッドの呼び出し側にこの情報を返します。

パラメータ:
duplicate - このトークンが以前のトークンの複製であった場合は true、そうでない場合は false
old - このトークンの有効期限が切れている場合は true、そうでない場合は false
unseq - 後続のトークンがすでに処理されている場合は true、そうでない場合は false
gap - 先行するトークンが正常に処理されていない場合は true、そうでない場合は false
minorStatus - メッセージごとの操作のマイナー状態コードを表す int
minorString - minorStatus 値のテキスト表現

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。