Fix #3633: expose typed instances of standard PropertyNamingStrategy instances. (#3641)

Author: cowtowncoder

release-notes/CREDITS-2.x

@@ -1507,3 +1507,8 @@ Richard Kwasnicki (Richie94@github)
   * Contributed #3609: Allow non-boolean return type for "is-getters" with
   `MapperFeature.ALLOW_IS_GETTERS_FOR_NON_BOOLEAN`
   (2.14.0)
+
+Joachim Durchholz (toolforger@github)
+  * Requested #3633: Expose `translate()` method of standard `PropertyNamingStrategy`
+   implementations
+  (2.14.0)

release-notes/VERSION-2.x

@@ -11,7 +11,9 @@ Not yet released:
  (contributed by Felix V)
 #3624: Legacy `ALLOW_COERCION_OF_SCALARS` interacts poorly with Integer to
   Float coercion
-(contributed by Carter K)
+ (contributed by Carter K)
+#3633: Expose `translate()` method of standard `PropertyNamingStrategy` implementations
+ (requested by Joachim D)
 
 2.14.0-rc2 (10-Oct-2022)
 

src/main/java/com/fasterxml/jackson/databind/PropertyNamingStrategies.java

@@ -33,7 +33,7 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "numberValue", "namingStrategy", "theDefiniteProof".
      */
-    public static final PropertyNamingStrategy LOWER_CAMEL_CASE = new LowerCamelCaseStrategy();
+    public static final PropertyNamingStrategy LOWER_CAMEL_CASE = LowerCamelCaseStrategy.INSTANCE;
 
     /**
      * Naming convention used in languages like Pascal, where all words are capitalized
@@ -42,7 +42,7 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "NumberValue", "NamingStrategy", "TheDefiniteProof".
      */
-    public static final PropertyNamingStrategy UPPER_CAMEL_CASE = new UpperCamelCaseStrategy();
+    public static final PropertyNamingStrategy UPPER_CAMEL_CASE = UpperCamelCaseStrategy.INSTANCE;
 
     /**
      * Naming convention used in languages like C, where words are in lower-case
@@ -51,15 +51,15 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "number_value", "naming_strategy", "the_definite_proof".
      */
-    public static final PropertyNamingStrategy SNAKE_CASE = new SnakeCaseStrategy();
+    public static final PropertyNamingStrategy SNAKE_CASE = SnakeCaseStrategy.INSTANCE;
 
     /**
      * Naming convention in which the words are in upper-case letters, separated by underscores.
      * See {@link UpperSnakeCaseStrategy} for details.
      * @since 2.13
      * <p>
      */
-    public static final PropertyNamingStrategy UPPER_SNAKE_CASE = new UpperSnakeCaseStrategy();
+    public static final PropertyNamingStrategy UPPER_SNAKE_CASE = UpperSnakeCaseStrategy.INSTANCE;
 
     /**
      * Naming convention in which all words of the logical name are in lower case, and
@@ -68,7 +68,7 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "numbervalue", "namingstrategy", "thedefiniteproof".
      */
-    public static final PropertyNamingStrategy LOWER_CASE = new LowerCaseStrategy();
+    public static final PropertyNamingStrategy LOWER_CASE = LowerCaseStrategy.INSTANCE;
 
     /**
      * Naming convention used in languages like Lisp, where words are in lower-case
@@ -77,7 +77,7 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "number-value", "naming-strategy", "the-definite-proof".
      */
-    public static final PropertyNamingStrategy KEBAB_CASE = new KebabCaseStrategy();
+    public static final PropertyNamingStrategy KEBAB_CASE = KebabCaseStrategy.INSTANCE;
 
     /**
      * Naming convention widely used as configuration properties name, where words are in
@@ -86,7 +86,7 @@ public abstract class PropertyNamingStrategies
      *<p>
      * Example external property names would be "number.value", "naming.strategy", "the.definite.proof".
      */
-    public static final PropertyNamingStrategy LOWER_DOT_CASE = new LowerDotCaseStrategy();
+    public static final PropertyNamingStrategy LOWER_DOT_CASE = LowerDotCaseStrategy.INSTANCE;
 
     /*
     /**********************************************************************
@@ -224,6 +224,12 @@ public static class SnakeCaseStrategy extends NamingBase
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.SnakeCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.SnakeCaseStrategy();
+
         @Override
         public String translate(String input)
         {
@@ -270,6 +276,12 @@ public static class UpperSnakeCaseStrategy extends SnakeCaseStrategy
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.UpperSnakeCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.UpperSnakeCaseStrategy();
+
         @Override
         public String translate(String input) {
             String output = super.translate(input);
@@ -287,6 +299,12 @@ public static class LowerCamelCaseStrategy extends NamingBase
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.LowerCamelCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.LowerCamelCaseStrategy();
+
         @Override
         public String translate(String input) {
             return input;
@@ -310,6 +328,12 @@ public static class UpperCamelCaseStrategy extends NamingBase
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.UpperCamelCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.UpperCamelCaseStrategy();
+
         /**
          * Converts camelCase to PascalCase
          * 
@@ -346,6 +370,12 @@ public static class LowerCaseStrategy extends NamingBase
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.LowerCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.LowerCaseStrategy();
+
         @Override
         public String translate(String input) {
             return input.toLowerCase();
@@ -362,6 +392,12 @@ public static class KebabCaseStrategy extends NamingBase
     {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.KebabCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.KebabCaseStrategy();
+
         @Override
         public String translate(String input) {
             return translateLowerCaseWithSeparator(input, '-');
@@ -373,12 +409,20 @@ public String translate(String input) {
      * but instead of hyphens
      * as separators, uses dots. Naming convention widely used as configuration properties name.
      */
-    public static class LowerDotCaseStrategy extends NamingBase {
+    public static class LowerDotCaseStrategy extends NamingBase
+    {
         private static final long serialVersionUID = 2L;
 
+        /**
+         * @since 2.14
+         */
+        public final static PropertyNamingStrategies.LowerDotCaseStrategy INSTANCE
+            = new PropertyNamingStrategies.LowerDotCaseStrategy();
+
         @Override
         public String translate(String input){
             return translateLowerCaseWithSeparator(input, '.');
         }
     }
 }
+