You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by tv...@apache.org on 2026/01/30 16:16:57 UTC

(commons-jcs) branch master updated: Add optional JSON serializer/deserializer based on Jackson

This is an automated email from the ASF dual-hosted git repository.

tv pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-jcs.git


The following commit(s) were added to refs/heads/master by this push:
     new 29d49bf4 Add optional JSON serializer/deserializer based on Jackson
29d49bf4 is described below

commit 29d49bf48e6d8937e7c1c0677886965dd79e10fb
Author: Thomas Vandahl <tv...@apache.org>
AuthorDate: Fri Jan 30 17:16:54 2026 +0100

    Add optional JSON serializer/deserializer based on Jackson
---
 commons-jcs3-core/pom.xml                          |   7 +
 commons-jcs3-core/src/main/java/module-info.java   |  13 +-
 .../jcs3/utils/serialization/JSONSerializer.java   |  99 ++++++++++++++
 .../serialization/JSONSerializerUnitTest.java      | 143 +++++++++++++++++++++
 .../utils/serialization/SerializerUnitTest.java    |  90 ++++++++-----
 .../src/test/test-conf/TestElementSerializer.ccf   |  12 ++
 src/changes/changes.xml                            |   3 +
 7 files changed, 332 insertions(+), 35 deletions(-)

diff --git a/commons-jcs3-core/pom.xml b/commons-jcs3-core/pom.xml
index c0376525..9dac65c8 100644
--- a/commons-jcs3-core/pom.xml
+++ b/commons-jcs3-core/pom.xml
@@ -103,6 +103,13 @@
       <artifactId>jakarta.servlet-api</artifactId>
       <optional>true</optional>
     </dependency>
+
+    <dependency>
+      <groupId>com.fasterxml.jackson.core</groupId>
+      <artifactId>jackson-databind</artifactId>
+      <version>2.20.1</version>
+      <optional>true</optional>
+    </dependency>
   </dependencies>
 
   <build>
