com.orchestranetworks.ui

Interface UILabelRendererContext

All Superinterfaces:

UIBodyWriter

All Known Subinterfaces:

UILabelRendererForHierarchyContext

public interface UILabelRendererContext
extends UIBodyWriter

Provides a context for displaying a record.

See Also:

UILabelRenderer

Method Summary

Modifier and Type	Method and Description
String	displayOccurrenceValue(Path aPath, boolean useLabels) Returns a user-friendly representation of the specified value, according the current locale.
String	getLabelFromDefaultPattern() Returns the localized label as specified by the default pattern.
Locale	getLocale() Returns the current locale of the user session.
Adaptation	getOccurrence() Returns the current record that is being displayed.
Session	getSession() Returns the current user session.
String	getURLForResource(ResourceType aResourceType, String aResourceName) Returns the URL of the specified web resource, in the current module and for the current session locale.
String	getURLForResource(ResourceType aResourceType, String aResourceName, Locale aLocale) Returns the URL of the specified web resource, in the current module (that is, the module of the current adaptation).
String	getURLForResource(String aModuleAliasOrName, ResourceType aResourceType, String aResourceName, Locale aLocale) Returns the URL of the specified web resource.
boolean	isHTMLForbidden() Returns true if the HTML tags in the label are escaped, false if they are interpreted.

Methods inherited from interface com.orchestranetworks.ui.UIBodyWriter

add_cr, add_cr, add, add, add, addSafeAttribute, addSafeAttribute, addSafeInnerHTML, addSafeInnerHTML

Method Detail

getLocale

Locale getLocale()

Returns the current locale of the user session.

Throws:

RuntimeException - if this method is called by a renderer defined inside a foreign key constraint.

getURLForResource

String getURLForResource(ResourceType aResourceType,
                         String aResourceName)

Returns the URL of the specified web resource, in the current module and for the current session locale. Returns null if called outside the context of an HTTP request (for instance through Adaptation.getLabel(Locale)).

Throws:

UnsupportedOperationException - if the resource type is internal (not accessible from HTTP).

ModuleNotFoundException - if the alias or name specified does not correspond to a module.

See Also:

getURLForResource(ResourceType, String, Locale), getLocale()

getURLForResource

String getURLForResource(ResourceType aResourceType,
                         String aResourceName,
                         Locale aLocale)

Returns the URL of the specified web resource, in the current module (that is, the module of the current adaptation). Returns null if called outside the context of an HTTP request (for instance through Adaptation.getLabel(Locale)).

Throws:

UnsupportedOperationException - if the resource type is internal (not accessible from HTTP).

ModuleNotFoundException - if the alias or name specified does not correspond to a module.

getURLForResource

String getURLForResource(String aModuleAliasOrName,
                         ResourceType aResourceType,
                         String aResourceName,
                         Locale aLocale)
                  throws ModuleNotFoundException

Returns the URL of the specified web resource. Returns null if called outside the context of an HTTP request (for instance through Adaptation.getLabel(Locale)).

Throws:

RuntimeException - if the resource type is internal (not accessible from HTTP).

ModuleNotFoundException - if the alias or name specified does not correspond to a module.

getOccurrence

Adaptation getOccurrence()

Returns the current record that is being displayed.

displayOccurrenceValue

String displayOccurrenceValue(Path aPath,
                              boolean useLabels)

Returns a user-friendly representation of the specified value, according the current locale.

Value display

A value can have be displayed differently from a standard XML formatted value since it can take into account locale-dependent formatting for numbers and dates and also, if useLabels is true for specific value labeling.

For more information, see value display section.

Parameters:

aPath - specifies the value to display in the record (a relative path is interpreted based on the root node of this context).

useLabels - If true and labeling is enabled (see above), specifies that the label associated with the value must be returned. Otherwise, the formatted value is returned.

Throws:

IllegalStateException - if this node is not for a record (see getOccurrence()).

RuntimeException - if this method is called by a renderer defined inside a foreign key constraint.

See Also:

SchemaNode.formatToXsString(Object), SchemaNode.displayOccurrence(Object, boolean, ValueContext, Locale)

getLabelFromDefaultPattern

String getLabelFromDefaultPattern()

Returns the localized label as specified by the default pattern. The default pattern is looked up on the elements <defaultLabel [xml:lang="..."]> which are specified by the table definition.

See Also:

Table Definition

getSession

Session getSession()

Returns the current user session.

isHTMLForbidden

boolean isHTMLForbidden()

Returns true if the HTML tags in the label are escaped, false if they are interpreted.

If this method returns true, HTML tags in the label will not be interpreted and will thus be displayed as plain text.

Since:

5.9.0