JavaTM 2 Platform
Standard Ed. 5.0

org.ietf.jgss
类 GSSException

java.lang.Object
  继承者 java.lang.Throwable
      继承者 java.lang.Exception
          继承者 org.ietf.jgss.GSSException
所有已实现的接口:
Serializable

public class GSSException
extends Exception

每当发生 GSS-API 错误(包括任何特定于机制的错误)时,都会抛出此异常。它包括主要和次要的 GSS-API 状态码。主要错误代码是指那些在此类的 GSS-API 级别定义的代码。次要错误代码是指特定于机制的错误代码,他们可以提供附加的信息。基础机制实现负责在抛出此异常时设置适当的次要状态码除向调用方提供数值错误代码外,此类还执行从其数值到文本表示形式的映射。

从以下版本开始:
1.4
另请参见:
序列化表格

字段摘要
static int BAD_BINDINGS
          通道绑定不匹配。
static int BAD_MECH
          请求了不受支持的机制。
static int BAD_MIC
          具有无效的完整性检查的标记。
static int BAD_NAME
          提供了无效名称。
static int BAD_NAMETYPE
          提供了不受支持的类型的名称。
static int BAD_QOP
          不受支持的 QOP 值。
static int BAD_STATUS
          无效的状态码。
static int CONTEXT_EXPIRED
          安全上下文过期。
static int CREDENTIALS_EXPIRED
          过期的凭据。
static int DEFECTIVE_CREDENTIAL
          有缺陷的凭据。
static int DEFECTIVE_TOKEN
          有缺陷的标记。
static int DUPLICATE_ELEMENT
          请求了重复的凭据元素。
static int DUPLICATE_TOKEN
          该标记是前面标记的一个副本。
static int FAILURE
          未在 GSS-API 级别指定的一般故障。
static int GAP_TOKEN
          未收到需要的 per-message 标记。
static int NAME_NOT_MN
          包含多机制元素的名称。
static int NO_CONTEXT
          无效的安全上下文。
static int NO_CRED
          无效的凭据。
static int OLD_TOKEN
          该标记已无效。
static int UNAUTHORIZED
          未授权的操作。
static int UNAVAILABLE
          不可用的操作。
static int UNSEQ_TOKEN
          后面的标记已处理过。
 
构造方法摘要
GSSException(int majorCode)
          使用指定的主要代码创建一个 GSSException 对象。
GSSException(int majorCode, int minorCode, String minorString)
          使用指定的主要代码、次要代码和次要代码文本性解释,创建一个 GSSException 对象。
 
方法摘要
 int getMajor()
          返回导致抛出此异常的问题的 GSS-API 级主要错误代码。
 String getMajorString()
          返回一个字符串,解释在此异常中 GSS-API 级的主要错误代码。
 String getMessage()
          返回主要和次要状态码的文本表示形式。
 int getMinor()
          返回导致抛出此异常的问题的机制级错误代码。
 String getMinorString()
          返回解释特定于机制的错误代码的字符串。
 void setMinor(int minorCode, String message)
          由异常抛出器使用,以设置机制级的次要错误代码及其字符串解释。
 String toString()
          返回主要和次要状态码的文本表示形式。
 
从类 java.lang.Throwable 继承的方法
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

BAD_BINDINGS

public static final int BAD_BINDINGS
通道绑定不匹配。

另请参见:
常量字段值

BAD_MECH

public static final int BAD_MECH
请求了不受支持的机制。

另请参见:
常量字段值

BAD_NAME

public static final int BAD_NAME
提供了无效名称。

另请参见:
常量字段值

BAD_NAMETYPE

public static final int BAD_NAMETYPE
提供了不受支持的类型的名称。

另请参见:
常量字段值

BAD_STATUS

public static final int BAD_STATUS
无效的状态码。

另请参见:
常量字段值

BAD_MIC

public static final int BAD_MIC
具有无效的完整性检查的标记。

另请参见:
常量字段值

CONTEXT_EXPIRED

public static final int CONTEXT_EXPIRED
安全上下文过期。

另请参见:
常量字段值

CREDENTIALS_EXPIRED

public static final int CREDENTIALS_EXPIRED
过期的凭据。

另请参见:
常量字段值

DEFECTIVE_CREDENTIAL

public static final int DEFECTIVE_CREDENTIAL
有缺陷的凭据。

另请参见:
常量字段值

DEFECTIVE_TOKEN

public static final int DEFECTIVE_TOKEN
有缺陷的标记。

另请参见:
常量字段值

FAILURE

