Class HtmlFlow

htmlflow-core/src/main/java/htmlflow/HtmlFlow.java:40–529

Factory to create HtmlDoc or HtmlView instances corresponding to static HTMl pages or dynamic pages. HtmlView objects depend on a model.

 * pages. HtmlView objects depend on a model.
 */
public class HtmlFlow {

    /** Make private constructor to forbid instantiation. */
    private HtmlFlow() {}

    /**
     * This will invoke the HtmlTemplate to a PreprocessingVisitor that collects a chain of
     * HtmlContinuation objects containing the static HTML strings and dynamic HTML consumers.
     *
     * @param template An HtmlTemplate function, which depends on an HtmlView used to create HTMl
     *     elements.
     * @param isIndented Set indentation on or off.
     */
    private static PreprocessingVisitor preprocessing(
        HtmlTemplate template,
        boolean isIndented
    ) {
        PreprocessingVisitor pre = new PreprocessingVisitor(isIndented);
        HtmlView<?> preView = new HtmlView<>(() -> pre, template, false);
        /*
         * 1st Performs rendering by invoking the function defined as the template, collecting the
         * resulting static HTML into an internal StringBuffer.
         */
        template.resolve(preView);
        /*
         * NO problem with null model. We are just preprocessing static HTML blocks.
         * Thus, dynamic blocks which depend on model are not invoked.
         * 2nd Simply invokes resolve in PreprocessingVisitor, which creates only
         * the final HtmlContinuationSyncStatic containing the remaining static HTML
         * accumulated in the internal StringBuffer out.
         */
        preView.getVisitor().resolve(null);
        return pre;
    }

    /**
     * Performs preprocessing for Micro Frontend (MFE) views. Creates a specialized visitor that collects
     * MFE configurations and processes them to enable MFE support in the view.
     *
     * @param template An HtmlTemplate function that defines the HTML structure with MFE components
     * @return A PreprocessingVisitorMfe containing the processed MFE components
     */
    private static PreprocessingVisitorMfe preprocessingMfe(
        HtmlTemplate template
    ) {
        PreprocessingVisitorMfe processView = new PreprocessingVisitorMfe(
            false
        );
        HtmlView<?> preView = new HtmlView<>(
            () -> processView,
            template,
            false
        );
        // first process
        template.resolve(preView);
        // second process
        preView.getVisitor().resolve(null);
        return processView;