JavaTM 2 Platform
Standard Ed. 5.0

类 java.lang.RuntimeException
的使用

使用 RuntimeException 的软件包
java.awt 包含用于创建用户界面和绘制图形图像的所有类。 
java.awt.color 提供用于颜色空间的类。 
java.awt.dnd Drag 和 Drop 是一种直接操作操作,在许多图形用户界面系统中都会遇到它,它提供了一种机制,能够在两个与 GUI 中显示元素逻辑相关的实体之间传输信息。 
java.awt.geom 提供用于在与二维几何形状相关的对象上定义和执行操作的 Java 2D 类。 
java.awt.image 提供创建和修改图像的各种类。 
java.lang 提供利用 Java 编程语言进行程序设计的基础类。 
java.lang.annotation 为 Java 编程语言注释设施提供库支持。 
java.lang.reflect 提供类和接口,以获取关于类和对象的反射信息。 
java.nio 定义作为数据容器的缓冲区,并提供其他 NIO 包的概述。 
java.nio.channels 定义了各种通道,这些通道表示到能够执行 I/O 操作的实体(如文件和套接字)的连接;定义了用于多路复用的、非阻塞 I/O 操作的选择器。 
java.nio.charset 定义用来在字节和 Unicode 字符之间转换的 charset、解码器和编码器。 
java.rmi 提供 RMI 包。 
java.security 为安全框架提供类和接口。 
java.util 包含集合框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组)。 
java.util.concurrent 在并发编程中很常用的实用工具类。 
java.util.regex 用于匹配字符序列与正则表达式指定模式的类。 
javax.management 提供 Java Management Extensions 的核心类。 
javax.management.monitor 提供 monitor 类的定义。 
javax.management.openmbean 提供开放数据类型和 Open MBean 描述符类。 
javax.print.attribute 提供了描述 JavaTM Print Service 属性的类型以及如何分类这些属性的类和接口。 
javax.swing.undo 允许开发人员为应用程序(例如文本编辑器)中的撤消/恢复提供支持。 
org.omg.CORBA 提供 OMG CORBA API 到 JavaTM 编程语言的映射,包括 ORB 类,如果已实现该类,则程序员可以使用此类作为全功能对象请求代理(Object Request Broker,ORB)。 
org.omg.CORBA.portable 提供可移植性层,即可以使一个供应商生成的代码运行在另一个供应商 ORB 上的 ORB API 集合。 
org.w3c.dom 为文档对象模型 (DOM) 提供接口,该模型是 Java API for XML Processing 的组件 API。 
org.w3c.dom.events   
org.w3c.dom.ls   
 

java.awtRuntimeException 的使用
 

java.awtRuntimeException 的子类
 class HeadlessException
          在不支持键盘、显示器或鼠标的环境中调用与键盘、显示器或鼠标有关的代码时,被抛出的异常。
 class IllegalComponentStateException
          当 AWT 组件未处于所请求操作的适当状态时,抛出该异常。
 

java.awt.colorRuntimeException 的使用
 

java.awt.colorRuntimeException 的子类
 class CMMException
          如果本机 CMM 返回一个错误,则抛出此异常。
 class ProfileDataException
          当访问或处理 ICC_Profile 对象出现错误时,抛出此异常。
 

java.awt.dndRuntimeException 的使用
 

java.awt.dndRuntimeException 的子类
 class InvalidDnDOperationException
          java.awt.dnd 包中的各种方法都会抛出此异常。
 

java.awt.geomRuntimeException 的使用
 

java.awt.geomRuntimeException 的子类
 class IllegalPathStateException
          对于正在执行的特定操作而言(如将路径段追加到不具有初始 moveto 的 GeneralPath),如果操作在处于非法状态的路径上执行,则抛出 IllegalPathStateException
 

java.awt.imageRuntimeException 的使用
 

