[jboss-cvs] JBossAS SVN: r98515 - projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Dec 22 12:25:10 EST 2009
Author: jaikiran
Date: 2009-12-22 12:25:10 -0500 (Tue, 22 Dec 2009)
New Revision: 98515
Removed:
projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el/ValueExpression.java
Log:
Autoversioning commit: a non-deltaV client made a change to
/projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el/ValueExpression.java
Deleted: projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el/ValueExpression.java
===================================================================
--- projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el/ValueExpression.java 2009-12-22 17:25:03 UTC (rev 98514)
+++ projects/javaee/tags/jboss-javaee-parent-6.0.0-alpha-1/jboss-el-api/src/main/javax/el/ValueExpression.java 2009-12-22 17:25:10 UTC (rev 98515)
@@ -1,223 +0,0 @@
-/*
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
- *
- * Copyright 1997-2008 Sun Microsystems, Inc. All rights reserved.
- *
- * The contents of this file are subject to the terms of either the GNU
- * General Public License Version 2 only ("GPL") or the Common Development
- * and Distribution License("CDDL") (collectively, the "License"). You
- * may not use this file except in compliance with the License. You can obtain
- * a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
- * or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific
- * language governing permissions and limitations under the License.
- *
- * When distributing the software, include this License Header Notice in each
- * file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
- * Sun designates this particular file as subject to the "Classpath" exception
- * as provided by Sun in the GPL Version 2 section of the License file that
- * accompanied this code. If applicable, add the following below the License
- * Header, with the fields enclosed by brackets [] replaced by your own
- * identifying information: "Portions Copyrighted [year]
- * [name of copyright owner]"
- *
- * Contributor(s):
- *
- * If you wish your version of this file to be governed by only the CDDL or
- * only the GPL Version 2, indicate your decision by adding "[Contributor]
- * elects to include this software in this distribution under the [CDDL or GPL
- * Version 2] license." If you don't indicate a single choice of license, a
- * recipient has the option to distribute your version of this file under
- * either the CDDL, the GPL Version 2 or to extend the choice of license to
- * its licensees as provided above. However, if you add GPL Version 2 code
- * and therefore, elected the GPL Version 2 license, then the option applies
- * only if the new code is made subject to such option by the copyright
- * holder.
- *
- *
- * This file incorporates work covered by the following copyright and
- * permission notice:
- *
- * Copyright 2004 The Apache Software Foundation
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-
-package javax.el;
-
-/**
- * An <code>Expression</code> that can get or set a value.
- *
- * <p>In previous incarnations of this API, expressions could only be
- * read. <code>ValueExpression</code> objects can now be used both to
- * retrieve a value and to set a value. Expressions that can have a value
- * set on them are referred to as l-value expressions. Those that
- * cannot are referred to as r-value expressions. Not all r-value expressions
- * can be used as l-value expressions (e.g. <code>"${1+1}"</code> or
- * <code>"${firstName} ${lastName}"</code>). See the EL Specification for
- * details. Expressions that cannot be used as l-values must always
- * return <code>true</code> from <code>isReadOnly()</code>.</p>
- *
- * <p>The <code>{@link ExpressionFactory#createValueExpression}</code> method
- * can be used to parse an expression string and return a concrete instance
- * of <code>ValueExpression</code> that encapsulates the parsed expression.
- * The {@link FunctionMapper} is used at parse time, not evaluation time,
- * so one is not needed to evaluate an expression using this class.
- * However, the {@link ELContext} is needed at evaluation time.</p>
- *
- * <p>The {@link #getValue}, {@link #setValue}, {@link #isReadOnly},
- * {@link #getType} and {@link #getValueReference}
- * methods will evaluate the expression each time they are
- * called. The {@link ELResolver} in the <code>ELContext</code> is used to
- * resolve the top-level variables and to determine the behavior of the
- * <code>.</code> and <code>[]</code> operators. For any of the five methods,
- * the {@link ELResolver#getValue} method is used to resolve all properties
- * up to but excluding the last one. This provides the <code>base</code>
- * object. For all methods other than the {@link #getValueReference} method,
- * at the last resolution, the <code>ValueExpression</code> will
- * call the corresponding {@link ELResolver#getValue},
- * {@link ELResolver#setValue}, {@link ELResolver#isReadOnly} or
- * {@link ELResolver#getType} method, depending on which was called on
- * the <code>ValueExpression</code>.
- * For the {@link getValueReference} method, the (base, property) is
- * not resolved by the ELResolver, but an instance of {@link ValueReference}
- * is created to encapsulate this (base ,property), and returned.
- * </p>
- *
- * <p>See the notes about comparison, serialization and immutability in
- * the {@link Expression} javadocs.
- *
- * @see ELResolver
- * @see Expression
- * @see ExpressionFactory
- * @since JSP 2.1
- */
-public abstract class ValueExpression
- extends Expression
-{
-
- /**
- * Evaluates the expression relative to the provided context, and
- * returns the resulting value.
- *
- * <p>The resulting value is automatically coerced to the type
- * returned by <code>getExpectedType()</code>, which was
- * provided to the <code>ExpressionFactory</code> when this
- * expression was created.</p>
- *
- * @param context The context of this evaluation.
- * @return The result of the expression evaluation.
- * @throws NullPointerException if context is <code>null</code>.
- * @throws PropertyNotFoundException if one of the property
- * resolutions failed because a specified variable or property
- * does not exist or is not readable.
- * @throws ELException if an exception was thrown while performing
- * property or variable resolution. The thrown exception
- * must be included as the cause property of this exception, if
- * available.
- */
- public abstract Object getValue(ELContext context);
-
- /**
- * Evaluates the expression relative to the provided context, and
- * sets the result to the provided value.
- *
- * @param context The context of this evaluation.
- * @param value The new value to be set.
- * @throws NullPointerException if context is <code>null</code>.
- * @throws PropertyNotFoundException if one of the property
- * resolutions failed because a specified variable or property
- * does not exist or is not readable.
- * @throws PropertyNotWritableException if the final variable or
- * property resolution failed because the specified
- * variable or property is not writable.
- * @throws ELException if an exception was thrown while attempting to
- * set the property or variable. The thrown exception
- * must be included as the cause property of this exception, if
- * available.
- */
- public abstract void setValue(ELContext context, Object value);
-
- /**
- * Evaluates the expression relative to the provided context, and
- * returns <code>true</code> if a call to {@link #setValue} will
- * always fail.
- *
- * @param context The context of this evaluation.
- * @return <code>true</code> if the expression is read-only or
- * <code>false</code> if not.
- * @throws NullPointerException if context is <code>null</code>.
- * @throws PropertyNotFoundException if one of the property
- * resolutions failed because a specified variable or property
- * does not exist or is not readable.
- * @throws ELException if an exception was thrown while performing
- * property or variable resolution. The thrown exception
- * must be included as the cause property of this exception, if
- * available.
- * * @throws NullPointerException if context is <code>null</code>
- */
- public abstract boolean isReadOnly(ELContext context);
-
- /**
- * Evaluates the expression relative to the provided context, and
- * returns the most general type that is acceptable for an object to be
- * passed as the <code>value</code> parameter in a future call
- * to the {@link #setValue} method.
- *
- * <p>This is not always the same as <code>getValue().getClass()</code>.
- * For example, in the case of an expression that references an
- * array element, the <code>getType</code> method will return the
- * element type of the array, which might be a superclass of the type
- * of the actual element that is currently in the specified
- * array element.</p>
- *
- * @param context The context of this evaluation.
- * @return the most general acceptable type; otherwise undefined.
- * @throws NullPointerException if context is <code>null</code>.
- * @throws PropertyNotFoundException if one of the property
- * resolutions failed because a specified variable or property
- * does not exist or is not readable.
- * @throws ELException if an exception was thrown while performing
- * property or variable resolution. The thrown exception
- * must be included as the cause property of this exception, if
- * available.
- */
- public abstract Class<?> getType(ELContext context);
-
- /**
- * Returns the type the result of the expression will be coerced to
- * after evaluation.
- *
- * @return the <code>expectedType</code> passed to the
- * <code>ExpressionFactory.createValueExpression</code> method
- * that created this <code>ValueExpression</code>.
- */
- public abstract Class<?> getExpectedType();
-
- /**
- * Returns a {@link ValueReference} for this expression instance.
- * @param context the context of this evaluation
- * @return the <code>ValueReference</code> for this
- * <code>ValueExpression</code>, or <code>null</code> if this
- * <code>ValueExpression</code> is not a reference to
- * a base (null or non-null) and a property.
- * If the base is null, and the property is a EL variable, return
- * the <code>ValueReference</code> for the
- * <code>ValueExpression</code> associated with this EL variable.
- *
- * @since EL 2.2
- */
- public ValueReference getValueReference(ELContext context) {
- return null;
- }
-}
More information about the jboss-cvs-commits
mailing list