Architecture:MediaWiki/output aggregator pattern

MediaWiki Architecture
Structure
Technical layers Domain modules Pattern language Subsystems Flows Practices
Pattern language
entry point pattern wiring pattern (including hook handlers) view pattern cursor pattern (iterators, etc) batch pattern pager pattern input form pattern service object pattern stateless service pattern service container pattern data access object pattern lookup pattern factory pattern registry pattern handler pattern content handler pattern API module pattern action pattern special page pattern media handler pattern page pattern (page types?) provider pattern (vague, could be a factory) codec pattern (serializer/deserializer) command pattern (aka business action) validator pattern formatter pattern skin pattern renderer pattern localizer pattern builder pattern event pattern listener pattern job pattern data update pattern output aggregator pattern data object pattern record pattern (has ID) immutable value pattern exception pattern active record anti-pattern content pattern (deprecate?) parser pattern (?) cache pattern writer pattern hook handler pattern client object pattern adapter pattern maintenance script pattern

The output aggregator pattern describes object that are used to construct a string intended for output, typically HTML. Output aggregators may also construct additional auxiliary information, e.g. concerning the cacheability of the output.

Output aggregators have one or more methods for contributing to the output, and one or more methods to access the resulting output and associated information.

Instantiation:
While trivial output aggregators may be constructed directly, it is generally wise to design them to be obtained them from some kind of factory. This way, service objects for e.g. localization can be injected.

Related patterns:

• While an output aggregator may be a data objects, this is not necessary. In particular, an output aggregator may use service objects internally. Because of this, output aggregators may or may bot be serializable.
• The builder pattern is conceptually similar to the output aggregator. However, builders will typically construct a value object, while output aggregators (primarily) construct a string intended for output, along with auxiliary information.
• Views may use the output from an output aggregator, or may contribute output to an output aggregator (or both).
• Skins may use the output from an output aggregator, or may contribute output to an output aggregator (or both).
• Renderers often contribute output to an output aggregator.

Naming Convention:
No naming convention is established. The suffix "Aggregator" is suggested for new instances of this pattern.

Layer constraint:
The output aggregator pattern is used primarily in the user interface layer, though it may also be used in other layers, such as the behavior layer.

Status:
As of May 2020, the output aggregator pattern is well established, though not widely used.

Examples:
The two primary examples of the output aggregator pattern are OutputPage and ParserOutput.