Package io.quarkus.qute
Class EngineBuilder
- java.lang.Object
-
- io.quarkus.qute.EngineBuilder
-
public final class EngineBuilder extends Object
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description EngineBuilderaddDefaults()Add the default set of value resolvers and section helpers.EngineBuilderaddDefaultSectionHelpers()EngineBuilderaddDefaultValueResolvers()Add the default set of value resolvers.EngineBuilderaddLocator(TemplateLocator locator)AReaderinstance produced by a locator is immediately closed right after the template content is parsed.EngineBuilderaddNamespaceResolver(NamespaceResolver resolver)EngineBuilderaddParserHook(ParserHook parserHook)EngineBuilderaddResultMapper(ResultMapper mapper)EngineBuilderaddSectionHelper(SectionHelperFactory<?> factory)EngineBuilderaddSectionHelper(String name, SectionHelperFactory<?> factory)EngineBuilderaddSectionHelpers(SectionHelperFactory<?>... factories)EngineBuilderaddTemplateInstanceInitializer(TemplateInstance.Initializer initializer)EngineBuilderaddValueResolver(ValueResolver resolver)EngineBuilderaddValueResolver(Supplier<ValueResolver> resolverSupplier)EngineBuilderaddValueResolvers(ValueResolver... resolvers)Enginebuild()EngineBuildercomputeSectionHelper(Function<String,SectionHelperFactory<?>> func)The function is used if no section helper registered viaaddSectionHelper(SectionHelperFactory)matches a section name.EngineBuilderiterationMetadataPrefix(String prefix)This prefix is used to access the iteration metadata inside a loop section.EngineBuilderremoveStandaloneLines(boolean value)Specify whether the parser should remove standalone lines from the output.EngineBuilderstrictRendering(boolean value)If set totruethen any expression that is evaluated to aResults.NotFoundwill always result in aTemplateExceptionand the rendering is aborted.EngineBuildertimeout(long value)The global rendering timeout.EngineBuilderuseAsyncTimeout(boolean value)If set totruethe timeout (either global or set via thetimeoutinstance attribute) is also used for asynchronous rendering methods, such asTemplateInstance.createUni()andTemplateInstance.renderAsync().
-
-
-
Method Detail
-
addSectionHelper
public EngineBuilder addSectionHelper(SectionHelperFactory<?> factory)
-
addSectionHelpers
public EngineBuilder addSectionHelpers(SectionHelperFactory<?>... factories)
-
addSectionHelper
public EngineBuilder addSectionHelper(String name, SectionHelperFactory<?> factory)
-
addDefaultSectionHelpers
public EngineBuilder addDefaultSectionHelpers()
-
addValueResolver
public EngineBuilder addValueResolver(Supplier<ValueResolver> resolverSupplier)
-
addValueResolvers
public EngineBuilder addValueResolvers(ValueResolver... resolvers)
-
addValueResolver
public EngineBuilder addValueResolver(ValueResolver resolver)
-
addDefaultValueResolvers
public EngineBuilder addDefaultValueResolvers()
Add the default set of value resolvers.- Returns:
- self
- See Also:
addValueResolver(ValueResolver)
-
addDefaults
public EngineBuilder addDefaults()
Add the default set of value resolvers and section helpers.- Returns:
- self
- See Also:
addValueResolver(ValueResolver),addSectionHelper(SectionHelperFactory)
-
addNamespaceResolver
public EngineBuilder addNamespaceResolver(NamespaceResolver resolver)
- Parameters:
resolver-- Returns:
- self
- Throws:
IllegalArgumentException- if there is a resolver of the same priority for the given namespace
-
addLocator
public EngineBuilder addLocator(TemplateLocator locator)
AReaderinstance produced by a locator is immediately closed right after the template content is parsed.- Parameters:
locator-- Returns:
- self
- See Also:
Engine.getTemplate(String)
-
addParserHook
public EngineBuilder addParserHook(ParserHook parserHook)
- Parameters:
parserHook-- Returns:
- self
- See Also:
ParserHelper
-
addResultMapper
public EngineBuilder addResultMapper(ResultMapper mapper)
- Parameters:
resultMapper-- Returns:
- self
-
addTemplateInstanceInitializer
public EngineBuilder addTemplateInstanceInitializer(TemplateInstance.Initializer initializer)
- Parameters:
initializer-- Returns:
- self
-
computeSectionHelper
public EngineBuilder computeSectionHelper(Function<String,SectionHelperFactory<?>> func)
The function is used if no section helper registered viaaddSectionHelper(SectionHelperFactory)matches a section name.- Parameters:
func-- Returns:
- self
-
removeStandaloneLines
public EngineBuilder removeStandaloneLines(boolean value)
Specify whether the parser should remove standalone lines from the output.A standalone line is a line that contains at least one section tag, parameter declaration, or comment but no expression and no non-whitespace character.
- Parameters:
value-- Returns:
- self
-
strictRendering
public EngineBuilder strictRendering(boolean value)
If set totruethen any expression that is evaluated to aResults.NotFoundwill always result in aTemplateExceptionand the rendering is aborted.Strict rendering is enabled by default.
- Parameters:
value-- Returns:
- self
-
iterationMetadataPrefix
public EngineBuilder iterationMetadataPrefix(String prefix)
This prefix is used to access the iteration metadata inside a loop section. This method must be called before aLoopSectionHelper.Factoryis registered, i.e. beforeaddDefaultSectionHelpers()or beforeaddSectionHelper(SectionHelperFactory).A valid prefix consists of alphanumeric characters and underscores.
- Parameters:
prefix-- Returns:
- self
- See Also:
LoopSectionHelper.Factory
-
timeout
public EngineBuilder timeout(long value)
The global rendering timeout.- Parameters:
value- Timeout in milliseconds- Returns:
- self
-
useAsyncTimeout
public EngineBuilder useAsyncTimeout(boolean value)
If set totruethe timeout (either global or set via thetimeoutinstance attribute) is also used for asynchronous rendering methods, such asTemplateInstance.createUni()andTemplateInstance.renderAsync().- Parameters:
value-- Returns:
- self
-
build
public Engine build()
- Returns:
- a new engine instance
-
-