JavaTM Platform
Standard Ed. 6

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 值的文本表示形式

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策