ValueChangeEvent (Java EE 5)

Java EE API

previous page next page
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

javax.faces.event Class ValueChangeEvent

java.lang.Object
  extended by java.util.EventObject
      extended by javax.faces.event.FacesEvent
          extended by javax.faces.event.ValueChangeEvent
All Implemented Interfaces:
Serializable
public class ValueChangeEvent
extends FacesEvent

Extends: java.util.EventObject > FacesEvent

ValueChangeEvent 通知由于用户界面活动，源组件的本地值发生了更改。只有成功完成了新值的验证，才会激发该通知。

英文文档：

A ValueChangeEvent is a notification that the local value of the source component has been change as a result of user interface activity. It is not fired unless validation of the new value was completed successfully.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
ValueChangeEvent(UIComponent component, Object oldValue, Object newValue)
          Construct a new event object from the specified source component, old value, and new value.
 
Method Summary
 Object getNewValue()
          Return the current local value of the source UIComponent.
 Object getOldValue()
          Return the previous local value of the source UIComponent.
 boolean isAppropriateListener(FacesListener listener)
          Return true if this FacesListener is an instance of a listener class that this event supports.
 void processListener(FacesListener listener)
          Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate.
 
Methods inherited from class javax.faces.event.FacesEvent
getComponent, getPhaseId, queue, setPhaseId
 
Methods inherited from class java.util.EventObject
getSource, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

public ValueChangeEvent(UIComponent component, Object oldValue, Object newValue)

根据指定的源组件、旧值和新值构造一个新的事件对象。

此事件的默认 PhaseId 为 PhaseId#ANY_PHASE。

component 此事件的源 UIComponent
oldValue 此 UIComponent 以前的本地值
newValue 此 UIComponent 的新本地值
ThrowsIllegalArgumentException: 如果 component 为 null
英文文档：

ValueChangeEvent

public ValueChangeEvent(UIComponent component,
                        Object oldValue,
                        Object newValue)

Construct a new event object from the specified source component, old value, and new value.

The default PhaseId for this event is PhaseId.ANY_PHASE.

Parameters:
component - Source UIComponent for this event
oldValue - The previous local value of this UIComponent
newValue - The new local value of thie UIComponent
Throws:
IllegalArgumentException - if component is null

Method Detail

public Object getOldValue()

返回源 UIComponent 以前的本地值。

英文文档：

getOldValue

public Object getOldValue()

Return the previous local value of the source UIComponent.

public Object getNewValue()

返回源 UIComponent 的当前本地值。

英文文档：

getNewValue

public Object getNewValue()

Return the current local value of the source UIComponent.

public boolean isAppropriateListener(FacesListener listener)
英文文档：

isAppropriateListener

public boolean isAppropriateListener(FacesListener listener)
Description copied from class: FacesEvent

Return true if this FacesListener is an instance of a listener class that this event supports. Typically, this will be accomplished by an "instanceof" check on the listener class.

Specified by:
isAppropriateListener in class FacesEvent
Parameters:
listener - FacesListener to evaluate

public void processListener(FacesListener listener)
ThrowsAbortProcessingException: NullPointerException 通知 JavaServer Face 实现不应该继续处理当前事件
英文文档：

processListener

public void processListener(FacesListener listener)
Description copied from class: FacesEvent

Broadcast this FacesEvent to the specified FacesListener, by whatever mechanism is appropriate. Typically, this will be accomplished by calling an event processing method, and passing this FacesEvent as a paramter.

Specified by:
processListener in class FacesEvent
Parameters:
listener - FacesListener to send this FacesEvent to
Throws:
AbortProcessingException - Signal the JavaServer Faces implementation that no further processing on the current event should be performed
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD
Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正；若因此而造成任何损失请直接找人民主席，请勿与本人联系。谢谢！

previous page start next page