java.awt.imageRuntimeException 的子类
 class ImagingOpException
          如果某个 BufferedImageOpRasterOp 过滤器方法无法处理图像,则抛出 ImagingOpException
 class RasterFormatException
          如果 Raster 中存在无效的布局信息,则抛出 RasterFormatException
 

java.langRuntimeException 的使用
 

java.langRuntimeException 的子类
 class ArithmeticException
          当出现异常的运算条件时,抛出此异常。
 class ArrayIndexOutOfBoundsException
          用非法索引访问数组时抛出的异常。
 class ArrayStoreException
          试图将错误类型的对象存储到一个对象数组时抛出的异常。
 class ClassCastException
          当试图将对象强制转换为不是实例的子类时,抛出该异常。
 class EnumConstantNotPresentException
          当应用程序试图通过名称和枚举类型访问那些不包含具有指定名称的常量的枚举常量时,抛出该异常。
 class IllegalArgumentException
          抛出的异常表明向方法传递了一个不合法或不正确的参数。
 class IllegalMonitorStateException
          抛出的异常表明某一线程已经试图等待对象的监视器,或者试图通知其他正在等待对象的监视器而本身没有指定监视器的线程。
 class IllegalStateException
          在非法或不适当的时间调用方法时产生的信号。
 class IllegalThreadStateException
          指示线程没有处于请求操作所要求的适当状态时抛出的异常。
 class IndexOutOfBoundsException
          指示某排序索引(例如对数组、字符串或向量的排序)超出范围时抛出。
 class NegativeArraySizeException
          如果应用程序试图创建大小为负的数组,则抛出该异常。
 class NullPointerException
          当应用程序试图在需要对象的地方使用 null 时,抛出该异常。
 class NumberFormatException
          当应用程序试图将字符串转换成一种数值类型,但该字符串不能转换为适当格式时,抛出该异常。
 class SecurityException
          由安全管理器抛出的异常,指示存在安全侵犯。
 class StringIndexOutOfBoundsException
          此异常由 String 方法抛出,指示索引或者为负,或者超出字符串的大小。
 class TypeNotPresentException
          当应用程序试图使用表示类型名称的字符串对类型进行访问,但无法找到带有指定名称的类型定义时,抛出该异常。
 class UnsupportedOperationException
          当不支持请求的操作时,抛出该异常。
 

java.lang.annotationRuntimeException 的使用
 

java.lang.annotationRuntimeException 的子类
 class AnnotationTypeMismatchException
          若某个注释的类型在对该注释进行编译(或序列化)后发生了更改,而程序试图访问该注释的元素时,抛出此异常。
 class IncompleteAnnotationException
          若某个注释在编译(或序列化)后将某个注释类型添加到其类型定义中,而程序试图该注释类型的元素时,抛出此异常。
 

java.lang.reflectRuntimeException 的使用
 

java.lang.reflectRuntimeException 的子类
 class MalformedParameterizedTypeException
          当反射方法遇到语义错误的参数化类型,而反射方法需要实例化该类型时,抛出该异常。
 class UndeclaredThrowableException
          如果代理实例的调用处理程序的 invoke 方法抛出一个经过检查的异常(不可分配给 RuntimeExceptionErrorThrowable),且该异常不可分配给该方法(在代理实例上调用该方法,并将其指派到调用处理程序)的 throws 子句中声明的任何异常类,则由代理实例上的方法调用抛出此异常。
 

java.nioRuntimeException 的使用
 

java.nioRuntimeException 的子类
 class BufferOverflowException
          当相关 put 操作达到目标缓冲区限制时,抛出此未经检查的异常。
 class BufferUnderflowException
          当相关 get 操作达到源缓冲区限制时,抛出此未经检查的异常。
 class InvalidMarkException
          当试图重置一个尚未定义其标记的缓冲区时,抛出此未检查的异常。
 class ReadOnlyBufferException
          当在只读缓冲区上调用内容可变(content-mutation)的方法(例如 putcompact 方法)时,抛出此未经检查的异常。
 

