org.acegisecurity.util.FieldUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of acegi-security
The newest version!
/* Copyright 2004, 2005, 2006 Acegi Technology Pty Limited
 *
 * 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 org.acegisecurity.util;

import org.springframework.util.Assert;
import org.springframework.util.ReflectionUtils;

import java.lang.reflect.Field;


/**
 * Offers static methods for directly manipulating static fields.
 *
 * @author Ben Alex
 * @version $Id: FieldUtils.java 1784 2007-02-24 21:00:24Z luke_t $
 */
public final class FieldUtils {
    //~ Constructors ===================================================================================================

    private FieldUtils() {
    }

    //~ Methods ========================================================================================================

    public static String getAccessorName(String fieldName, Class type) {
        Assert.hasText(fieldName, "FieldName required");
        Assert.notNull(type, "Type required");

        if (type.getName().equals("boolean")) {
            return "is" + org.springframework.util.StringUtils.capitalize(fieldName);
        } else {
            return "get" + org.springframework.util.StringUtils.capitalize(fieldName);
        }
    }

    /**
     * Attempts to locate the specified field on the class.
     *
     * @param clazz the class definition containing the field
     * @param fieldName the name of the field to locate
     *
     * @return the Field (never null)
     *
     * @throws IllegalStateException if field could not be found
     */
    public static Field getField(Class clazz, String fieldName)
        throws IllegalStateException {
        Assert.notNull(clazz, "Class required");
        Assert.hasText(fieldName, "Field name required");

        try {
            return clazz.getDeclaredField(fieldName);
        } catch (NoSuchFieldException nsf) {
            // Try superclass
            if (clazz.getSuperclass() != null) {
                return getField(clazz.getSuperclass(), fieldName);
            }

            throw new IllegalStateException("Could not locate field '" + fieldName + "' on class " + clazz);
        }
    }

    public static String getMutatorName(String fieldName) {
        Assert.hasText(fieldName, "FieldName required");

        return "set" + org.springframework.util.StringUtils.capitalize(fieldName);
    }

    public static Object getProtectedFieldValue(String protectedField, Object object) {
        Field field = FieldUtils.getField(object.getClass(), protectedField);

        try {
            field.setAccessible(true);

            return field.get(object);
        } catch (Exception ex) {
            ReflectionUtils.handleReflectionException(ex);

            return null; // unreachable - previous line throws exception
        }
    }

    public static void setProtectedFieldValue(String protectedField, Object object, Object newValue) {
        Field field = FieldUtils.getField(object.getClass(), protectedField);

        try {
            field.setAccessible(true);
            field.set(object, newValue);
        } catch (Exception ex) {
            ReflectionUtils.handleReflectionException(ex);
        }
    }
}