Package com.fasterxml.jackson.databind
Class PropertyNamingStrategy
- java.lang.Object
-
- com.fasterxml.jackson.databind.PropertyNamingStrategy
-
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
PropertyNamingStrategy.PropertyNamingStrategyBase
public class PropertyNamingStrategy extends Object implements Serializable
Class that defines how names of JSON properties ("external names") are derived from names of POJO methods and fields ("internal names"), in cases where they are not auto-detected and no explicit annotations exist for naming. Methods are passed information about POJO member for which name is needed, as well as default name that would be used if no custom strategy was used.Default (empty) implementation returns suggested ("default") name unmodified.
Note that the strategy is guaranteed to be called once per logical property (which may be represented by multiple members; such as pair of a getter and a setter), but may be called for each: implementations should not count on exact number of times, and should work for any member that represent a property.
In absence of a registered custom strategy, default Java property naming strategy is used, which leaves field names as is, and removes set/get/is prefix from methods (as well as lower-cases initial sequence of capitalized characters).
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classPropertyNamingStrategy.KebabCaseStrategyNaming strategy similar toPropertyNamingStrategy.SnakeCaseStrategy, but instead of underscores as separators, uses hyphens.static classPropertyNamingStrategy.LowerCaseStrategySimple strategy where external name simply only uses lower-case characters, and no separators.static classPropertyNamingStrategy.LowerCaseWithUnderscoresStrategyDeprecated.In 2.7 usePropertyNamingStrategy.SnakeCaseStrategyinsteadstatic classPropertyNamingStrategy.LowerDotCaseStrategyNaming strategy similar toPropertyNamingStrategy.KebabCaseStrategy, but instead of hyphens as separators, uses dots.static classPropertyNamingStrategy.PascalCaseStrategyDeprecated.In 2.7 usePropertyNamingStrategy.UpperCamelCaseStrategyinsteadstatic classPropertyNamingStrategy.PropertyNamingStrategyBasestatic classPropertyNamingStrategy.SnakeCaseStrategyAPropertyNamingStrategythat translates typical camel case Java property names to lower case JSON element names, separated by underscores.static classPropertyNamingStrategy.UpperCamelCaseStrategyAPropertyNamingStrategythat translates typical camelCase Java property names to PascalCase JSON element names (i.e., with a capital first letter).
-
Field Summary
Fields Modifier and Type Field Description static PropertyNamingStrategyCAMEL_CASE_TO_LOWER_CASE_WITH_UNDERSCORESDeprecated.Since 2.7 useSNAKE_CASEinstead;static PropertyNamingStrategyKEBAB_CASENaming convention used in languages like Lisp, where words are in lower-case letters, separated by hyphens.static PropertyNamingStrategyLOWER_CAMEL_CASENaming convention used in Java, where words other than first are capitalized and no separator is used between words.static PropertyNamingStrategyLOWER_CASENaming convention in which all words of the logical name are in lower case, and no separator is used between words.static PropertyNamingStrategyLOWER_DOT_CASENaming convention widely used as configuration properties name, where words are in lower-case letters, separated by dots.static PropertyNamingStrategyPASCAL_CASE_TO_CAMEL_CASEDeprecated.Since 2.7 useUPPER_CAMEL_CASEinstead;static PropertyNamingStrategySNAKE_CASENaming convention used in languages like C, where words are in lower-case letters, separated by underscores.static PropertyNamingStrategyUPPER_CAMEL_CASENaming convention used in languages like Pascal, where words are capitalized and no separator is used between words.
-
Constructor Summary
Constructors Constructor Description PropertyNamingStrategy()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringnameForConstructorParameter(MapperConfig<?> config, AnnotatedParameter ctorParam, String defaultName)Method called to find external name (name used in JSON) for given logical POJO property, as defined by given constructor parameter; typically called when building a deserializer (but not necessarily only then).StringnameForField(MapperConfig<?> config, AnnotatedField field, String defaultName)Method called to find external name (name used in JSON) for given logical POJO property, as defined by given field.StringnameForGetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName)Method called to find external name (name used in JSON) for given logical POJO property, as defined by given getter method; typically called when building a serializer.StringnameForSetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName)Method called to find external name (name used in JSON) for given logical POJO property, as defined by given setter method; typically called when building a deserializer (but not necessarily only then).
-
-
-
Field Detail
-
SNAKE_CASE
public static final PropertyNamingStrategy SNAKE_CASE
Naming convention used in languages like C, where words are in lower-case letters, separated by underscores. SeePropertyNamingStrategy.SnakeCaseStrategyfor details.- Since:
- 2.7 (was formerly called
CAMEL_CASE_TO_LOWER_CASE_WITH_UNDERSCORES)
-
UPPER_CAMEL_CASE
public static final PropertyNamingStrategy UPPER_CAMEL_CASE
Naming convention used in languages like Pascal, where words are capitalized and no separator is used between words. SeePropertyNamingStrategy.PascalCaseStrategyfor details.- Since:
- 2.7 (was formerly called
PASCAL_CASE_TO_CAMEL_CASE)
-
LOWER_CAMEL_CASE
public static final PropertyNamingStrategy LOWER_CAMEL_CASE
Naming convention used in Java, where words other than first are capitalized and no separator is used between words. Since this is the native Java naming convention, naming strategy will not do any transformation between names in data (JSON) and POJOS.- Since:
- 2.7 (was formerly called
PASCAL_CASE_TO_CAMEL_CASE)
-
LOWER_CASE
public static final PropertyNamingStrategy LOWER_CASE
Naming convention in which all words of the logical name are in lower case, and no separator is used between words. SeePropertyNamingStrategy.LowerCaseStrategyfor details.- Since:
- 2.4
-
KEBAB_CASE
public static final PropertyNamingStrategy KEBAB_CASE
Naming convention used in languages like Lisp, where words are in lower-case letters, separated by hyphens. SeePropertyNamingStrategy.KebabCaseStrategyfor details.- Since:
- 2.7
-
LOWER_DOT_CASE
public static final PropertyNamingStrategy LOWER_DOT_CASE
Naming convention widely used as configuration properties name, where words are in lower-case letters, separated by dots. SeePropertyNamingStrategy.LowerDotCaseStrategyfor details.- Since:
- 2.10
-
CAMEL_CASE_TO_LOWER_CASE_WITH_UNDERSCORES
@Deprecated public static final PropertyNamingStrategy CAMEL_CASE_TO_LOWER_CASE_WITH_UNDERSCORES
Deprecated.Since 2.7 useSNAKE_CASEinstead;
-
PASCAL_CASE_TO_CAMEL_CASE
@Deprecated public static final PropertyNamingStrategy PASCAL_CASE_TO_CAMEL_CASE
Deprecated.Since 2.7 useUPPER_CAMEL_CASEinstead;
-
-
Method Detail
-
nameForField
public String nameForField(MapperConfig<?> config, AnnotatedField field, String defaultName)
Method called to find external name (name used in JSON) for given logical POJO property, as defined by given field.- Parameters:
config- Configuration in used: eitherSerializationConfigorDeserializationConfig, depending on whether method is called during serialization or deserializationfield- Field used to access propertydefaultName- Default name that would be used for property in absence of custom strategy- Returns:
- Logical name to use for property that the field represents
-
nameForGetterMethod
public String nameForGetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName)
Method called to find external name (name used in JSON) for given logical POJO property, as defined by given getter method; typically called when building a serializer. (but not always -- when using "getter-as-setter", may be called during deserialization)- Parameters:
config- Configuration in used: eitherSerializationConfigorDeserializationConfig, depending on whether method is called during serialization or deserializationmethod- Method used to access property.defaultName- Default name that would be used for property in absence of custom strategy- Returns:
- Logical name to use for property that the method represents
-
nameForSetterMethod
public String nameForSetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName)
Method called to find external name (name used in JSON) for given logical POJO property, as defined by given setter method; typically called when building a deserializer (but not necessarily only then).- Parameters:
config- Configuration in used: eitherSerializationConfigorDeserializationConfig, depending on whether method is called during serialization or deserializationmethod- Method used to access property.defaultName- Default name that would be used for property in absence of custom strategy- Returns:
- Logical name to use for property that the method represents
-
nameForConstructorParameter
public String nameForConstructorParameter(MapperConfig<?> config, AnnotatedParameter ctorParam, String defaultName)
Method called to find external name (name used in JSON) for given logical POJO property, as defined by given constructor parameter; typically called when building a deserializer (but not necessarily only then).- Parameters:
config- Configuration in used: eitherSerializationConfigorDeserializationConfig, depending on whether method is called during serialization or deserializationctorParam- Constructor parameter used to pass property.defaultName- Default name that would be used for property in absence of custom strategy
-
-