diff --git a/commons-jcs3-core/src/main/java/module-info.java b/commons-jcs3-core/src/main/java/module-info.java
index aed49d22..5d9a95b1 100644
--- a/commons-jcs3-core/src/main/java/module-info.java
+++ b/commons-jcs3-core/src/main/java/module-info.java
@@ -93,14 +93,14 @@ module org.apache.commons.jcs3.core {
 
     // Java platform modules - required
     requires java.base;
-    requires java.rmi;
-    requires java.sql;
     requires java.management;
-    requires java.naming;
     requires java.desktop;
+    requires transitive java.rmi;
+    requires transitive java.sql;
+    requires transitive java.naming;
 
     // Optional dependencies for remote HTTP caching
-    requires static jakarta.servlet;
+    requires transitive jakarta.servlet;
 
     // Optional dependencies for JDBC disk cache
     requires static org.apache.commons.dbcp2;
@@ -109,6 +109,11 @@ module org.apache.commons.jcs3.core {
     requires static org.apache.httpcomponents.httpclient;
     requires static org.apache.httpcomponents.httpcore;
 
+    // Optional dependencies for remote HTTP caching
+    requires static com.fasterxml.jackson.databind;
+    opens org.apache.commons.jcs3.utils.serialization to com.fasterxml.jackson.databind;
+    opens org.apache.commons.jcs3.engine to com.fasterxml.jackson.databind;
+
     // Uses and provides clauses
     uses org.apache.commons.jcs3.auxiliary.AuxiliaryCacheFactory;
 }
diff --git a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java
new file mode 100644
index 00000000..b563d060
--- /dev/null
+++ b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java
@@ -0,0 +1,99 @@
+package org.apache.commons.jcs3.utils.serialization;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import java.io.IOException;
+
+import org.apache.commons.jcs3.engine.behavior.IElementSerializer;
+
+import com.fasterxml.jackson.core.exc.StreamReadException;
+import com.fasterxml.jackson.databind.DatabindException;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.json.JsonMapper;
+
+/**
+ * Performs JSON serialization and de-serialization.
+ */
+public class JSONSerializer
+    implements IElementSerializer
+{
+    /** Jackson JSON mapper instance */
+    private static final ObjectMapper mapper = JsonMapper.builder().build();
+
+    /** Wrapper to save the class name information */
+    private record Wrapper<T>(String className, T element) {}
+
+    /**
+     * Uses JSON de-serialization to turn a byte array into an object. All exceptions are
+     * converted into IOExceptions.
+     *
+     * @param data data bytes
+     * @param loader class loader to use
+     * @return Object
+     * @throws IOException
+     * @throws ClassNotFoundException
+     */
+    @Override
+    public <T> T deSerialize(final byte[] data, final ClassLoader loader)
+        throws IOException, ClassNotFoundException
+    {
+        if (data == null || data.length == 0)
+        {
+            return null;
+        }
+
+        try
+        {
+            JsonNode root = mapper.readTree(data);
+            String className = root.at("/className").asText();
+
+            @SuppressWarnings("unchecked") // Need to cast from Object
+            Class<T> clazz = (Class<T>)Class.forName(className, false,
+                    loader == null ? this.getClass().getClassLoader() : loader);
+
+            return mapper.treeToValue(root.at("/element"), clazz);
+        }
+        catch (StreamReadException | DatabindException e)
+        {
+            throw new IOException("Error deserializing JSON", e);
+        }
+    }
+
+    /**
+     * Serializes an object using JSON serialization.
+     *
+     * @param obj
+     * @return byte[]
+     * @throws IOException
+     */
+    @Override
+    public <T> byte[] serialize(final T obj)
+        throws IOException
+    {
+        if (obj == null)
+        {
+            return null;
+        }
+
+        Wrapper<T> wrapper = new Wrapper<T>(obj.getClass().getName(), obj);
+        return mapper.writeValueAsBytes(wrapper);
+    }
+}
diff --git a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java
new file mode 100644
index 00000000..c786598a
--- /dev/null
+++ b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java
@@ -0,0 +1,143 @@
+package org.apache.commons.jcs3.utils.serialization;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+import java.nio.charset.StandardCharsets;
+import java.util.Calendar;
+import java.util.Date;
+import java.util.GregorianCalendar;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Tests the JSON serializer.
+ */
+class JSONSerializerUnitTest
+{
+    private JSONSerializer serializer;
+
+    /**
+     * Test setup
+     *
+     * @throws Exception
+     */
+    @BeforeEach
+    void setUp()
+        throws Exception
+    {
+        this.serializer = new JSONSerializer();
+    }
+
+    public static record Person(String name, int age, Date birthdate) {}
+
+    /**
+     * Test simple back and forth with an object.
+     *
+     * @throws Exception
+     */
+    @Test
+    void testObjectBackAndForth()
+        throws Exception
+    {
+        Date date = new GregorianCalendar(1977, Calendar.DECEMBER, 15).getTime();
+        final Person before = new Person("joe", 21, date);
+
+        // DO WORK
+        byte[] serialized = serializer.serialize(before);
+        System.out.println(new String(serialized, StandardCharsets.UTF_8));
+        final Person after = serializer.deSerialize(serialized, null);
+
+        // VERIFY
+        assertEquals(before.name(), after.name(), "Before and after should be the same.");
+        assertEquals(before.age(), after.age(), "Before and after should be the same.");
+        assertEquals(before.birthdate(), after.birthdate(), "Before and after should be the same.");
+    }
+
+    /**
+     * Test simple back and forth with a string.
+     *
+     * @throws Exception
+     */
+    @Test
+    void testBigStringBackAndForth()
+        throws Exception
+    {
+        final String string = "This is my big string ABCDEFGH";
+        final StringBuilder sb = new StringBuilder();
+        sb.append( string );
+        for ( int i = 0; i < 4; i++ )
+        {
+            sb.append( " " + i + sb.toString() ); // big string
+        }
+        final String before = sb.toString();
+
+        // DO WORK
+        final String after = (String) serializer.deSerialize( serializer.serialize( before ), null );
+
+        // VERIFY
+        assertEquals( before, after, "Before and after should be the same." );
+    }
+
+    /**
+     * Test serialization with a null object. Verify that we don't get an error.
+     *
+     * @throws Exception
+     */
+    @Test
+    void testNullInput()
+        throws Exception
+    {
+        final String before = null;
+
+        // DO WORK
+        final byte[] serialized = serializer.serialize( before );
+        //System.out.println( "testNullInput " + serialized );
+
+        final String after = serializer.deSerialize( serialized, null );
+        //System.out.println( "testNullInput " + after );
+
+        // VERIFY
+        assertNull( after, "Should have nothing." );
+    }
+
+    /**
+     * Test simple back and forth with a string.
+     *
+     * @throws Exception
+     */
+    @Test
+    void testSimpleBackAndForth()
+        throws Exception
+    {
+        final String before = "adsfdsafdsafdsafdsafdsafdsafdsagfdsafdsafdsfdsafdsafsa333 31231";
+
+        // DO WORK
+        byte[] serialized = serializer.serialize(before);
+        System.out.println(new String(serialized, StandardCharsets.UTF_8));
+        final String after = serializer.deSerialize(serialized, null);
+
+        // VERIFY
+        assertEquals( before, after, "Before and after should be the same." );
+    }
+}
diff --git a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
index a16e25b3..a3e87d80 100644
--- a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
+++ b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
@@ -23,8 +23,8 @@ import static org.junit.jupiter.api.Assertions.assertNotNull;
 
 import org.apache.commons.jcs3.JCS;
 import org.apache.commons.jcs3.access.CacheAccess;
-import org.junit.jupiter.api.AfterEach;
-import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.BeforeAll;
 import org.junit.jupiter.api.Test;
 
 /**
@@ -37,68 +37,96 @@ class SerializerUnitTest
      *
      * @throws Exception
      */
-    @BeforeEach
-    void setUp()
+    @BeforeAll
+    public static void setUp()
         throws Exception
     {
         JCS.setConfigFilename( "/TestElementSerializer.ccf" );
     }
 
-    @AfterEach
-    void tearDown()
+    @AfterAll
+    public static void tearDown()
         throws Exception
     {
         JCS.shutdown();
     }
 
     /**
-     * Verify that object reading and writing works
+     * Verify that object reading and writing with CompressingSerializer works
      *
      * @throws Exception
      */
     @Test
-    void testReadWrite()
+    public void testReadWriteCompressingSerializer()
         throws Exception
     {
-        final int count = 500; // 100 fit in memory
         // CompressingSerializer
-        final CacheAccess<String, String> jcs1 = JCS.getInstance( "blockRegion1" );
+        final CacheAccess<String, String> jcs = JCS.getInstance( "blockRegion1" );
 
-        for ( int i = 0; i < count; i++ )
-        {
-            jcs1.put( "key:" + i, "data" + i );
-        }
+        testReadWrite(jcs);
+    }
 
-        for ( int i = 0; i < count; i++ )
-        {
-            final String res = jcs1.get( "key:" + i );
-            assertNotNull( res, "[key:" + i + "] should not be null, " + jcs1.getStats() );
-        }
+    /**
+     * Verify that object reading and writing with EncryptingSerializer works
+     *
+     * @throws Exception
+     */
+    @Test
+    public void testReadWriteEncryptingSerializer()
+        throws Exception
+    {
+        // EncryptingSerializer
+        final CacheAccess<String, String> jcs1 = JCS.getInstance( "blockRegion2" );
+
+        testReadWrite(jcs1);
+
+        JCS.shutdown();
 
+        // Re-init
         // EncryptingSerializer
         final CacheAccess<String, String> jcs2 = JCS.getInstance( "blockRegion2" );
 
-        for ( int i = 0; i < count; i++ )
-        {
-            jcs2.put( "key:" + i, "data" + i );
-        }
-
-        for ( int i = 0; i < count; i++ )
+        for ( int i = 0; i < 500; i++ )
         {
             final String res = jcs2.get( "key:" + i );
             assertNotNull( res, "[key:" + i + "] should not be null, " + jcs2.getStats() );
         }
+    }
 
-        JCS.shutdown();
+    /**
+     * Verify that object reading and writing with JSONSerializer works
+     *
+     * @throws Exception
+     */
+    @Test
+    public void testReadWriteJSONSerializer()
+        throws Exception
+    {
+        // JSONSerializer
+        final CacheAccess<String, String> jcs = JCS.getInstance( "blockRegion3" );
 
-        // Re-init
-        // EncryptingSerializer
-        final CacheAccess<String, String> jcs3 = JCS.getInstance( "blockRegion2" );
+        testReadWrite(jcs);
+    }
+
+    /**
+     * Verify that object reading and writing works
+     *
+     * @throws Exception
+     */
+    private void testReadWrite(CacheAccess<String, String> jcs)
+        throws Exception
+    {
+        final int count = 500; // 100 fit in memory
+
+        for ( int i = 0; i < count; i++ )
+        {
+            jcs.put( "key:" + i, "data" + i );
+        }
 
         for ( int i = 0; i < count; i++ )
         {
-            final String res = jcs3.get( "key:" + i );
-            assertNotNull( res, "[key:" + i + "] should not be null, " + jcs3.getStats() );
+            final String res = jcs.get( "key:" + i );
+            assertNotNull( res, "[key:" + i + "] should not be null, " + jcs.getStats() );
         }
     }
 }
