com.day.cq.wcm.api

Interface LanguageManager

public interface LanguageManager

Provides a service for content languages. Note that this has nothing to do with the i18n of the WCM itself.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	LanguageManager.Info Information about a resource in a language tree.
static interface	LanguageManager.Tree Encapsulates information about language specific existences of resources in a tree.
static interface	LanguageManager.TreeNode Denotes a node in the tree.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ISO_PROP_NAME relative path of the language property of a hierarchy node.

Method Summary

Modifier and Type	Method and Description
LanguageManager.Tree	compareLanguageTrees(ResourceResolver resolver, java.lang.String path) Compares language trees using the language of the page at the given path as main language.
java.util.Map<java.util.Locale,LanguageManager.Info>	getAdjacentInfo(ResourceResolver resolver, java.lang.String path) Deprecated. use getAdjacentLanguageInfo(ResourceResolver, String) instead
java.util.Map<Language,LanguageManager.Info>	getAdjacentLanguageInfo(ResourceResolver resolver, java.lang.String path) Returns a map of language information for each language filled with information if respective hierarchy or content exists for that language.
Language	getCqLanguage(Resource res) Returns the language for the given resource.
Language	getCqLanguage(Resource res, boolean respectContent) Returns the language for the given resource.
java.util.Collection<Language>	getCqLanguages(ResourceResolver resolver, java.lang.String path) Returns a collection of root languages for the given page.
java.lang.String	getIsoCountry(java.util.Locale language) Returns the country iso code for the given locale.
java.util.Locale	getLanguage(Resource res) Returns the language for the given resource.
java.util.Locale	getLanguage(Resource res, boolean respectContent) Returns the language for the given resource.
Page	getLanguageRoot(Resource res) Returns the language root page for the given resource.
java.util.Collection<Page>	getLanguageRoots(ResourceResolver resolver, java.lang.String path) Returns a collection of language root pages for the given page.
java.util.Collection<java.util.Locale>	getLanguages(ResourceResolver resolver, java.lang.String path) Deprecated. use getCqLanguages(ResourceResolver, String) instead.

Field Detail

ISO_PROP_NAME

static final java.lang.String ISO_PROP_NAME

relative path of the language property of a hierarchy node.

See Also:

Constant Field Values

Method Detail

getIsoCountry

java.lang.String getIsoCountry(java.util.Locale language)

Returns the country iso code for the given locale. if the country is not already defined in the locale a configured default value is returned. If no iso code exists, an empty string is returned.

Parameters:

language - the language locale to retrieve the country from

Returns:

a country iso code or ""

getAdjacentInfo

java.util.Map<java.util.Locale,LanguageManager.Info> getAdjacentInfo(ResourceResolver resolver,
                                                                     java.lang.String path)

Deprecated. use getAdjacentLanguageInfo(ResourceResolver, String) instead

Returns a map of language information for each language filled with information if respective hierarchy or content exists for that language.

Parameters:

resolver - resource resolver

path - path to check

Returns:

map of information or null if the given path does not reside on or below a language root.

See Also:

LanguageUtil.getLanguageRoot(String)

getAdjacentLanguageInfo

java.util.Map<Language,LanguageManager.Info> getAdjacentLanguageInfo(ResourceResolver resolver,
                                                                     java.lang.String path)

Returns a map of language information for each language filled with information if respective hierarchy or content exists for that language.

Parameters:

resolver - resource resolver

path - path to check

Returns:

map of information or null if the given path does not reside on or below a language root.

Since:

5.4

See Also:

LanguageUtil.getLanguageRoot(String)

getLanguage

java.util.Locale getLanguage(Resource res)

Returns the language for the given resource. Note that this method only uses the path names for the determination of the language.

Parameters:

res - resource

Returns:

the locale or null if not determinable

getCqLanguage

Language getCqLanguage(Resource res)

Returns the language for the given resource. Note that this method only uses the path names for the determination of the language.

Parameters:

res - resource

Returns:

the locale or null if not determinable

Since:

5.4

getLanguage

java.util.Locale getLanguage(Resource res,
                             boolean respectContent)

Returns the language for the given resource. The path of the resource is analyzed to find a matching iso code. If no iso code can be found, null is returned unless respectContent is true. then the resources ancestors (including the given) one is searched for a ISO_PROP_NAME property.

Parameters:

res - resource

respectContent - if false only the path is analyzes

Returns:

the locale or null if not determinable

Since:

5.4

getCqLanguage

Language getCqLanguage(Resource res,
                       boolean respectContent)

Returns the language for the given resource. The path of the resource is analyzed to find a matching iso code. If no iso code can be found, null is returned unless respectContent is true. then the resources ancestors (including the given) one is searched for a ISO_PROP_NAME property.

Parameters:

res - resource

respectContent - if false only the path is analyzes

Returns:

the locale or null if not determinable

Since:

5.4

getLanguageRoot

Page getLanguageRoot(Resource res)

Returns the language root page for the given resource. Note that currently only the path names are respected for the determination of the language.

Parameters:

res - resource

Returns:

the language root page or null if not determinable

getLanguages

java.util.Collection<java.util.Locale> getLanguages(ResourceResolver resolver,
                                                    java.lang.String path)

Deprecated. use getCqLanguages(ResourceResolver, String) instead.

Returns a collection of root languages for the given page. Note that only the path names are respected for the determination of the language.

Parameters:

resolver - resource resolver

path - path of the current page

Returns:

collection of root languages

getCqLanguages

java.util.Collection<Language> getCqLanguages(ResourceResolver resolver,
                                              java.lang.String path)

Returns a collection of root languages for the given page. Note that only the path names are respected for the determination of the language.

Parameters:

resolver - resource resolver

path - path of the current page

Returns:

collection of root languages

Since:

5.4

getLanguageRoots

java.util.Collection<Page> getLanguageRoots(ResourceResolver resolver,
                                            java.lang.String path)

Returns a collection of language root pages for the given page. Note that only the path names are respected for the determination of the language.

Parameters:

resolver - resource resolver

path - path of the current page

Returns:

collection of language root paths

compareLanguageTrees

LanguageManager.Tree compareLanguageTrees(ResourceResolver resolver,
                                          java.lang.String path)

Compares language trees using the language of the page at the given path as main language.

Parameters:

resolver - resource resolved

path - path to resource to start from

Returns:

the tree information