public static final int FAILURE
未在 GSS-API 级别指定的一般故障。

另请参见:
常量字段值

NO_CONTEXT

public static final int NO_CONTEXT
无效的安全上下文。

另请参见:
常量字段值

NO_CRED

public static final int NO_CRED
无效的凭据。

另请参见:
常量字段值

BAD_QOP

public static final int BAD_QOP
不受支持的 QOP 值。

另请参见:
常量字段值

UNAUTHORIZED

public static final int UNAUTHORIZED
未授权的操作。

另请参见:
常量字段值

UNAVAILABLE

public static final int UNAVAILABLE
不可用的操作。

另请参见:
常量字段值

DUPLICATE_ELEMENT

public static final int DUPLICATE_ELEMENT
请求了重复的凭据元素。

另请参见:
常量字段值

NAME_NOT_MN

public static final int NAME_NOT_MN
包含多机制元素的名称。

另请参见:
常量字段值

DUPLICATE_TOKEN

public static final int DUPLICATE_TOKEN
该标记是前面标记的一个副本。这是在上下文创建期间出现的一个致命性错误代码。它并不用于表示增补状态值。而是使用 MessageProp 对象来表示该值。

另请参见:
常量字段值

OLD_TOKEN

public static final int OLD_TOKEN
该标记已无效。这是在上下文创建期间出现的一个致命性错误代码。它并不用于表示增补状态值。而是使用 MessageProp 对象来表示该值。

另请参见:
常量字段值

UNSEQ_TOKEN

public static final int UNSEQ_TOKEN
后面的标记已处理过。这是在上下文创建期间出现的一个致命性错误代码。它并不用于表示增补状态值。而是使用 MessageProp 对象来表示该值。

另请参见:
常量字段值

GAP_TOKEN

public static final int GAP_TOKEN
未收到需要的 per-message 标记。这是在上下文创建期间出现的一个致命性错误代码。它并不用于表示增补状态值。而是使用 MessageProp 对象来表示该值。

另请参见:
常量字段值
构造方法详细信息

GSSException

public GSSException(int majorCode)
使用指定的主要代码创建一个 GSSException 对象。

参数:
majorCode - 导致抛出此异常的问题的 GSS 错误代码。

GSSException

public GSSException(int majorCode,
                    int minorCode,
                    String minorString)
使用指定的主要代码、次要代码和次要代码文本性解释,创建一个 GSSException 对象。此构造方法将在异常产生自基础机制级时使用。它允许设置 GSS 代码和机制代码。

参数:
majorCode - 导致抛出此异常的问题的 GSS 错误代码。
minorCode - 导致抛出此异常的问题的机制级错误代码。
minorString - 机制错误代码的文本解释。
方法详细信息

getMajor

public int getMajor()
返回导致抛出此异常的问题的 GSS-API 级主要错误代码。主要错误代码将在此类中独立于机制的 GSS-API 级定义。可以提供更多信息的特定于机制的错误代码将被设置为次要的错误代码。

返回:
int 导致异常的 GSS-API 级错误代码
另请参见:
getMajorString(), getMinor(), getMinorString()

getMinor

public int getMinor()
返回导致抛出此异常的问题的机制级错误代码。次要代码通过基础机制设置。

返回:
int 机制错误代码;0 表示尚未设置该错误代码。
另请参见:
getMinorString(), setMinor(int, java.lang.String)

getMajorString

public String getMajorString()
返回一个字符串,解释在此异常中 GSS-API 级的主要错误代码。

返回:
字符串,主要错误代码的解释字符串
另请参见:
getMajor(), toString()

getMinorString

public String getMinorString()
返回解释特定于机制的错误代码的字符串。如果次要状态码为 0,则不会提供机制级的错误详细信息。

返回:
字符串,机制错误代码的文本解释
另请参见:
getMinor(), getMajorString(), toString()

setMinor

public void setMinor(int minorCode,
                     String message)
由异常抛出器使用,以设置机制级的次要错误代码及其字符串解释。机制提供程序使用它来表示错误详细信息。

参数:
minorCode - 特定于机制的错误代码
message - 机制错误代码的文本解释
另请参见:
getMinor()

toString

public String toString()
返回主要和次要状态码的文本表示形式。

覆盖:
Throwable 中的 toString
返回:
一个带有错误描述的字符串

getMessage

public String getMessage()
返回主要和次要状态码的文本表示形式。

覆盖:
Throwable 中的 getMessage
返回:
一个带有错误描述的字符串

JavaTM 2 Platform
Standard Ed. 5.0

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

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