jakarta.faces.el.ValueBinding Maven / Gradle / Ivy
/*
* Copyright (c) 1997, 2020 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 jakarta.faces.el;
import jakarta.faces.context.FacesContext;
/**
*
* ValueBinding is an object that can be used to access the property represented by an action or value
* binding expression. An immutable {@link ValueBinding} for a particular value binding can be acquired by calling the
* createValueBinding() method of the {@link jakarta.faces.application.Application} instance for this web
* application.
*
*
* @deprecated This has been replaced by {@link jakarta.el.ValueExpression}.
*/
@Deprecated
public abstract class ValueBinding {
/**
*
* Return the value of the property represented by this {@link ValueBinding}, relative to the specified
* {@link FacesContext}.
*
*
* @param context {@link FacesContext} for the current request
*
* @throws EvaluationException if an exception is thrown while getting the value (the thrown exception must be included
* as the cause property of this exception)
* @throws NullPointerException if context is null
* @throws PropertyNotFoundException if a specified property name does not exist, or is not readable
*
* @return the value of this expression
*/
public abstract Object getValue(FacesContext context) throws EvaluationException, PropertyNotFoundException;
/**
*
* Set the value of the property represented by this {@link ValueBinding}, relative to the specified
* {@link FacesContext}.
*
*
* @param context {@link FacesContext} for the current request
* @param value The new value to be set
*
* @throws EvaluationException if an exception is thrown while setting the value (the thrown exception must be included
* as the cause property of this exception)
* @throws NullPointerException if context is null
* @throws PropertyNotFoundException if a specified property name does not exist, or is not writeable
*/
public abstract void setValue(FacesContext context, Object value) throws EvaluationException, PropertyNotFoundException;
/**
*
* Return true if the specified property of the specified property is known to be immutable; otherwise,
* return false.
*
*
* @param context {@link FacesContext} for the current request
*
* @throws EvaluationException if an exception is thrown while getting the description of the property (the thrown
* exception must be included as the cause property of this exception)
* @throws NullPointerException if context is null
* @throws PropertyNotFoundException if a specified property name does not exist
*
* @return whether or not this expression is read only
*/
public abstract boolean isReadOnly(FacesContext context) throws EvaluationException, PropertyNotFoundException;
/**
*
* Return the type of the property represented by this {@link ValueBinding}, relative to the specified
* {@link FacesContext}.
*
*
* @param context {@link FacesContext} for the current request
*
* @throws EvaluationException if an exception is thrown while getting the description of the property (the thrown
* exception must be included as the cause property of this exception)
* @throws NullPointerException if context is null
* @throws PropertyNotFoundException if a specified property name does not exist
*
* @return the Java type of this expression
*/
public abstract Class getType(FacesContext context) throws EvaluationException, PropertyNotFoundException;
/**
*
* Return the (possibly null) expression String, including the delimiters, from which this
* ValueBinding was built.
*
*
* @return the expression string
*/
public String getExpressionString() {
return null;
}
}