jakartaee#340 - [api] Add support for 'pre-encoded keys'

api/src/main/java/jakarta/json/spi/JsonProvider.java

@@ -237,6 +237,17 @@ private static void checkPackageAccess(String className) {
      */
     public abstract JsonGeneratorFactory createGeneratorFactory(Map<String, ?> config);
 
+    /**
+     * Creates a generator key for the given JSON name.
+     * The {@code JsonGenerator.Key} is immutable and can be held and reused.
+     * This generator key is optimised for use to writing keys via {@code JsonGenerator}
+     * by being escaped and encoded when compared to using {@code String} keys.
+     *
+     * @param key The JSON name
+     * @return The JSON generator key
+     */
+    public abstract JsonGenerator.Key createGeneratorKey(String key);
+
     /**
      * Creates a JSON reader from a character stream.
      *

api/src/main/java/jakarta/json/stream/JsonGenerator.java

@@ -540,4 +540,16 @@ public interface JsonGenerator extends Flushable, /*Auto*/Closeable {
     @Override
     void flush();
 
+    /**
+     * A JSON name that can be optimised for writing by a {@code JsonGenerator}.
+     */
+    interface Key {
+
+        /**
+         * Return the key as escaped character array.
+         *
+         * @return the key in escaped character array.
+         */
+        char[] toCharArray();
+    }
 }