Polish SpEL internals

This commit is contained in:
Sam Brannen 2024-11-08 17:26:54 +01:00 committed by Brian Clozel
parent caec8f4f36
commit e3ba957431
5 changed files with 135 additions and 172 deletions

View File

@ -25,13 +25,13 @@ import org.springframework.lang.Nullable;
import org.springframework.util.ObjectUtils;
/**
* Utility methods for use in the AST classes.
* Utility methods for use with property and index accessors.
*
* @author Andy Clement
* @author Sam Brannen
* @since 3.0.2
*/
abstract class AstUtils {
abstract class AccessorUtils {
/**
* Determine the set of accessors that should be used to try to access an

View File

@ -253,7 +253,7 @@ public class Indexer extends SpelNodeImpl {
// Check for a custom IndexAccessor.
EvaluationContext evalContext = state.getEvaluationContext();
List<IndexAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(target, evalContext.getIndexAccessors());
AccessorUtils.getAccessorsToTry(target, evalContext.getIndexAccessors());
if (accessMode.supportsReads) {
try {
for (IndexAccessor indexAccessor : accessorsToTry) {
@ -754,7 +754,7 @@ public class Indexer extends SpelNodeImpl {
Indexer.this.cachedPropertyReadState = null;
}
List<PropertyAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(targetType, this.evaluationContext.getPropertyAccessors());
AccessorUtils.getAccessorsToTry(targetType, this.evaluationContext.getPropertyAccessors());
for (PropertyAccessor accessor : accessorsToTry) {
if (accessor.canRead(this.evaluationContext, this.targetObject, this.name)) {
if (accessor instanceof ReflectivePropertyAccessor reflectivePropertyAccessor) {
@ -797,7 +797,7 @@ public class Indexer extends SpelNodeImpl {
Indexer.this.cachedPropertyWriteState = null;
}
List<PropertyAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(targetType, this.evaluationContext.getPropertyAccessors());
AccessorUtils.getAccessorsToTry(targetType, this.evaluationContext.getPropertyAccessors());
for (PropertyAccessor accessor : accessorsToTry) {
if (accessor.canWrite(this.evaluationContext, this.targetObject, this.name)) {
accessor.write(this.evaluationContext, this.targetObject, this.name, newValue);
@ -1014,7 +1014,7 @@ public class Indexer extends SpelNodeImpl {
Indexer.this.cachedIndexReadState = null;
}
List<IndexAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(this.target, this.evaluationContext.getIndexAccessors());
AccessorUtils.getAccessorsToTry(this.target, this.evaluationContext.getIndexAccessors());
for (IndexAccessor indexAccessor : accessorsToTry) {
if (indexAccessor.canRead(this.evaluationContext, this.target, this.index)) {
TypedValue result = indexAccessor.read(this.evaluationContext, this.target, this.index);
@ -1069,7 +1069,7 @@ public class Indexer extends SpelNodeImpl {
Indexer.this.cachedIndexWriteState = null;
}
List<IndexAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(this.target, this.evaluationContext.getIndexAccessors());
AccessorUtils.getAccessorsToTry(this.target, this.evaluationContext.getIndexAccessors());
for (IndexAccessor indexAccessor : accessorsToTry) {
if (indexAccessor.canWrite(this.evaluationContext, this.target, this.index)) {
indexAccessor.write(this.evaluationContext, this.target, this.index, newValue);

View File

@ -201,7 +201,7 @@ public class PropertyOrFieldReference extends SpelNodeImpl {
}
List<PropertyAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
AccessorUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
// Go through the accessors that may be able to resolve it. If they are a cacheable accessor then
// get the accessor and use it. If they are not cacheable but report they can read the property
// then ask them to read it
@ -259,7 +259,7 @@ public class PropertyOrFieldReference extends SpelNodeImpl {
}
List<PropertyAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
AccessorUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
try {
for (PropertyAccessor accessor : accessorsToTry) {
if (accessor.canWrite(evalContext, targetObject, name)) {
@ -284,7 +284,7 @@ public class PropertyOrFieldReference extends SpelNodeImpl {
Object targetObject = contextObject.getValue();
if (targetObject != null) {
List<PropertyAccessor> accessorsToTry =
AstUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
AccessorUtils.getAccessorsToTry(targetObject, evalContext.getPropertyAccessors());
for (PropertyAccessor accessor : accessorsToTry) {
try {
if (accessor.canWrite(evalContext, targetObject, name)) {

View File

@ -0,0 +1,125 @@
/*
* Copyright 2002-2024 the original author or authors.
*
* 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
*
* https://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 org.springframework.expression.spel.ast;
import java.util.List;
import org.junit.jupiter.api.Test;
import org.springframework.expression.TargetedAccessor;
import org.springframework.lang.Nullable;
import static org.assertj.core.api.Assertions.assertThat;
/**
* Tests for {@link AccessorUtils}.
*
* @author Sam Brannen
* @since 6.1.15
*/
class AccessorUtilsTests {
private final TargetedAccessor animal1Accessor = createAccessor("Animal1", Animal.class);
private final TargetedAccessor animal2Accessor = createAccessor("Animal2", Animal.class);
private final TargetedAccessor cat1Accessor = createAccessor("Cat1", Cat.class);
private final TargetedAccessor cat2Accessor = createAccessor("Cat2", Cat.class);
private final TargetedAccessor generic1Accessor = createAccessor("Generic1", null);
private final TargetedAccessor generic2Accessor = createAccessor("Generic2", null);
private final List<TargetedAccessor> accessors = List.of(
generic1Accessor,
cat1Accessor,
animal1Accessor,
animal2Accessor,
cat2Accessor,
generic2Accessor
);
@Test
void emptyAccessorsList() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry(new Cat(), List.of());
assertThat(accessorsToTry).isEmpty();
}
@Test
void noMatch() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry(new Dog(), List.of(cat1Accessor));
assertThat(accessorsToTry).isEmpty();
}
@Test
void singleExactTypeMatch() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry(new Cat(), List.of(cat1Accessor));
assertThat(accessorsToTry).containsExactly(cat1Accessor);
}
@Test
void exactTypeSupertypeAndGenericMatches() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry(new Cat(), accessors);
assertThat(accessorsToTry).containsExactly(
cat1Accessor, cat2Accessor, animal1Accessor, animal2Accessor, generic1Accessor, generic2Accessor);
}
@Test
void supertypeAndGenericMatches() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry(new Dog(), accessors);
assertThat(accessorsToTry).containsExactly(
animal1Accessor, animal2Accessor, generic1Accessor, generic2Accessor);
}
@Test
void genericMatches() {
List<TargetedAccessor> accessorsToTry = AccessorUtils.getAccessorsToTry("not an Animal", accessors);
assertThat(accessorsToTry).containsExactly(generic1Accessor, generic2Accessor);
}
private static TargetedAccessor createAccessor(String name, Class<?> type) {
return new DemoAccessor(name, (type != null ? new Class<?>[] { type } : null));
}
private record DemoAccessor(String name, Class<?>[] types) implements TargetedAccessor {
@Override
@Nullable
public Class<?>[] getSpecificTargetClasses() {
return this.types;
}
@Override
public final String toString() {
return this.name;
}
}
sealed interface Animal permits Cat, Dog {
}
static final class Cat implements Animal {
}
static final class Dog implements Animal {
}
}

