java.beans
public class: PropertyEditorManager [javadoc |
source]
java.lang.Object
java.beans.PropertyEditorManager
The PropertyEditorManager can be used to locate a property editor for
any given type name. This property editor must support the
java.beans.PropertyEditor interface for editing a given object.
The PropertyEditorManager uses three techniques for locating an editor
for a given type. First, it provides a registerEditor method to allow
an editor to be specifically registered for a given type. Second it
tries to locate a suitable class by adding "Editor" to the full
qualified classname of the given type (e.g. "foo.bah.FozEditor").
Finally it takes the simple classname (without the package name) adds
"Editor" to it and looks in a search-path of packages for a matching
class.
So for an input class foo.bah.Fred, the PropertyEditorManager would
first look in its tables to see if an editor had been registered for
foo.bah.Fred and if so use that. Then it will look for a
foo.bah.FredEditor class. Then it will look for (say)
standardEditorsPackage.FredEditor class.
Default PropertyEditors will be provided for the Java primitive types
"boolean", "byte", "short", "int", "long", "float", and "double"; and
for the classes java.lang.String. java.awt.Color, and java.awt.Font.
| Methods from java.lang.Object: |
|---|
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method from java.beans.PropertyEditorManager Detail: |
|---|
 public static synchronized PropertyEditor findEditor(Class targetType) {
initialize();
Class editorClass = (Class)registry.get(targetType);
if (editorClass != null) {
try {
Object o = editorClass.newInstance();
return (PropertyEditor)o;
} catch (Exception ex) {
System.err.println("Couldn't instantiate type editor \"" +
editorClass.getName() + "\" : " + ex);
}
}
// Now try adding "Editor" to the class name.
String editorName = targetType.getName() + "Editor";
try {
return (PropertyEditor) Introspector.instantiate(targetType, editorName);
} catch (Exception ex) {
// Silently ignore any errors.
}
// Now try looking for < searchPath >.fooEditor
int index = editorName.lastIndexOf('.") + 1;
if (index > 0) {
editorName = editorName.substring(index);
}
for (String path : searchPath) {
String name = path + '." + editorName;
try {
return (PropertyEditor) Introspector.instantiate(targetType, name);
} catch (Exception ex) {
// Silently ignore any errors.
}
}
if (null != targetType.getEnumConstants()) {
return new EnumEditor(targetType);
}
// We couldn't find a suitable Editor.
return null;
}
Locate a value editor for a given target type. |
public static synchronized String[] getEditorSearchPath() {
// Return a copy of the searchPath.
String result[] = new String[searchPath.length];
System.arraycopy(searchPath, 0, result, 0, searchPath.length);
return result;
} Gets the package names that will be searched for property editors. |
public static void registerEditor(Class targetType,
Class editorClass) {
SecurityManager sm = System.getSecurityManager();
if (sm != null) {
sm.checkPropertiesAccess();
}
initialize();
if (editorClass == null) {
registry.remove(targetType);
} else {
registry.put(targetType, editorClass);
}
} Register an editor class to be used to edit values of
a given target class.
First, if there is a security manager, its checkPropertiesAccess
method is called. This could result in a SecurityException. |
public static synchronized void setEditorSearchPath(String[] path) {
SecurityManager sm = System.getSecurityManager();
if (sm != null) {
sm.checkPropertiesAccess();
}
if (path == null) {
path = new String[0];
}
searchPath = path;
} Change the list of package names that will be used for
finding property editors.
First, if there is a security manager, its checkPropertiesAccess
method is called. This could result in a SecurityException. |
Save This Page