javax.faces.event.ValueChangeEvent Maven / Gradle / Ivy
Show all versions of jboss-jsf-api_2.3_spec Show documentation
/*
* Copyright (c) 1997, 2018 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package javax.faces.event;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
/**
* A {@link 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.
*/
public class ValueChangeEvent extends FacesEvent {
private static final long serialVersionUID = 2455861757565618446L;
/**
* Construct a new event object from the
* specified source component, old value, and new value.
*
* The default {@link PhaseId} for this event is {@link
* PhaseId#ANY_PHASE}.
*
* @param component Source {@link UIComponent} for this event
* @param oldValue The previous local value of this {@link UIComponent}
* @param newValue The new local value of thie {@link UIComponent}
* @throws IllegalArgumentException if component is
* null
*/
public ValueChangeEvent(UIComponent component,
Object oldValue, Object newValue) {
super(component);
this.oldValue = oldValue;
this.newValue = newValue;
}
/**
* Construct a new event object from the
* Faces context, specified source component, old value and new value.
*
* The default {@link PhaseId} for this event is {@link
* PhaseId#ANY_PHASE}.
*
* @param facesContext the Faces context.
* @param component Source {@link UIComponent} for this event
* @param oldValue The previous local value of this {@link UIComponent}
* @param newValue The new local value of thie {@link UIComponent}
* @throws IllegalArgumentException if component is
* null
*/
public ValueChangeEvent(FacesContext facesContext, UIComponent component,
Object oldValue, Object newValue) {
super(facesContext, component);
this.oldValue = oldValue;
this.newValue = newValue;
}
// -------------------------------------------------------------- Properties
/**
* The previous local value of the source {@link UIComponent}.
*/
private Object oldValue = null;
/**
* Return the previous local value of the source {@link UIComponent}.
*
*
* @return the previous local value
*/
public Object getOldValue() {
return (this.oldValue);
}
/**
* The current local value of the source {@link UIComponent}.
*/
private Object newValue = null;
/**
* Return the current local value of the source {@link UIComponent}.
*
*
* @return the current local value
*/
public Object getNewValue() {
return (this.newValue);
}
// ------------------------------------------------- Event Broadcast Methods
@Override
public boolean isAppropriateListener(FacesListener listener) {
return (listener instanceof ValueChangeListener);
}
/**
* @throws AbortProcessingException {@inheritDoc}
*/
@Override
public void processListener(FacesListener listener) {
((ValueChangeListener) listener).processValueChange(this);
}
}