Updated parent version, site model and README

robtimus · robtimus · commit e033508ca928 · 2025-05-11T16:38:48.000+02:00
diff --git a/README.md b/README.md
@@ -9,25 +9,29 @@ Provides functionality for obfuscating JSON documents. This can be useful for lo
 
 To create a JSON obfuscator, simply create a builder, add properties to it, and let it build the final obfuscator:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .withProperty("password", Obfuscator.fixedLength(3))
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .withProperty("password", Obfuscator.fixedLength(3))
+        .build();
+```
 
 ## Obfuscation for objects and/or arrays
 
 By default, a JSON obfuscator will obfuscate all properties; for object and array properties, their contents in the document including opening and closing characters will be obfuscated. This can be turned on or off for all properties, or per property. For example:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .scalarsOnlyByDefault()
-            // .scalarsOnlyByDefault() is equivalent to:
-            // .forObjectsByDefault(ObfuscationMode.EXCLUDE)
-            // .forArraysByDefault(ObfuscationMode.EXCLUDE)
-            .withProperty("password", Obfuscator.fixedLength(3))
-            .withProperty("complex", Obfuscator.fixedLength(3))
-                    .forObjects(ObfuscationMode.OBFUSCATE) // override the default setting
-            .withProperty("arrayOfComplex", Obfuscator.fixedLength(3))
-                    .forArrays(ObfuscationMode.INHERIT_OVERRIDABLE) // override the default setting
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .scalarsOnlyByDefault()
+        // .scalarsOnlyByDefault() is equivalent to:
+        // .forObjectsByDefault(ObfuscationMode.EXCLUDE)
+        // .forArraysByDefault(ObfuscationMode.EXCLUDE)
+        .withProperty("password", Obfuscator.fixedLength(3))
+        .withProperty("complex", Obfuscator.fixedLength(3))
+                .forObjects(ObfuscationMode.OBFUSCATE) // override the default setting
+        .withProperty("arrayOfComplex", Obfuscator.fixedLength(3))
+                .forArrays(ObfuscationMode.INHERIT_OVERRIDABLE) // override the default setting
+        .build();
+```
 
 The four possible modes for both objects and arrays are:
 * `EXCLUDE`: don't obfuscate nested objects or arrays, but instead traverse into them.
@@ -39,77 +43,93 @@ The four possible modes for both objects and arrays are:
 
 JSON obfuscators perform obfuscating by generating new, obfuscated JSON documents. By default this will use pretty-printing. This can be turned off when creating JSON obfuscators:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .withProperty("password", Obfuscator.fixedLength(3))
-            .withPrettyPrinting(false)
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .withProperty("password", Obfuscator.fixedLength(3))
+        .withPrettyPrinting(false)
+        .build();
+```
 
 If the structure of the original JSON document needs to be kept intact, you should use [obfuscation-jackson](https://robtimus.github.io/obfuscation-jackson/) instead.
 
 ## Producing valid JSON
 
 If string values are obfuscated, the obfuscated value remains quoted. For other values, the obfuscated values are not quoted. This could lead to invalid JSON. For instance:
 
-    {
-      "boolean": ***
-    }
+```json
+{
+  "boolean": ***
+}
+```
 
 For most use cases this is not an issue. If the obfuscated JSON needs to be valid, this can be achieved by converting obfuscated values to strings:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .withProperty("boolean", Obfuscator.fixedLength(3))
-            .produceValidJSON()
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .withProperty("boolean", Obfuscator.fixedLength(3))
+        .produceValidJSON()
+        .build();
+```
 
 This will turn the above result into this:
 
-    {
-        "boolean": "***"
-    }
+```json
+{
+    "boolean": "***"
+}
+```
 
 An exception is made for [Obfuscator.none()](https://robtimus.github.io/obfuscation-core/apidocs/com/github/robtimus/obfuscation/Obfuscator.html#none--). Since this obfuscator does not actually obfuscate anything, any property that is configured to use it will be added as-is. This still allows skipping obfuscating values inside certain properties:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .withProperty("object", Obfuscator.none())
-            .withProperty("boolean", Obfuscator.fixedLength(3))
-            .produceValidJSON()
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .withProperty("object", Obfuscator.none())
+        .withProperty("boolean", Obfuscator.fixedLength(3))
+        .produceValidJSON()
+        .build();
+```
 
 Possible output:
 
-    {
-        "boolean": "***",
-        "object": {
-            "boolean": true
-        }
+```json
+{
+    "boolean": "***",
+    "object": {
+        "boolean": true
     }
+}
+```
 
 ## Handling malformed JSON
 
 If malformed JSON is encountered, obfuscation aborts. It will add a message to the result indicating that obfuscation was aborted. This message can be changed or turned off when creating JSON obfuscators:
 
-    Obfuscator obfuscator = JSONObfuscator.builder()
-            .withProperty("password", Obfuscator.fixedLength(3))
-            // use null to turn it off
-            .withMalformedJSONWarning("<invalid JSON>")
-            .build();
+```java
+Obfuscator obfuscator = JSONObfuscator.builder()
+        .withProperty("password", Obfuscator.fixedLength(3))
+        // use null to turn it off
+        .withMalformedJSONWarning("<invalid JSON>")
+        .build();
+```
 
 ## Changing JSON implementation
 
 This library uses the Java API for Processing JSON ([JSR 374](https://www.jcp.org/en/jsr/detail?id=374)) for parsing and generating JSON. By default it uses the Glassfish reference implementation. If you want to use a different implementation instead, you should exclude the Glassfish dependency, and add a dependency for that different implementation. In your POM:
 
-    <dependency>
-      <groupId>com.github.robtimus</groupId>
-      <artifactId>obfuscation-json</artifactId>
-      <version>...</version>
-      <exclusions>
-        <exclusion>
-          <groupId>org.glassfish</groupId>
-          <artifactId>javax.json</artifactId>
-        </exclusion>
-      </exclusions>
-     </dependency>
-    
-    <dependency>
-        ...
-    </dependency>
+```xml
+<dependency>
+  <groupId>com.github.robtimus</groupId>
+  <artifactId>obfuscation-json</artifactId>
+  <version>...</version>
+  <exclusions>
+    <exclusion>
+      <groupId>org.glassfish</groupId>
+      <artifactId>javax.json</artifactId>
+    </exclusion>
+  </exclusions>
+</dependency>
+
+<dependency>
+  ...
+</dependency>
+```
diff --git a/pom.xml b/pom.xml
@@ -22,7 +22,7 @@
   <parent>
     <groupId>com.github.robtimus</groupId>
     <artifactId>robtimus-parent</artifactId>
-    <version>1.14</version>
+    <version>1.15</version>
     <relativePath />
   </parent>
 
diff --git a/src/site/site.xml b/src/site/site.xml
@@ -15,9 +15,11 @@
   limitations under the License.
 -->
 
-<project name="obfuscation-json"
-  xmlns="http://maven.apache.org/DECORATION/1.8.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.8.0 https://maven.apache.org/xsd/decoration-1.8.0.xsd">
+<site name="obfuscation-json"
+  xmlns="http://maven.apache.org/SITE/2.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/SITE/2.0.0 https://maven.apache.org/xsd/site-2.0.0.xsd">
+
+  <bannerLeft name="obfuscation-json" />
 
   <body>
     <menu name="obfuscation-json">
@@ -27,4 +29,4 @@
       <item name="Javadoc" href="apidocs/index.html" />
     </menu>
   </body>
-</project>
+</site>
