Module javafx.web

软件包 javafx.scene.web

Class WebErrorEvent

java.lang.Object

java.util.EventObject

javafx.event.Event

javafx.scene.web.WebErrorEvent

All Implemented Interfaces:

Serializable ， Cloneable

public final class WebErrorEvent
extends Event

一个事件指示WebEngine错误。 保留可选的文本消息和与错误相关联的可选异常。

从以下版本开始：

JavaFX 8.0

另请参见：

WebEngine.onError ， Serialized Form

Field Summary

Fields

Modifier and Type	Field	描述
static EventType<WebErrorEvent>	ANY	所有 WebErrorEvent类型的常用超类型。
static EventType<WebErrorEvent>	USER_DATA_DIRECTORY_ALREADY_IN_USE	当WebEngine检测到其用户数据目录已在不同VM中运行的WebEngine已在使用时，会发生此事件。
static EventType<WebErrorEvent>	USER_DATA_DIRECTORY_IO_ERROR	当WebEngine在尝试创建或访问用户数据目录时遇到I / O错误时，会发生此事件。
static EventType<WebErrorEvent>	USER_DATA_DIRECTORY_SECURITY_ERROR	当WebEngine在尝试创建或访问用户数据目录时遇到安全错误时，会发生此事件。

Fields inherited from class javafx.event.Event

consumed, eventType, NULL_SOURCE_TARGET, target

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor	描述
WebErrorEvent(Object source, EventType<WebErrorEvent> type, String message, Throwable exception)	创建一个新的 WebErrorEvent 。

方法摘要

Modifier and Type	方法	描述
Throwable	getException()	返回与此事件关联的异常。
String	getMessage()	返回与此事件关联的文本消息。
String	toString()	返回此EventObject的String表示形式。

Methods inherited from class javafx.event.Event

clone, consume, copyFor, fireEvent, getEventType, getTarget, isConsumed

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

字段详细信息

ANY

public static final EventType<WebErrorEvent> ANY

所有 WebErrorEvent类型的公共超类型。

USER_DATA_DIRECTORY_ALREADY_IN_USE

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_ALREADY_IN_USE

当WebEngine检测到其用户数据目录WebEngine在不同VM中运行的WebEngine已在使用时，会发生此事件。

通常，多个WebEngine实例可以共享单个用户数据目录，只要它们在同一VM中运行。 WebEngine在不同虚拟机中运行的实例WebEngine共享相同的用户数据目录。

当WebEngine第一次即将开始加载网页或执行脚本时，它会检查其userDataDirectory是否已在不同VM中运行的WebEngine使用。 如果是后者，那么WebEngine调用WebEngine.onError事件处理程序（如果有的话），其中包含一个USER_DATA_DIRECTORY_ALREADY_IN_USE事件。 如果调用的事件处理程序修改了userDataDirectory属性，则WebEngine将在处理程序返回时立即重试新的用户数据目录。 如果处理程序不修改userDataDirectory属性（这是默认值），则WebEngine不会继续使用用户数据目录。

USER_DATA_DIRECTORY_IO_ERROR

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_IO_ERROR

当WebEngine尝试创建或访问用户数据目录时遇到I / O错误时，会发生此事件。

当WebEngine第一次即将开始加载网页或执行脚本时，它会检查是否可以创建或访问其userDataDirectory 。 如果检查失败并出现I / O错误（例如java.io.IOException ），则WebEngine调用WebEngine.onError事件处理程序（如果有），并发生USER_DATA_DIRECTORY_IO_ERROR事件。 如果调用的事件处理程序修改了userDataDirectory属性，那么WebEngine在处理程序返回时立即重试新的用户数据目录。 如果处理程序不修改userDataDirectory属性（这是默认值），则WebEngine将WebEngine继续使用用户数据目录。

USER_DATA_DIRECTORY_SECURITY_ERROR

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_SECURITY_ERROR

当WebEngine在尝试创建或访问用户数据目录时遇到安全错误时，会发生此事件。

当WebEngine第一次即将开始加载网页或执行脚本时，它会检查是否可以创建或访问其userDataDirectory 。 如果检查失败并出现安全错误（如java.lang.SecurityException ），则WebEngine调用WebEngine.onError事件处理程序（如果有的话），并发生USER_DATA_DIRECTORY_SECURITY_ERROR事件。 如果调用的事件处理程序修改了userDataDirectory属性，则WebEngine在处理程序返回时立即重试新的用户数据目录。 如果处理程序不修改userDataDirectory属性（这是默认值），则WebEngine不会继续使用用户数据目录。

构造方法详细信息

WebErrorEvent

public WebErrorEvent(Object source,
                     EventType<WebErrorEvent> type,
                     String message,
                     Throwable exception)

创建一个新的 WebErrorEvent 。

参数

source - 发送事件的事件源

type - 事件类型

message - 与事件相关联的文本消息; 可能是null

exception - 与事件相关的异常; 可能是null

方法详细信息

getMessage

public String getMessage()

返回与此事件关联的文本消息。

结果

与此事件相关联的文本消息，如果没有此类消息， null

getException

public Throwable getException()

返回与此事件关联的异常。

结果

与此事件相关的异常，如果没有此类异常， null

toString

public String toString()

返回此EventObject的String表示形式。

重写：

toString在 EventObject

结果

这个EventObject的一个String表示形式。