TemplateSection.java

package com.renomad.minum.templating;

import java.util.List;

import java.util.Map;

import static com.renomad.minum.utils.Invariants.mustBeTrue;

import static com.renomad.minum.utils.SerializationUtils.tokenizer;

/**

 * Represents one item in the list that will eventually be cooked

 * up into a fully-rendered string.  This record is the magic

 * ingredient to an easy templating system. If it has a key,

 * then this object will be getting replaced during final string rendering.  If it has a substring,

 * then the substring gets concatenated unchanged when the final string

 * is rendered.

 */

class TemplateSection {

    final String key;

    private final String subString;

    private final int indent;

    private RenderingResult result;

    /**

     * @param indent the column number, measured from the left, of the first character of this template key.  This is used

     *               to indent the subsequent lines of text when there are newlines in the replacement

     *               text. For example, if the indent is 5, and the value is "a", then it should indent like this:

     *               <br>

     *               <pre>{@code

     *               12345

     *                   a

     *               }</pre>

     * @param key the name of the key, e.g. "name", or "color"

     * @param subString the template content around the keys.  For example, in the text

     *                  of "my favorite color is {{ color }} and I like it",

     *                  it would generate three template sections - "my favorite color is" would be

     *                  the first subString, then a key of "color", then a third subString of "and I like it"

     */

    /**

     * It would be absurd to send a million lines to a browser, much

     * less ten million.  This is here to set an upper limit on

     * the tokenizer loop, to prevent certain attacks.

     */

    static final int MAXIMUM_LINES_ALLOWED = 10_000_000;

    public RenderingResult render(Map<String, String> myMap) {

            }

        } else {

            // if, after splitting on newlines, we have more than one line, we'll indent the remaining

            // lines so that they end up at the same column as the first line.

                } else {

                }

            }

        }

    }

}

Mutations