diff --git a/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf b/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
index 6831c89f..562f80a8 100644
--- a/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
+++ b/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
@@ -41,6 +41,11 @@ jcs.region.blockRegion2.cacheattributes=org.apache.commons.jcs3.engine.Composite
 jcs.region.blockRegion2.cacheattributes.MaxObjects=100
 jcs.region.blockRegion2.cacheattributes.MemoryCacheName=org.apache.commons.jcs3.engine.memory.lru.LRUMemoryCache
 
+jcs.region.blockRegion3=blockDiskCache3
+jcs.region.blockRegion3.cacheattributes=org.apache.commons.jcs3.engine.CompositeCacheAttributes
+jcs.region.blockRegion3.cacheattributes.MaxObjects=100
+jcs.region.blockRegion3.cacheattributes.MemoryCacheName=org.apache.commons.jcs3.engine.memory.lru.LRUMemoryCache
+
 # #### AUXILIARY CACHES
 
 # Block Disk Cache
@@ -59,6 +64,13 @@ jcs.auxiliary.blockDiskCache2.serializer=org.apache.commons.jcs3.utils.serializa
 jcs.auxiliary.blockDiskCache2.serializer.attributes.preSharedKey=my_secret
 jcs.auxiliary.blockDiskCache2.serializer.attributes.aesCipherTransformation=AES/GCM/NoPadding
 
