(2.8) Add JsonGenerator. writeEmbeddedObject() to allow writes of opaque native types

src/main/java/com/fasterxml/jackson/core/JsonGenerator.java

@@ -1236,6 +1236,17 @@ public void writeTypeId(Object id) throws IOException {
         throw new JsonGenerationException("No native support for writing Type Ids", this);
     }
 
+    /**
+     * Method that can be called on backends that support passing opaque datatypes of
+     * non-JSON formats
+     *
+     * @since 2.8
+     */
+    public void writeEmbeddedObject(Object object) throws IOException {
+        throw new JsonGenerationException("No native support for writing embedded objects",
+                this);
+    }
+
     /*
     /**********************************************************
     /* Public API, write methods, serializing Java objects

src/main/java/com/fasterxml/jackson/core/util/JsonGeneratorDelegate.java

@@ -326,6 +326,9 @@ public JsonGenerator setPrettyPrinter(PrettyPrinter pp) {
 
     @Override
     public void writeTypeId(Object id) throws IOException { delegate.writeTypeId(id); }
+
+    @Override
+    public void writeEmbeddedObject(Object object) throws IOException { delegate.writeEmbeddedObject(object); }
 
     /*
     /**********************************************************