From 1081c267d94ff90272a4332235f0c474fa51caa4 Mon Sep 17 00:00:00 2001
From: Ben Alex <ben.alex@springsource.com>
Date: Fri, 17 Nov 2006 02:03:23 +0000
Subject: [PATCH] SEC-239: New ACL module.

---
 .../org/acegisecurity/util/FieldUtils.java    | 101 ++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 core/src/main/java/org/acegisecurity/util/FieldUtils.java

diff --git a/core/src/main/java/org/acegisecurity/util/FieldUtils.java b/core/src/main/java/org/acegisecurity/util/FieldUtils.java
new file mode 100644
index 0000000000..d549608dcf
--- /dev/null
+++ b/core/src/main/java/org/acegisecurity/util/FieldUtils.java
@@ -0,0 +1,101 @@
+/* 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$
+ */
+public class 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);
+        }
+    }
+}