java.nio.channelsRuntimeException 的使用
 

java.nio.channelsRuntimeException 的子类
 class AlreadyConnectedException
          试图对已经连接的 SocketChannel 进行连接时抛出的未经检查的异常。
 class CancelledKeyException
          当试图使用不再有效的选择键时,抛出此未经检查的异常。
 class ClosedSelectorException
          试图在已关闭的选择器上调用 I/O 操作时抛出的未经检查的异常。
 class ConnectionPendingException
          试图连接一个正在进行非阻塞连接操作的 SocketChannel 时抛出的未经检查的异常。
 class IllegalBlockingModeException
          当以错误的阻塞模式调用特定于某个阻塞模式的操作时,抛出此未经检查的异常。
 class IllegalSelectorException
          试图将一个通道注册到一个不是由创建该通道的提供者所创建的选择器时,抛出此未经检查的异常。
 class NoConnectionPendingException
          在没有首先成功调用 connect 方法的情况下调用 SocketChannelfinishConnect 方法时,抛出此未经检查的异常。
 class NonReadableChannelException
          试图对一个最初未允许对其进行读取操作的通道进行读取时,抛出此未经检查的异常。
 class NonWritableChannelException
          试图对一个最初未允许对其进行写入操作的通道进行写入时,抛出此未经检查的异常。
 class NotYetBoundException
          试图在尚未绑定的服务器套接字通道上调用 I/O 操作时,抛出此未经检查的异常。
 class NotYetConnectedException
          试图在尚未连接的套接字通道上调用 I/O 操作时,抛出此未经检查的异常。
 class OverlappingFileLockException
          试图获取某个文件区域上的锁定,而该区域与同一 Java 虚拟机已锁定的某个区域重叠时,或者当另一个线程已经等待锁定同一文件的重叠区域时,抛出此未经检查的异常。
 class UnresolvedAddressException
          试图对未解析的套接字地址调用网络操作时,抛出此未经检查的异常。
 class UnsupportedAddressTypeException
          试图绑定或连接到一个其类型不受支持的套接字地址时,抛出此未经检查的异常。
 

java.nio.charsetRuntimeException 的使用
 

java.nio.charsetRuntimeException 的子类
 class IllegalCharsetNameException
          将一个不是合法 charset 名称的字符串用作 charset 名称时,抛出此未经检查的异常。
 class UnsupportedCharsetException
          当不支持请求的 charset 时,抛出此未经检查的异常。
 

java.rmiRuntimeException 的使用
 

java.rmiRuntimeException 的子类
 class RMISecurityException
          已过时。 SecurityException 取代。应用程序代码从来不应直接引用此类,且 RMISecurityManager 不再抛出 java.lang.SecurityException 的这个子类。
 

java.securityRuntimeException 的使用
 

java.securityRuntimeException 的子类
 class AccessControlException
           此异常由 AccessController 抛出,提示请求的访问(对关键系统资源(如文件系统或网络)的访问)被拒绝。
 class InvalidParameterException
          当将无效参数传递给某个方法时抛出此异常,设计该异常供 JCA/JCE 引擎类使用。
 class ProviderException
          用于 Provider 异常(例如误配置错误或不可恢复的内部错误)的运行时异常,Provider 可以为它创建子类以抛出特殊的、特定于 provider 的运行时错误。
 

java.utilRuntimeException 的使用
 

