Package io.quarkus.qute

Class LoopSectionHelper.Factory

java.lang.Object

io.quarkus.qute.LoopSectionHelper.Factory

All Implemented Interfaces:

SectionHelperFactory<LoopSectionHelper>

Enclosing class:

LoopSectionHelper

public static class LoopSectionHelper.Factory
extends Object
implements SectionHelperFactory<LoopSectionHelper>

Nested Class Summary

Nested classes/interfaces inherited from interface io.quarkus.qute.SectionHelperFactory

SectionHelperFactory.BlockInfo, SectionHelperFactory.MissingEndTagStrategy, SectionHelperFactory.ParametersInfo, SectionHelperFactory.ParserDelegate, SectionHelperFactory.SectionInitContext

Field Summary

Fields

Modifier and Type	Field	Description
static final String	HINT_ELEMENT
static final String	HINT_PREFIX
static final String	ITERATION_METADATA_PREFIX_ALIAS_QM	Constant value for iteration metadata prefix indicating that the alias suffixed with a question mark should be used.
static final String	ITERATION_METADATA_PREFIX_ALIAS_UNDERSCORE	Constant value for iteration metadata prefix indicating that the alias suffixed with an underscore should be used.
static final String	ITERATION_METADATA_PREFIX_NONE	Constant value for iteration metadata prefix indicating that no prefix should be used.

Fields inherited from interface io.quarkus.qute.SectionHelperFactory

HINT_METADATA, MAIN_BLOCK_NAME

Constructor Summary

Constructors

Constructor	Description
Factory()
Factory(String metadataPrefix)

Method Summary

Modifier and Type	Method	Description
List<String>	getBlockLabels()	A nested section tag that matches a name of a block will be added as a block to the current section.
List<String>	getDefaultAliases()
SectionHelperFactory.ParametersInfo	getParameters()	A factory may define factory parameters for the start tag of any section block.
LoopSectionHelper	initialize(SectionHelperFactory.SectionInitContext context)	Initialize a new helper instance for a specific section node in a template.
Scope	initializeBlock(Scope previousScope, SectionHelperFactory.BlockInfo block)	Initialize a section block.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.quarkus.qute.SectionHelperFactory

cacheFactoryConfig, missingEndTagStrategy, treatUnknownSectionsAsBlocks

Field Details

ITERATION_METADATA_PREFIX_ALIAS_QM

public static final String ITERATION_METADATA_PREFIX_ALIAS_QM

Constant value for iteration metadata prefix indicating that the alias suffixed with a question mark should be used.

See Also:

• Constant Field Values

ITERATION_METADATA_PREFIX_ALIAS_UNDERSCORE

public static final String ITERATION_METADATA_PREFIX_ALIAS_UNDERSCORE

Constant value for iteration metadata prefix indicating that the alias suffixed with an underscore should be used.

See Also:

• Constant Field Values

ITERATION_METADATA_PREFIX_NONE

public static final String ITERATION_METADATA_PREFIX_NONE

Constant value for iteration metadata prefix indicating that no prefix should be used.

See Also:

• Constant Field Values

HINT_ELEMENT

public static final String HINT_ELEMENT

See Also:

• Constant Field Values

HINT_PREFIX

public static final String HINT_PREFIX

See Also:

• Constant Field Values

Constructor Details

Factory

public Factory()

Factory

public Factory(String metadataPrefix)

Method Details

getDefaultAliases

public List<String> getDefaultAliases()

Specified by:

getDefaultAliases in interface SectionHelperFactory<LoopSectionHelper>

Returns:

the list of default aliases used to match the helper

See Also:

• SectionHelperFactory.cacheFactoryConfig()

getParameters

public SectionHelperFactory.ParametersInfo getParameters()

Description copied from interface: SectionHelperFactory

A factory may define factory parameters for the start tag of any section block. A factory Parameter has a name and optional default value. The default value is automatically assigned if no other value is set by a parser. A parameter may be optional. A non-optional parameter that has no value assigned results in a parser error.

A section block in a template defines the actual parameters:

 {! The value is "item.isActive". The name is not defined. !}
 {#if item.isActive}{/}

 {! The name is "age" and the value is "10". !}
 {#let age=10}{/}
 

The actual parameters are parsed taking the factory parameters into account:

1. Named actual params are processed first and the relevant values are assigned, e.g. the param with name age has the value 10,
2. Then, if the number of actual params is greater or equals to the number of factory params the values are set according to position of factory params,
3. Otherwise, the values are set according to position but params with no default value take precedence.
4. Finally, all unset parameters that define a default value are initialized with the default value.

Specified by:

getParameters in interface SectionHelperFactory<LoopSectionHelper>

Returns:

the factory parameters

See Also:

• SectionHelperFactory.cacheFactoryConfig()
• SectionHelperFactory.BlockInfo.getParameters()

getBlockLabels

public List<String> getBlockLabels()

Description copied from interface: SectionHelperFactory

A nested section tag that matches a name of a block will be added as a block to the current section.

Specified by:

getBlockLabels in interface SectionHelperFactory<LoopSectionHelper>

Returns:

the list of block labels

See Also:

• SectionHelperFactory.cacheFactoryConfig()

initialize

public LoopSectionHelper initialize(SectionHelperFactory.SectionInitContext context)

Description copied from interface: SectionHelperFactory

Initialize a new helper instance for a specific section node in a template.

Specified by:

initialize in interface SectionHelperFactory<LoopSectionHelper>

Returns:

a new helper instance

initializeBlock

public Scope initializeBlock(Scope previousScope,
 SectionHelperFactory.BlockInfo block)

Description copied from interface: SectionHelperFactory

Initialize a section block.

All section blocks are initialized before SectionHelperFactory.initialize(SectionInitContext) is called.

The factory is responsible to register all expression via SectionHelperFactory.BlockInfo.addExpression(String, String). The expression can be then used during SectionHelperFactory.initialize(SectionInitContext) via SectionHelperFactory.SectionInitContext.getExpression(String) and SectionBlock.expressions.

Specified by:

initializeBlock in interface SectionHelperFactory<LoopSectionHelper>

Returns:

a new scope if this section introduces a new scope, or the outer scope

See Also:

• SectionHelperFactory.BlockInfo.addExpression(String, String)