Parameter Forest

Published: 28 April 2025

Known Uses

    Widely used, the Parameter Forest pattern consists of multiple Parameter Trees. A Parameter Tree has a single dedicated root node, while a Parameter Forest has multiple root nodes.

    Examples:

    • GET /customers/abc123 – returns a tree (a single root with structured data)
    • GET /customers/ – returns a forest (multiple trees, each representing a customer)

    Discussion Input

    As noted in the book (p. 157), introducing an artificial root node can transform a forest into a tree. This raises the question: what is the added value of identifying the Parameter Tree as a distinct pattern?

    Furthermore, one might argue that recursive Parameter Trees and atomic Parameters are sufficient to describe complex data structures — meaning only two patterns instead of four, would be needed.

    However, explicitly identifying all four patterns as fundamental building blocks enhances design awareness, as these patterns are frequently used in practice (even unconsciously :-).

    Read the complete pattern on api-patterns.org

    Leave a Reply

    Your email address will not be published. Required fields are marked *

    Scroll to Top