+# Block Disk Cache
+jcs.auxiliary.blockDiskCache3=org.apache.commons.jcs3.auxiliary.disk.block.BlockDiskCacheFactory
+jcs.auxiliary.blockDiskCache3.attributes=org.apache.commons.jcs3.auxiliary.disk.block.BlockDiskCacheAttributes
+jcs.auxiliary.blockDiskCache3.attributes.DiskPath=target/test-sandbox/block-disk-cache3
+jcs.auxiliary.blockDiskCache3.attributes.EventQueueType=POOLED
+jcs.auxiliary.blockDiskCache3.serializer=org.apache.commons.jcs3.utils.serialization.JSONSerializer
+
 # Default Cache Event Queue thread pool config, used by auxiliaries
 thread_pool.cache_event_queue.useBoundary=false
 #thread_pool.cache_event_queue.boundarySize=2000
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 4b243dc3..27c2a120 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -37,6 +37,9 @@
             <action dev="tv" type="add">
                Add module-info.java for JCS core
             </action>
+            <action dev="tv" type="add">
+               Add optional JSON serializer/deserializer based on Jackson
+            </action>
             <!-- REMOVE -->
             <action dev="tv" type="remove">
                Remove all deprecated code.


Re: (commons-jcs) branch master updated: Add optional JSON serializer/deserializer based on Jackson

Posted by Gary Gregory <ga...@gmail.com>.
This breaks the build.

Why not let Moditect handle the JPMS noise?

Gary

On Fri, Jan 30, 2026, 11:17 <tv...@apache.org> wrote:

