FilesExpand file tree

 master

/

PropertyEditorManager.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

125 lines (118 loc) · 4.52 KB

 master

/

PropertyEditorManager.java

Copy path

Top

File metadata and controls

• Code
• Blame

125 lines (118 loc) · 4.52 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

/*

* Copyright (c) 1996, 2011, Oracle and/or its affiliates. All rights reserved.

* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*/

package java.beans;

/**

* 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.

* <P>

* 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.

* <P>

* 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.

* <p>

* 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.

*/

public class PropertyEditorManager {

/**

* Registers an editor class to edit values of the given target class.

* If the editor class is {@code null},

* then any existing definition will be removed.

* Thus this method can be used to cancel the registration.

* The registration is canceled automatically

* if either the target or editor class is unloaded.

* <p>

* If there is a security manager, its {@code checkPropertiesAccess}

* method is called. This could result in a {@linkplain SecurityException}.

*

* @param targetType the class object of the type to be edited

* @param editorClass the class object of the editor class

* @throws SecurityException if a security manager exists and

* its {@code checkPropertiesAccess} method

* doesn't allow setting of system properties

*

* @see SecurityManager#checkPropertiesAccess

*/

public static void registerEditor(Class<?> targetType, Class<?> editorClass) {

SecurityManager sm = System.getSecurityManager();

if (sm != null) {

sm.checkPropertiesAccess();

}

ThreadGroupContext.getContext().getPropertyEditorFinder().register(targetType, editorClass);

}

/**

* Locate a value editor for a given target type.

*

* @param targetType The Class object for the type to be edited

* @return An editor object for the given target class.

* The result is null if no suitable editor can be found.

*/

public static PropertyEditor findEditor(Class<?> targetType) {

return ThreadGroupContext.getContext().getPropertyEditorFinder().find(targetType);

}

/**

* Gets the package names that will be searched for property editors.

*

* @return The array of package names that will be searched in

* order to find property editors.

* <p> The default value for this array is implementation-dependent,

* e.g. Sun implementation initially sets to {"sun.beans.editors"}.

*/

public static String[] getEditorSearchPath() {

return ThreadGroupContext.getContext().getPropertyEditorFinder().getPackages();

}

/**

* Change the list of package names that will be used for

* finding property editors.

*

* <p>First, if there is a security manager, its <code>checkPropertiesAccess</code>

* method is called. This could result in a SecurityException.

*

* @param path Array of package names.

* @exception SecurityException if a security manager exists and its

* <code>checkPropertiesAccess</code> method doesn't allow setting

* of system properties.

* @see SecurityManager#checkPropertiesAccess

*/

public static void setEditorSearchPath(String[] path) {

SecurityManager sm = System.getSecurityManager();

if (sm != null) {

sm.checkPropertiesAccess();

}

ThreadGroupContext.getContext().getPropertyEditorFinder().setPackages(path);

}

}