java.utilRuntimeException 的子类
 class ConcurrentModificationException
          当方法检测到对象的并发修改,但不允许这种修改时,抛出此异常。
 class DuplicateFormatFlagsException
          格式说明符中提供重复标志时抛出的未经检查的异常。
 class EmptyStackException
          该异常由 Stack 类中的方法抛出,以表明堆栈为空。
 class FormatFlagsConversionMismatchException
          转换与标志不兼容时抛出未经检查的异常。
 class FormatterClosedException
          格式化程序已关闭时抛出的未经检查的异常。
 class IllegalFormatCodePointException
          将具有 Character.isValidCodePoint(int) 所定义的无效 Unicode 代码点的字符传递给 Formatter 时,抛出未经检查的异常。
 class IllegalFormatConversionException
          当对应于格式说明符的参数为不兼容的类型时,抛出未经检查的异常。
 class IllegalFormatException
          当格式字符串包含非法语法,或者包含与给定参数不兼容的格式说明符时,将抛出未经检查的异常。
 class IllegalFormatFlagsException
          当给出非法组合标志时,抛出未经检查的异常。
 class IllegalFormatPrecisionException
          当精度为除 -1 以外的负值、转换类型不支持某个精度或者值在其他方面不受支持时,将抛出未经检查的异常。
 class IllegalFormatWidthException
          当格式宽度为除 -1 以外的负值或其他不受支持的值时,将抛出未经检查的异常。
 class InputMismatchException
          由 Scanner 抛出,表明用于检索的标记与期望类型的模式不匹配,或者该标记处在期望类型的范围之外。
 class MissingFormatArgumentException
          如果格式说明符没有相应的参数,或者参数索引引用了不存在的参数时,则抛出未经检查的异常。
 class MissingFormatWidthException
          请求格式宽度时抛出未经检查的异常。
 class MissingResourceException
          缺少资源时抛出此异常。
 class NoSuchElementException
          由 EnumerationnextElement 方法抛出,表明枚举中没有更多的元素。
 class UnknownFormatConversionException
          给定未知的转换时所抛出的未经检查的异常。
 class UnknownFormatFlagsException
          给定未知标志时所抛出的未经检查的异常。
 

java.util.concurrentRuntimeException 的使用
 

java.util.concurrentRuntimeException 的子类
 class CancellationException
          如果某项值生成任务(如 FutureTask)的结果因为任务被取消而无法检索到,则抛出该异常。
 class RejectedExecutionException
          当无法执行某个任务时,由 Executor 抛出的异常。
 

java.util.regexRuntimeException 的使用
 

java.util.regexRuntimeException 的子类
 class PatternSyntaxException
          抛出未经检查的异常,表明正则表达式模式中的语法错误。
 

javax.managementRuntimeException 的使用
 

javax.managementRuntimeException 的子类
 class JMRuntimeException
          由 JMX 实现所发出的运行时异常。
 class RuntimeErrorException
          当代理中发生 java.lang.Error 时,必须捕获它并作为 RuntimeErrorException 重新抛出。
 class RuntimeMBeanException
          表示由代理中的 MBean 方法抛出的运行时异常。
 class RuntimeOperationsException
          表示在 MBean 上执行操作时代理中抛出的运行时异常。
 

返回 RuntimeExceptionjavax.management 中的方法
 RuntimeException RuntimeOperationsException.getTargetException()
          返回抛出的实际 RuntimeException
 RuntimeException RuntimeMBeanException.getTargetException()
          返回抛出的实际 RuntimeException
 

参数类型为 RuntimeExceptionjavax.management 中的构造方法
RuntimeMBeanException(RuntimeException e)
          创建包装实际 java.lang.RuntimeExceptionRuntimeMBeanException
RuntimeMBeanException(RuntimeException e, String message)
          创建带有详细信息的实际 java.lang.RuntimeExceptionRuntimeMBeanException
RuntimeOperationsException(RuntimeException e)
          创建包装实际 java.lang.RuntimeExceptionRuntimeOperationsException
RuntimeOperationsException(RuntimeException e, String message)
          创建包装带有详细信息的实际 java.lang.RuntimeExceptionRuntimeOperationsException
 

javax.management.monitorRuntimeException 的使用
 

javax.management.monitorRuntimeException 的子类
 class MonitorSettingException
          当监视器设置在运行监视器期间变得无效时由该监视器抛出的异常。
 

javax.management.openmbeanRuntimeException 的使用
 