> This is an automated email from the ASF dual-hosted git repository.
>
> tv pushed a commit to branch master
> in repository https://gitbox.apache.org/repos/asf/commons-jcs.git
>
>
> The following commit(s) were added to refs/heads/master by this push:
>      new 29d49bf4 Add optional JSON serializer/deserializer based on
> Jackson
> 29d49bf4 is described below
>
> commit 29d49bf48e6d8937e7c1c0677886965dd79e10fb
> Author: Thomas Vandahl <tv...@apache.org>
> AuthorDate: Fri Jan 30 17:16:54 2026 +0100
>
>     Add optional JSON serializer/deserializer based on Jackson
> ---
>  commons-jcs3-core/pom.xml                          |   7 +
>  commons-jcs3-core/src/main/java/module-info.java   |  13 +-
>  .../jcs3/utils/serialization/JSONSerializer.java   |  99 ++++++++++++++
>  .../serialization/JSONSerializerUnitTest.java      | 143
> +++++++++++++++++++++
>  .../utils/serialization/SerializerUnitTest.java    |  90 ++++++++-----
>  .../src/test/test-conf/TestElementSerializer.ccf   |  12 ++
>  src/changes/changes.xml                            |   3 +
>  7 files changed, 332 insertions(+), 35 deletions(-)
>
> diff --git a/commons-jcs3-core/pom.xml b/commons-jcs3-core/pom.xml
> index c0376525..9dac65c8 100644
> --- a/commons-jcs3-core/pom.xml
> +++ b/commons-jcs3-core/pom.xml
> @@ -103,6 +103,13 @@
>        <artifactId>jakarta.servlet-api</artifactId>
>        <optional>true</optional>
>      </dependency>
> +
> +    <dependency>
> +      <groupId>com.fasterxml.jackson.core</groupId>
> +      <artifactId>jackson-databind</artifactId>
> +      <version>2.20.1</version>
> +      <optional>true</optional>
> +    </dependency>
>    </dependencies>
>
>    <build>
> diff --git a/commons-jcs3-core/src/main/java/module-info.java
> b/commons-jcs3-core/src/main/java/module-info.java
> index aed49d22..5d9a95b1 100644
> --- a/commons-jcs3-core/src/main/java/module-info.java
> +++ b/commons-jcs3-core/src/main/java/module-info.java
> @@ -93,14 +93,14 @@ module org.apache.commons.jcs3.core {
>
>      // Java platform modules - required
>      requires java.base;
> -    requires java.rmi;
> -    requires java.sql;
>      requires java.management;
> -    requires java.naming;
>      requires java.desktop;
> +    requires transitive java.rmi;
> +    requires transitive java.sql;
> +    requires transitive java.naming;
>
>      // Optional dependencies for remote HTTP caching
> -    requires static jakarta.servlet;
> +    requires transitive jakarta.servlet;
>
>      // Optional dependencies for JDBC disk cache
>      requires static org.apache.commons.dbcp2;
> @@ -109,6 +109,11 @@ module org.apache.commons.jcs3.core {
>      requires static org.apache.httpcomponents.httpclient;
>      requires static org.apache.httpcomponents.httpcore;
>
> +    // Optional dependencies for remote HTTP caching
> +    requires static com.fasterxml.jackson.databind;
> +    opens org.apache.commons.jcs3.utils.serialization to
> com.fasterxml.jackson.databind;
> +    opens org.apache.commons.jcs3.engine to
> com.fasterxml.jackson.databind;
> +
>      // Uses and provides clauses
>      uses org.apache.commons.jcs3.auxiliary.AuxiliaryCacheFactory;
>  }
> diff --git
> a/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java
> b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java
> new file mode 100644
> index 00000000..b563d060
> --- /dev/null
> +++
> b/commons-jcs3-core/src/main/java/org/apache/commons/jcs3/utils/serialization/JSONSerializer.java
> @@ -0,0 +1,99 @@
> +package org.apache.commons.jcs3.utils.serialization;
> +
> +/*
> + * Licensed to the Apache Software Foundation (ASF) under one
> + * or more contributor license agreements.  See the NOTICE file
> + * distributed with this work for additional information
> + * regarding copyright ownership.  The ASF licenses this file
> + * to you under the Apache License, Version 2.0 (the
> + * "License"); you may not use this file except in compliance
> + * with the License.  You may obtain a copy of the License at
> + *
> + *   http://www.apache.org/licenses/LICENSE-2.0
> + *
> + * Unless required by applicable law or agreed to in writing,
> + * software distributed under the License is distributed on an
> + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
> + * KIND, either express or implied.  See the License for the
> + * specific language governing permissions and limitations
> + * under the License.
> + */
> +
> +import java.io.IOException;
> +
> +import org.apache.commons.jcs3.engine.behavior.IElementSerializer;
> +
> +import com.fasterxml.jackson.core.exc.StreamReadException;
> +import com.fasterxml.jackson.databind.DatabindException;
> +import com.fasterxml.jackson.databind.JsonNode;
> +import com.fasterxml.jackson.databind.ObjectMapper;
> +import com.fasterxml.jackson.databind.json.JsonMapper;
> +
> +/**
> + * Performs JSON serialization and de-serialization.
> + */
> +public class JSONSerializer
> +    implements IElementSerializer
> +{
> +    /** Jackson JSON mapper instance */
> +    private static final ObjectMapper mapper =
> JsonMapper.builder().build();
> +
> +    /** Wrapper to save the class name information */
> +    private record Wrapper<T>(String className, T element) {}
> +
> +    /**
> +     * Uses JSON de-serialization to turn a byte array into an object.
> All exceptions are
> +     * converted into IOExceptions.
> +     *
> +     * @param data data bytes
> +     * @param loader class loader to use
> +     * @return Object
> +     * @throws IOException
> +     * @throws ClassNotFoundException
> +     */
> +    @Override
> +    public <T> T deSerialize(final byte[] data, final ClassLoader loader)
> +        throws IOException, ClassNotFoundException
> +    {
> +        if (data == null || data.length == 0)
> +        {
> +            return null;
> +        }
> +
> +        try
> +        {
> +            JsonNode root = mapper.readTree(data);
> +            String className = root.at("/className").asText();
> +
> +            @SuppressWarnings("unchecked") // Need to cast from Object
> +            Class<T> clazz = (Class<T>)Class.forName(className, false,
> +                    loader == null ? this.getClass().getClassLoader() :
> loader);
> +
> +            return mapper.treeToValue(root.at("/element"), clazz);
> +        }
> +        catch (StreamReadException | DatabindException e)
> +        {
> +            throw new IOException("Error deserializing JSON", e);
> +        }
> +    }
> +
> +    /**
> +     * Serializes an object using JSON serialization.
> +     *
> +     * @param obj
> +     * @return byte[]
> +     * @throws IOException
> +     */
> +    @Override
> +    public <T> byte[] serialize(final T obj)
> +        throws IOException
> +    {
> +        if (obj == null)
> +        {
> +            return null;
> +        }
> +
> +        Wrapper<T> wrapper = new Wrapper<T>(obj.getClass().getName(),
> obj);
> +        return mapper.writeValueAsBytes(wrapper);
> +    }
> +}
> diff --git
> a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java
> b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java
> new file mode 100644
> index 00000000..c786598a
> --- /dev/null
> +++
> b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/JSONSerializerUnitTest.java
> @@ -0,0 +1,143 @@
> +package org.apache.commons.jcs3.utils.serialization;
> +
> +/*
> + * Licensed to the Apache Software Foundation (ASF) under one
> + * or more contributor license agreements.  See the NOTICE file
> + * distributed with this work for additional information
> + * regarding copyright ownership.  The ASF licenses this file
> + * to you under the Apache License, Version 2.0 (the
> + * "License"); you may not use this file except in compliance
> + * with the License.  You may obtain a copy of the License at
> + *
> + *   https://www.apache.org/licenses/LICENSE-2.0
> + *
> + * Unless required by applicable law or agreed to in writing,
> + * software distributed under the License is distributed on an
> + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
> + * KIND, either express or implied.  See the License for the
> + * specific language governing permissions and limitations
> + * under the License.
> + */
> +
> +import static org.junit.jupiter.api.Assertions.assertEquals;
> +import static org.junit.jupiter.api.Assertions.assertNull;
> +
> +import java.nio.charset.StandardCharsets;
> +import java.util.Calendar;
> +import java.util.Date;
> +import java.util.GregorianCalendar;
> +
> +import org.junit.jupiter.api.BeforeEach;
> +import org.junit.jupiter.api.Test;
> +
> +/**
> + * Tests the JSON serializer.
> + */
> +class JSONSerializerUnitTest
> +{
> +    private JSONSerializer serializer;
> +
> +    /**
> +     * Test setup
> +     *
> +     * @throws Exception
> +     */
> +    @BeforeEach
> +    void setUp()
> +        throws Exception
> +    {
> +        this.serializer = new JSONSerializer();
> +    }
> +
> +    public static record Person(String name, int age, Date birthdate) {}
> +
> +    /**
> +     * Test simple back and forth with an object.
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    void testObjectBackAndForth()
> +        throws Exception
> +    {
> +        Date date = new GregorianCalendar(1977, Calendar.DECEMBER,
> 15).getTime();
> +        final Person before = new Person("joe", 21, date);
> +
> +        // DO WORK
> +        byte[] serialized = serializer.serialize(before);
> +        System.out.println(new String(serialized,
> StandardCharsets.UTF_8));
> +        final Person after = serializer.deSerialize(serialized, null);
> +
> +        // VERIFY
> +        assertEquals(before.name(), after.name(), "Before and after
> should be the same.");
> +        assertEquals(before.age(), after.age(), "Before and after should
> be the same.");
> +        assertEquals(before.birthdate(), after.birthdate(), "Before and
> after should be the same.");
> +    }
> +
> +    /**
> +     * Test simple back and forth with a string.
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    void testBigStringBackAndForth()
> +        throws Exception
> +    {
> +        final String string = "This is my big string ABCDEFGH";
> +        final StringBuilder sb = new StringBuilder();
> +        sb.append( string );
> +        for ( int i = 0; i < 4; i++ )
> +        {
> +            sb.append( " " + i + sb.toString() ); // big string
> +        }
> +        final String before = sb.toString();
> +
> +        // DO WORK
> +        final String after = (String) serializer.deSerialize(
> serializer.serialize( before ), null );
> +
> +        // VERIFY
> +        assertEquals( before, after, "Before and after should be the
> same." );
> +    }
> +
> +    /**
> +     * Test serialization with a null object. Verify that we don't get an
> error.
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    void testNullInput()
> +        throws Exception
> +    {
> +        final String before = null;
> +
> +        // DO WORK
> +        final byte[] serialized = serializer.serialize( before );
> +        //System.out.println( "testNullInput " + serialized );
> +
> +        final String after = serializer.deSerialize( serialized, null );
> +        //System.out.println( "testNullInput " + after );
> +
> +        // VERIFY
> +        assertNull( after, "Should have nothing." );
> +    }
> +
> +    /**
> +     * Test simple back and forth with a string.
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    void testSimpleBackAndForth()
> +        throws Exception
> +    {
> +        final String before =
> "adsfdsafdsafdsafdsafdsafdsafdsagfdsafdsafdsfdsafdsafsa333 31231";
> +
> +        // DO WORK
> +        byte[] serialized = serializer.serialize(before);
> +        System.out.println(new String(serialized,
> StandardCharsets.UTF_8));
> +        final String after = serializer.deSerialize(serialized, null);
> +
> +        // VERIFY
> +        assertEquals( before, after, "Before and after should be the
> same." );
> +    }
> +}
> diff --git
> a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
> b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
> index a16e25b3..a3e87d80 100644
> ---
> a/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
> +++
> b/commons-jcs3-core/src/test/java/org/apache/commons/jcs3/utils/serialization/SerializerUnitTest.java
> @@ -23,8 +23,8 @@ import static
> org.junit.jupiter.api.Assertions.assertNotNull;
>
>  import org.apache.commons.jcs3.JCS;
>  import org.apache.commons.jcs3.access.CacheAccess;
> -import org.junit.jupiter.api.AfterEach;
> -import org.junit.jupiter.api.BeforeEach;
> +import org.junit.jupiter.api.AfterAll;
> +import org.junit.jupiter.api.BeforeAll;
>  import org.junit.jupiter.api.Test;
>
>  /**
> @@ -37,68 +37,96 @@ class SerializerUnitTest
>       *
>       * @throws Exception
>       */
> -    @BeforeEach
> -    void setUp()
> +    @BeforeAll
> +    public static void setUp()
>          throws Exception
>      {
>          JCS.setConfigFilename( "/TestElementSerializer.ccf" );
>      }
>
> -    @AfterEach
> -    void tearDown()
> +    @AfterAll
> +    public static void tearDown()
>          throws Exception
>      {
>          JCS.shutdown();
>      }
>
>      /**
> -     * Verify that object reading and writing works
> +     * Verify that object reading and writing with CompressingSerializer
> works
>       *
>       * @throws Exception
>       */
>      @Test
> -    void testReadWrite()
> +    public void testReadWriteCompressingSerializer()
>          throws Exception
>      {
> -        final int count = 500; // 100 fit in memory
>          // CompressingSerializer
> -        final CacheAccess<String, String> jcs1 = JCS.getInstance(
> "blockRegion1" );
> +        final CacheAccess<String, String> jcs = JCS.getInstance(
> "blockRegion1" );
>
> -        for ( int i = 0; i < count; i++ )
> -        {
> -            jcs1.put( "key:" + i, "data" + i );
> -        }
> +        testReadWrite(jcs);
> +    }
>
> -        for ( int i = 0; i < count; i++ )
> -        {
> -            final String res = jcs1.get( "key:" + i );
> -            assertNotNull( res, "[key:" + i + "] should not be null, " +
> jcs1.getStats() );
> -        }
> +    /**
> +     * Verify that object reading and writing with EncryptingSerializer
> works
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    public void testReadWriteEncryptingSerializer()
> +        throws Exception
> +    {
> +        // EncryptingSerializer
> +        final CacheAccess<String, String> jcs1 = JCS.getInstance(
> "blockRegion2" );
> +
> +        testReadWrite(jcs1);
> +
> +        JCS.shutdown();
>
> +        // Re-init
>          // EncryptingSerializer
>          final CacheAccess<String, String> jcs2 = JCS.getInstance(
> "blockRegion2" );
>
> -        for ( int i = 0; i < count; i++ )
> -        {
> -            jcs2.put( "key:" + i, "data" + i );
> -        }
> -
> -        for ( int i = 0; i < count; i++ )
> +        for ( int i = 0; i < 500; i++ )
>          {
>              final String res = jcs2.get( "key:" + i );
>              assertNotNull( res, "[key:" + i + "] should not be null, " +
> jcs2.getStats() );
>          }
> +    }
>
> -        JCS.shutdown();
> +    /**
> +     * Verify that object reading and writing with JSONSerializer works
> +     *
> +     * @throws Exception
> +     */
> +    @Test
> +    public void testReadWriteJSONSerializer()
> +        throws Exception
> +    {
> +        // JSONSerializer
> +        final CacheAccess<String, String> jcs = JCS.getInstance(
> "blockRegion3" );
>
> -        // Re-init
> -        // EncryptingSerializer
> -        final CacheAccess<String, String> jcs3 = JCS.getInstance(
> "blockRegion2" );
> +        testReadWrite(jcs);
> +    }
> +
> +    /**
> +     * Verify that object reading and writing works
> +     *
> +     * @throws Exception
> +     */
> +    private void testReadWrite(CacheAccess<String, String> jcs)
> +        throws Exception
> +    {
> +        final int count = 500; // 100 fit in memory
> +
> +        for ( int i = 0; i < count; i++ )
> +        {
> +            jcs.put( "key:" + i, "data" + i );
> +        }
>
>          for ( int i = 0; i < count; i++ )
>          {
> -            final String res = jcs3.get( "key:" + i );
> -            assertNotNull( res, "[key:" + i + "] should not be null, " +
> jcs3.getStats() );
> +            final String res = jcs.get( "key:" + i );
> +            assertNotNull( res, "[key:" + i + "] should not be null, " +
> jcs.getStats() );
>          }
>      }
>  }
> diff --git
> a/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
> b/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
> index 6831c89f..562f80a8 100644
> --- a/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
> +++ b/commons-jcs3-core/src/test/test-conf/TestElementSerializer.ccf
> @@ -41,6 +41,11 @@
> jcs.region.blockRegion2.cacheattributes=org.apache.commons.jcs3.engine.Composite
>  jcs.region.blockRegion2.cacheattributes.MaxObjects=100
>
>  jcs.region.blockRegion2.cacheattributes.MemoryCacheName=org.apache.commons.jcs3.engine.memory.lru.LRUMemoryCache
>
> +jcs.region.blockRegion3=blockDiskCache3
>
> +jcs.region.blockRegion3.cacheattributes=org.apache.commons.jcs3.engine.CompositeCacheAttributes
> +jcs.region.blockRegion3.cacheattributes.MaxObjects=100
>
> +jcs.region.blockRegion3.cacheattributes.MemoryCacheName=org.apache.commons.jcs3.engine.memory.lru.LRUMemoryCache
> +
>  # #### AUXILIARY CACHES
>
>  # Block Disk Cache
> @@ -59,6 +64,13 @@
> jcs.auxiliary.blockDiskCache2.serializer=org.apache.commons.jcs3.utils.serializa
>  jcs.auxiliary.blockDiskCache2.serializer.attributes.preSharedKey=my_secret
>
>  jcs.auxiliary.blockDiskCache2.serializer.attributes.aesCipherTransformation=AES/GCM/NoPadding
>
> +# Block Disk Cache
>
> +jcs.auxiliary.blockDiskCache3=org.apache.commons.jcs3.auxiliary.disk.block.BlockDiskCacheFactory
>
> +jcs.auxiliary.blockDiskCache3.attributes=org.apache.commons.jcs3.auxiliary.disk.block.BlockDiskCacheAttributes
>
> +jcs.auxiliary.blockDiskCache3.attributes.DiskPath=target/test-sandbox/block-disk-cache3
> +jcs.auxiliary.blockDiskCache3.attributes.EventQueueType=POOLED
>
> +jcs.auxiliary.blockDiskCache3.serializer=org.apache.commons.jcs3.utils.serialization.JSONSerializer
> +
>  # Default Cache Event Queue thread pool config, used by auxiliaries
>  thread_pool.cache_event_queue.useBoundary=false
>  #thread_pool.cache_event_queue.boundarySize=2000
> diff --git a/src/changes/changes.xml b/src/changes/changes.xml
> index 4b243dc3..27c2a120 100644
> --- a/src/changes/changes.xml
> +++ b/src/changes/changes.xml
> @@ -37,6 +37,9 @@
>              <action dev="tv" type="add">
>                 Add module-info.java for JCS core
>              </action>
> +            <action dev="tv" type="add">
> +               Add optional JSON serializer/deserializer based on Jackson
> +            </action>
>              <!-- REMOVE -->
>              <action dev="tv" type="remove">
>                 Remove all deprecated code.
>
>