View File

@ -1,162 +0,0 @@
/*
* Copyright 2002-2024 the original author or authors.
*
* 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
*
* https://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 org.springframework.expression.spel.ast;
import java.util.List;
import org.junit.jupiter.api.Test;
import org.springframework.expression.EvaluationContext;
import org.springframework.expression.PropertyAccessor;
import org.springframework.expression.TypedValue;
import org.springframework.lang.Nullable;
import static org.assertj.core.api.Assertions.assertThat;
/**
* Tests for {@link AstUtils}.
*
* @author Sam Brannen
* @since 6.1.15
*/
class AstUtilsTests {
private final PropertyAccessor animal1Accessor = createAccessor("Animal1", Animal.class);
private final PropertyAccessor animal2Accessor = createAccessor("Animal2", Animal.class);
private final PropertyAccessor cat1Accessor = createAccessor("Cat1", Cat.class);
private final PropertyAccessor cat2Accessor = createAccessor("Cat2", Cat.class);
private final PropertyAccessor generic1Accessor = createAccessor("Generic1", null);
private final PropertyAccessor generic2Accessor = createAccessor("Generic2", null);
private final List<PropertyAccessor> accessors = List.of(
generic1Accessor,
cat1Accessor,
animal1Accessor,
animal2Accessor,
cat2Accessor,
generic2Accessor
);
@Test
void emptyAccessorsList() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry(new Cat(), List.of());
assertThat(accessorsToTry).isEmpty();
}
@Test
void noMatch() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry(new Dog(), List.of(cat1Accessor));
assertThat(accessorsToTry).isEmpty();
}
@Test
void singleExactTypeMatch() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry(new Cat(), List.of(cat1Accessor));
assertThat(accessorsToTry).containsExactly(cat1Accessor);
}
@Test
void exactTypeMatches() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry(new Cat(), accessors);
assertThat(accessorsToTry).containsExactly(
cat1Accessor, cat2Accessor, animal1Accessor, animal2Accessor, generic1Accessor, generic2Accessor);
}
@Test
void supertypeMatches() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry(new Dog(), accessors);
assertThat(accessorsToTry).containsExactly(
animal1Accessor, animal2Accessor, generic1Accessor, generic2Accessor);
}
@Test
void genericMatches() {
List<PropertyAccessor> accessorsToTry = getPropertyAccessorsToTry("not an Animal", accessors);
assertThat(accessorsToTry).containsExactly(generic1Accessor, generic2Accessor);
}
private static PropertyAccessor createAccessor(String name, Class<?> type) {
return new DemoAccessor(name, type);
}
private static List<PropertyAccessor> getPropertyAccessorsToTry(Object target, List<PropertyAccessor> propertyAccessors) {
return AstUtils.getAccessorsToTry(target, propertyAccessors);
}
private static class DemoAccessor implements PropertyAccessor {
private final String name;
private final Class<?>[] types;
DemoAccessor(String name, Class<?> type) {
this.name = name;
this.types = (type != null ? new Class<?>[] {type} : null);
}
@Override
@Nullable
public Class<?>[] getSpecificTargetClasses() {
return this.types;
}
@Override
public String toString() {
return this.name;
}
@Override
public boolean canRead(EvaluationContext context, Object target, String name) {
return true;
}
@Override
public TypedValue read(EvaluationContext context, Object target, String name) {
throw new UnsupportedOperationException("Auto-generated method stub");
}
@Override
public boolean canWrite(EvaluationContext context, Object target, String name) {
return false;
}
@Override
public void write(EvaluationContext context, Object target, String name, Object newValue) {
/* no-op */
}
}
sealed interface Animal permits Bat, Cat, Dog {
}
static final class Bat implements Animal {
}
static final class Cat implements Animal {
}
static final class Dog implements Animal {
}
}