Package org.joda.convert
Class RenameHandler
java.lang.Object
org.joda.convert.RenameHandler
A general purpose utility for registering renames.
This handles type and enum constant renames. For example, use as follows:
RenameHandler.INSTANCE.renamedType("org.joda.OldName", NewName.class); RenameHandler.INSTANCE.renamedEnum("CORRECT", Status.VALID); RenameHandler.INSTANCE.renamedEnum("INCORRECT", Status.INVALID);The recommended usage is to edit the static singleton before using other classes. Editing a static is acceptable because renames are driven by bytecode which is static. For additional security, an application should lock the rename handler instance once any types and enums have been registered using
lock()
.
This class is thread-safe with concurrent caches.
- Since:
- 1.6
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionstatic RenameHandler
create()
Creates an instance.getEnumRenames
(Class<?> type) Gets the map of renamed for an enum type.Gets the set of enum types that have renames.Gets the map of renamed types.void
lock()
Locks this instance of the rename handler.<T extends Enum<T>>
TlookupEnum
(Class<T> type, String name) Lookup an enum from a name, handling renames.Class<?>
lookupType
(String name) Lookup a type from a name, handling renames.void
renamedEnum
(String oldName, Enum<?> currentValue) Register the fact that an enum constant was renamed.void
renamedType
(String oldName, Class<?> currentValue) Register the fact that a type was renamed.toString()
-
Field Details
-
INSTANCE
A mutable global instance. This is a singleton instance which is mutated.
-
-
Method Details
-
create
Creates an instance.This is not normally used as the preferred option is to edit the singleton.
- Returns:
- a new instance, not null
-
renamedType
Register the fact that a type was renamed.This handles the use case where a class is renamed.
- Parameters:
oldName
- the old name of the type including the package name, not nullcurrentValue
- the current type, not null
-
getTypeRenames
Gets the map of renamed types.An empty map is returned if there are no renames.
- Returns:
- a copy of the set of enum types with renames, not null
-
lookupType
Lookup a type from a name, handling renames.- Parameters:
name
- the name of the type to lookup, not null- Returns:
- the type, not null
- Throws:
ClassNotFoundException
- if the name is not a valid type
-
renamedEnum
Register the fact that an enum constant was renamed.This handles the use case where an enum constant is renamed, but the enum class remains the same.
- Parameters:
oldName
- the old name of the enum constant, not nullcurrentValue
- the current enum constant, not null
-
getEnumTypesWithRenames
Gets the set of enum types that have renames.An empty set is returned if there are no renames.
- Returns:
- a copy of the set of enum types with renames, not null
-
getEnumRenames
Gets the map of renamed for an enum type.An empty map is returned if there are no renames.
- Parameters:
type
- the enum type, not null- Returns:
- a copy of the set of enum renames, not null
-
lookupEnum
Lookup an enum from a name, handling renames.- Type Parameters:
T
- the type of the desired enum- Parameters:
type
- the enum type, not nullname
- the name of the enum to lookup, not null- Returns:
- the enum value, not null
- Throws:
IllegalArgumentException
- if the name is not a valid enum constant
-
lock
public void lock()Locks this instance of the rename handler.For additional security, an application should lock the rename handler once any types and enums have been registered.
-
toString
-