javax.management.openmbeanRuntimeException 的子类
 class InvalidKeyException
          当方法参数作为复合数据 的项名称或表格数据 的行索引时,如果其无效,则抛出此运行时异常。
 class InvalidOpenTypeException
          当开放数据 值的开放类型 不是期望的类型时,抛出此运行时异常。
 class KeyAlreadyExistsException
          当添加到表格数据 实例的行索引已用于引用此表格数据 实例中的另一行时,抛出此运行时异常。
 

javax.print.attributeRuntimeException 的使用
 

javax.print.attributeRuntimeException 的子类
 class UnmodifiableSetException
          当由于设置不可修改而无法执行请求的操作时,抛出该异常。
 

javax.swing.undoRuntimeException 的使用
 

javax.swing.undoRuntimeException 的子类
 class CannotRedoException
          当 UndoableEdit 被通知 redo() 但无法执行时抛出。
 class CannotUndoException
          当 UndoableEdit 被通知 undo() 但无法执行时抛出。
 

org.omg.CORBARuntimeException 的使用
 

org.omg.CORBARuntimeException 的子类
 class ACTIVITY_COMPLETED
          ACTIVITY_COMPLETED 系统异常可以在任何访问 Activity 上下文的方法上引发。
 class ACTIVITY_REQUIRED
          ACTIVITY_REQUIRED 系统异常可以在任何需要 Activity 上下文的方法上引发。
 class BAD_CONTEXT
          当客户端调用某一操作,但传递的上下文中不包含该操作所需的上下文值时,抛出该异常。
 class BAD_INV_ORDER
          此异常指示调用方按错误顺序调用了操作。
 class BAD_OPERATION
          当对象引用表示某一现有对象,但该对象并不支持调用的操作时,抛出该异常。
 class BAD_PARAM
          当传递给某一调用的参数超出范围或被认为不合法时,抛出该异常。
 class BAD_QOS
          只要对象无法支持调用参数(具有与之关联的服务质量语义的参数)所需的服务质量,就会引发 BAD_QOS 异常。
 class BAD_TYPECODE
          当 ORB 遇到错误的类型代码(例如,具有无效 TCKind 值的类型代码)时,抛出该异常。
 class CODESET_INCOMPATIBLE
          当客户端和服务器本机代码集之间不能进行有意义的通信时,抛出此异常。
 class COMM_FAILURE
          如果某一操作正在进行时失去通信,此时客户端已经发送了请求,但服务器的应答尚未返回到客户端,则引发此异常。
 class DATA_CONVERSION
          如果 ORB 无法将已编组数据的表示形式转换成其本机表示形式,则引发此异常,反之亦然。
 class FREE_MEM
          当 ORB 试图释放动态内存但却因为某些原因(例如因为堆损坏或内存块被锁定)而失败时,抛出此异常。
 class IMP_LIMIT
          此异常指示在 OBR 运行时超过了某一项实现限制。
 class INITIALIZE
          ORB 在其初始化期间出错(例如无法获得网络资源或检测配置错误)时,抛出此异常。
 class INTERNAL
          此异常指示 ORB 中存在内部错误,例如,在 ORB 检测到其内部数据结构被损坏时将抛出此异常。
 class INTF_REPOS
          当 ORB 无法到达接口存储库,或者检测到其他与接口存储库相关的错误时,引发此异常。
 class INV_FLAG
          在将无效标志传递给某项操作时(例如,在创建 DII 请求时),抛出此异常。
 class INV_IDENT
          此异常指示 IDL 标识符在语法上是无效的。
 class INV_OBJREF
          此异常指示对象引用存在内部错误。
 class INV_POLICY
          当应用于特定调用的 Policy 重写之间不兼容而导致无法进行调用时,抛出此标准异常。
 class INVALID_ACTIVITY
          如果在不同于其处于挂起状态时所在的上下文中恢复事务或 Activity,则在该 Activity 或 Transaction 服务的恢复方法上引发 INVALID_ACTIVITY 系统异常。
 class INVALID_TRANSACTION
          当请求带有无效的事务上下文时,抛出此异常。
 class MARSHAL
          表示网络中传来的请求或应答在结构上无效。
 class NO_IMPLEMENT
          此异常指示,尽管被调用的操作存在(它有一个 IDL 定义),但不存在该操作的实现。
 class NO_MEMORY
          如果 ORB 运行时出现内存不足,则抛出此异常。
 class NO_PERMISSION
          当因为调用方没有足够的权限而导致调用失败时,抛出此异常。
 class NO_RESOURCES
          当 ORB 遇到一些一般资源限制时,抛出此异常。
 class NO_RESPONSE
          如果某客户端试图检索延迟同步调用的结果,但请求的响应尚不可用,则抛出此异常。
 class OBJ_ADAPTER
          此异常通常指示管理方面的不匹配,例如,某台服务器可能试图在实现存储库中使用已经在使用或存储库未知的名称注册它自身。
 class OBJECT_NOT_EXIST
          只要在已删除的对象上执行调用,就会引发此异常。
 class PERSIST_STORE
          此异常指示一个持久存储错误,例如,无法建立数据库连接或者某个数据库损坏。
 class REBIND
          如果当前有效 RebindPolicy 具有 NO_REBIND 或 NO_RECONNECT 值,且对绑定的对象引用执行调用时生成状态为 OBJECT_FORWARD 的 LocateReply 消息或状态为 LOCATION_FORWARD 的 Reply 消息,则将引发 REBIND
 class SystemException
          所有 CORBA 标准异常的根类。
 class TIMEOUT
          当已超过指定生存时间却没有做出任何交付时,引发 TIMEOUT 异常。
 class TRANSACTION_MODE
          如果客户端 ORB 检测到 IOR 中的 InvocationPolicy 与选中的调用路径(即直接或路由调用)不匹配,则它将抛出 CORBA TRANSACTION_MODE 异常。
 class TRANSACTION_REQUIRED
          此异常指示请求带有一个 null 事务上下文,但需要的是激活的事务。
 class TRANSACTION_ROLLEDBACK
          当与请求处理关联的事务已回滚或已标记为回滚时,抛出此异常。
 class TRANSACTION_UNAVAILABLE
          当由于到事务服务 (Transaction Service) 的连接已异常终止而无法处理事务服务上下文时,由 ORB 抛出 CORBA TRANSACTION_UNAVAILABLE 异常。
 class TRANSIENT
          当 ORB 试图到达某一对象但失败时,抛出此异常。
 class UNKNOWN
          如果操作实现抛出一个非 CORBA 异常(比如特定于该实现编程语言的异常),或者某一操作引发没有出现在该操作引发表达式中的用户异常,则将引发此异常。
 

org.omg.CORBA.portableRuntimeException 的使用
 

org.omg.CORBA.portableRuntimeException 的子类
 class IndirectionException
          Indirection 异常是一个特定于 Java 的系统异常。
 class UnknownException
          org.omg.CORBA.portable.UnknownException 用来报告 tie 和 ORB 以及 ORB 和 stub 之间的未知异常。
 

org.w3c.domRuntimeException 的使用
 

org.w3c.domRuntimeException 的子类
 class DOMException
          DOM 操作只在 "exceptional" 情况下引发异常,即不能执行操作时(由于逻辑原因,因为丢失数据或因为实现变得不稳定)。
 

org.w3c.dom.eventsRuntimeException 的使用
 

org.w3c.dom.eventsRuntimeException 的子类
 class EventException
          事件操作可以像在其方法描述中指定的那样抛出 EventException
 

org.w3c.dom.lsRuntimeException 的使用
 

org.w3c.dom.lsRuntimeException 的子类
 class LSException
          如果处理停止,解析或写操作可以抛出 LSException
 


JavaTM 2 Platform
Standard Ed. 5.0

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

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