Interface HstComponentInfo
- All Known Subinterfaces:
HstComponentConfiguration
public interface HstComponentInfo
HstComponentConfiguration
.
Basic information interface for component configuration.
- Version:
- $Id$
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionboolean
when a component does have children which do not get flushed to the parent component, a waste message is logged by default on WARN level.Optional mode parameter to determine which technology should used for rendering asynchronous component.getId()
Returns the id for this component configuration.getLabel()
getName()
Return the name of this component configuration.boolean
isAsync()
Rendering asynchronous is very useful for hst components that are uncacheable, depend on external services, or take long to render.boolean
boolean
boolean
When theHstComponentWindow#getResponseState()
of thisHstComponentInfo
is not flushed by its parent rendering, a warning message about possible waste detection can be logged.
-
Method Details
-
getId
String getId()Returns the id for this component configuration. The id must be unique within the containerHstComponentsConfiguration
, ornull
if it is not needed to be directly accessed by theHstComponentsConfiguration
throughHstComponentsConfiguration.getComponentConfiguration(String)
. EveryHstComponentConfiguration
that can be referred to from within aHstSiteMapItem
must have an id.- Returns:
- the id of this component configuration or
null
if no id set
-
getName
String getName()Return the name of this component configuration. It must be unique amongst siblings. The value returned by this method, is the value that must be used in rendering code (jsp/velocity/freemarker) to include the output of a childHstComponent
instance.- Returns:
- the logical name this component configuration, unique amongst its siblings
-
getComponentClassName
String getComponentClassName()- Returns:
- the fully-qualified class name of the class implementing the
HstComponent
interface
-
getParametersInfoClassName
String getParametersInfoClassName()- Returns:
- if configured, the fully-qualified class name of the interface representing
ParametersInfo
for a component, and otherwisenull
.
-
isStandalone
boolean isStandalone()- Returns:
true
when thisHstComponentConfiguration
is configured to be rendered standalone in case ofHstURL.COMPONENT_RENDERING_TYPE
-
isAsync
boolean isAsync()Rendering asynchronous is very useful for hst components that are uncacheable, depend on external services, or take long to render.- Returns:
true
when thisHstComponentConfiguration
is configured to be rendered asynchronous.
-
getAsyncMode
String getAsyncMode()Optional mode parameter to determine which technology should used for rendering asynchronous component. e.g., 'ajax', 'esi', etc. -
isCompositeCacheable
boolean isCompositeCacheable()- Returns:
true
if rendering / resource requests can have their entire page http responses cached. Note that aHstComponentConfiguration
by default is cacheable unless configured not to be cacheable. AHstComponentConfiguration
is only cacheable if and only if all its descendantHstComponentConfiguration
s for the request are cacheable : Note explicitly for 'the request', thusHstComponentConfiguration
that areisAsync()
and its descendants can be uncacheable while an ancestorHstComponentConfiguration
can stay cacheable
-
isSuppressWasteMessage
boolean isSuppressWasteMessage()When theHstComponentWindow#getResponseState()
of thisHstComponentInfo
is not flushed by its parent rendering, a warning message about possible waste detection can be logged. If you want to suppress this message,isSuppressWasteMessage()
should returntrue
- Returns:
true
when possible waste messages about this component should be suppressed
-
getLabel
String getLabel()- Returns:
- the label if present and
null
otherwise
-
getComponentType
HstComponentConfiguration.Type getComponentType()- Returns:
- the
HstComponentConfiguration.Type
of this component
-
getAndSetLogWasteMessageProcessed
boolean getAndSetLogWasteMessageProcessed()when a component does have children which do not get flushed to the parent component, a waste message is logged by default on WARN level. However, this can be logged for every request flooding the logs. Instead, better to log it only once if the log level is WARN and only log it for every request if the log level is set to DEBUG Note that on the first get, the boolean is flipped to true : this method can be invoked concurrently and also modifies a boolean in the shared underlying Hst Model
-