Added EncodeHTMl, EncodeJson, EncodeUrl and EncodeXml

.idea/misc.xml

@@ -7,6 +7,10 @@
     <pattern value="rife2.render.Trim" />
     <pattern value="rife2.render.Uncapitalize" />
     <pattern value="rife2.render.Uppercase" />
+    <pattern value="rife2.render.EncodeHtml" />
+    <pattern value="rife2.render.EncodeJson" />
+    <pattern value="rife2.render.EncodeUrl" />
+    <pattern value="rife2.render.EncodeXml" />
   </component>
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="PDMPlugin">

README.md

@@ -6,15 +6,23 @@
 This project provides a set of template renderers.
 
 - **rife.render.Capitalize**
-    - Capitalizes a template value.
+  - Capitalizes a template value.
+- **rife.render.EncodeHtml**
+  - Encodes a template value to HTML.
+- **rife.render.EncodeJson**
+  - Encodes a template value to JSON.
+- **rife.render.EncodeUrl**
+  - URL-encodes a template value.
+- **rife.render.EncodeXml**
+  - Encodes a template value to XML.
 - **rife.render.Lowercase**
-    - Converts a template value to lowercase.
+  - Converts a template value to lowercase.
 - **rife.render.SwapCase**
-    - Swap case of a template value.
+  - Swap case of a template value.
 - **rife.render.Trim**
-    - Removes leading and trailing whitespace from a template value.
+  - Removes leading and trailing whitespace from a template value.
 - **rife.render.Uncapitalize**
-    - Un-capitalizes a template value.
+  - Un-capitalizes a template value.
 - **rife.render.Uppercase**
   - Convert a template value to uppercase.
 
@@ -22,24 +30,24 @@ This project provides a set of template renderers.
 
 All rendered can be used at follows:
 
-```html
+```
 <!--v render:rife.render.RendererName:valueId/-->
 ```
 
 or
 
-```json
+```
 {{v render:rife.render.RendererName:valueId}}
 ```
 
 For example, to capitalize a template `foo` value:
 
-```html
+```
 <!--v render:rife.render.Capitalize:foo/-->
 ```
 
 or
 
-```json
+```
 {{v render:rife.render.Capitalize:foo}}
 ```

lib/build.gradle.kts

@@ -29,7 +29,7 @@ dependencies {
 
 configurations {
 	all {
-        resolutionStrategy.cacheChangingModulesFor(0, TimeUnit.SECONDS);
+        resolutionStrategy.cacheChangingModulesFor(0, TimeUnit.SECONDS)
     }
 }
 

lib/src/main/java/rife2/render/EncodeHtml.java

@@ -0,0 +1,50 @@
+/*
+ *  Copyright 2023 the original author or authors.
+ *
+ *  Licensed 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.
+ *
+ */
+
+package rife2.render;
+
+import rife.template.Template;
+import rife.template.ValueRenderer;
+import rife.tools.StringUtils;
+
+/**
+ * <p>Encodes a template value to HTML.</p>
+ *
+ * <p>Usage:</p>
+ *
+ * <pre>
+ *   &lt;!--v render:rife.render.EncodeHtml:valueId/--&gt;
+ *   {{v render:rife.render.EncodeHtml:valueId}}
+ * </pre>
+ *
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
+ * @see StringUtils#encodeHtml(String)
+ * @since 1.0
+ */
+public class EncodeHtml implements ValueRenderer {
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public String render(Template template, String valueId, String differentiator) {
+        if (differentiator != null && !differentiator.isBlank() && template.hasValueId(differentiator)) {
+            return StringUtils.encodeHtml(template.getValue(differentiator));
+        } else {
+            return "";
+        }
+    }
+}

lib/src/main/java/rife2/render/EncodeJson.java

@@ -0,0 +1,50 @@
+/*
+ *  Copyright 2023 the original author or authors.
+ *
+ *  Licensed 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.
+ *
+ */
+
+package rife2.render;
+
+import rife.template.Template;
+import rife.template.ValueRenderer;
+import rife.tools.StringUtils;
+
+/**
+ * <p>Encodes a template value to JSON.</p>
+ *
+ * <p>Usage:</p>
+ *
+ * <pre>
+ *   &lt;!--v render:rife.render.EncodeJson:valueId/--&gt;
+ *   {{v render:rife.render.EncodeJson:valueId}}
+ * </pre>
+ *
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
+ * @see StringUtils#encodeJson(String)
+ * @since 1.0
+ */
+public class EncodeJson implements ValueRenderer {
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public String render(Template template, String valueId, String differentiator) {
+        if (differentiator != null && !differentiator.isBlank() && template.hasValueId(differentiator)) {
+            return StringUtils.encodeJson(template.getValue(differentiator));
+        } else {
+            return "";
+        }
+    }
+}

lib/src/main/java/rife2/render/EncodeUrl.java

@@ -0,0 +1,50 @@
+/*
+ *  Copyright 2023 the original author or authors.
+ *
+ *  Licensed 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.
+ *
+ */
+
+package rife2.render;
+
+import rife.template.Template;
+import rife.template.ValueRenderer;
+import rife.tools.StringUtils;
+
+/**
+ * <p>URL-encodes a template value.</p>
+ *
+ * <p>Usage:</p>
+ *
+ * <pre>
+ *   &lt;!--v render:rife.render.EncodeUrl:valueId/--&gt;
+ *   {{v render:rife.render.EncodeUrl:valueId}}
+ * </pre>
+ *
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
+ * @see StringUtils#encodeUrl(String)
+ * @since 1.0
+ */
+public class EncodeUrl implements ValueRenderer {
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public String render(Template template, String valueId, String differentiator) {
+        if (differentiator != null && !differentiator.isBlank() && template.hasValueId(differentiator)) {
+            return StringUtils.encodeUrl(template.getValue(differentiator));
+        } else {
+            return "";
+        }
+    }
+}

lib/src/main/java/rife2/render/EncodeXml.java

@@ -0,0 +1,50 @@
+/*
+ *  Copyright 2023 the original author or authors.
+ *
+ *  Licensed 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.
+ *
+ */
+
+package rife2.render;
+
+import rife.template.Template;
+import rife.template.ValueRenderer;
+import rife.tools.StringUtils;
+
+/**
+ * <p>Encodes a template value to XML.</p>
+ *
+ * <p>Usage:</p>
+ *
+ * <pre>
+ *   &lt;!--v render:rife.render.EncodeXml:valueId/--&gt;
+ *   {{v render:rife.render.EncodeXml:valueId}}
+ * </pre>
+ *
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
+ * @see StringUtils#encodeXml(String)
+ * @since 1.0
+ */
+public class EncodeXml implements ValueRenderer {
+    /**
+     * {@inheritDoc}
+     */
+    @Override
+    public String render(Template template, String valueId, String differentiator) {
+        if (differentiator != null && !differentiator.isBlank() && template.hasValueId(differentiator)) {
+            return StringUtils.encodeXml(template.getValue(differentiator));
+        } else {
+            return "";
+        }
+    }
+}