-DefaultLocalizationService (Fulcrum Localization 1.0.7-SNAPSHOT API) -

java.lang.Object
+
- org.apache.avalon.framework.logger.AbstractLogEnabled
- +
  - org.apache.fulcrum.localization.SimpleLocalizationServiceImpl
  - +
    - org.apache.fulcrum.localization.DefaultLocalizationService
    +
  +
+

+
+
All Implemented Interfaces:
+
org.apache.avalon.framework.activity.Initializable, org.apache.avalon.framework.configuration.Configurable, org.apache.avalon.framework.logger.LogEnabled, LocalizationService, SimpleLocalizationService
+
+
+
+
```
public class DefaultLocalizationService
+extends SimpleLocalizationServiceImpl
+implements LocalizationService
```
+
+ This class is the single point of access to all localization resources. It caches different ResourceBundles for different - Locales.
+ Locales. +

Usage example:
-
+ + LocalizationService ls = (LocalizationService) TurbineServices .getInstance().getService(LocalizationService.SERVICE_NAME); -
+ + -
Then call SimpleLocalizationServiceImpl.getString(String, Locale, String), or one of +
+ Then call SimpleLocalizationServiceImpl.getString(String, Locale, String), or one of four methods to retrieve a ResourceBundle: +
- getBundle("MyBundleName")
- etBundle("MyBundleName", HttpServletRequest)
- getBundle("MyBundleName", Locale)
- etc.
-
- -
-
-
Version:
-
$Id: DefaultLocalizationService.java 645885 2008-04-08 12:50:57Z tv $
-
Author:
-
Jonas Maurus, Jon S. Stevens, Frank Y. Kim, Daniel Rall, Leonard Richardson, Stephen McConnell, Thomas Vandahl
-
-
- -
+

Version:: $Id: DefaultLocalizationService.java 1851909 2019-01-23 13:16:31Z painter $ + avalon.component name="localization" lifestyle="singleton" + avalon.service type="org.apache.fulcrum.localization.LocalizationService"
Author:: Jonas Maurus, Jon S. Stevens, Frank Y. Kim, Daniel Rall, Leonard Richardson, Stephen McConnell, Thomas Vandahl

+ + +

- - - - - - -

-Field Summary

- - - - - - - - -

Fields inherited from interface org.apache.fulcrum.localization.LocalizationService
`ACCEPT_LANGUAGE, ROLE, SERVICE_NAME`

- +

+ + +
Field Summary
+
- + + +
  Fields inherited from interface org.apache.fulcrum.localization.LocalizationService
  +ACCEPT_LANGUAGE, ROLE, SERVICE_NAME
+

- - - - - - - - - -

-Constructor Summary
`DefaultLocalizationService()` - - - Creates a new instance.

- +

+ + +
Constructor Summary
+ + + + + + + + +
Constructors
Constructor and Description
DefaultLocalizationService() +
Creates a new instance.
+
+

Constructors
Constructor and Description
`DefaultLocalizationService()` + Creates a new instance. +

- - - - - - - - - + + + + + + + + + +

-Method Summary

- ResourceBundle

getBundle(javax.servlet.http.HttpServletRequest req) - -
- This method returns a ResourceBundle given the Locale +

+ + +

Method Summary

+ + + + + + + + + - - - - + + + + + + + + - - - - - - - - - - - - - -

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ResourceBundle`	`getBundle(HttpServletRequest req)` + This method returns a ResourceBundle given the Locale information supplied in the HTTP "Accept-Language" header which - is stored in HttpServletRequest.
- `ResourceBundle`	`getBundle(String bundleName, - javax.servlet.http.HttpServletRequest req)` - - - This method returns a ResourceBundle given the bundle name and + is stored in HttpServletRequest. +
`ResourceBundle`	`getBundle(String bundleName, + HttpServletRequest req)` + Convenience method to get a `ResourceBundle` based + on name and HTTP `Accept-Language` header from a + `HttpServletRequest`. +
`ResourceBundle`	`getBundle(String bundleName, + String languageHeader)` + This method returns a ResourceBundle given the bundle name and the Locale information supplied in the HTTP "Accept-Language" - header which is stored in HttpServletRequest.
- `ResourceBundle`	`getBundle(String bundleName, - String languageHeader)` - - - This method returns a ResourceBundle given the bundle name and - the Locale information supplied in the HTTP "Accept-Language" - header.
- `Locale`	`getLocale(javax.servlet.http.HttpServletRequest req)` - - - Attempts to pull the `Accept-Language` header out of - the `HttpServletRequest` object and then parse it.
- `Locale`	`getLocale(String header)` - - - Parses the `Accept-Language` header and attempts to - create a `Locale` from it.

- - - - - - - - -

Methods inherited from class org.apache.fulcrum.localization.SimpleLocalizationServiceImpl
`configure, format, format, format, getBundle, getBundle, getBundle, getBundleNames, getDefaultBundleName, getDefaultCountry, getDefaultLanguage, getDefaultLocale, getString, getStringOrNull, initBundleNames, initialize, setBundle`

- - - - - - - - -

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled
`enableLogging, getLogger, setupLogger, setupLogger, setupLogger`

- - - - - - - - -

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - - - - - - - -

Methods inherited from interface org.apache.fulcrum.localization.SimpleLocalizationService
`format, format, format, getBundle, getBundle, getBundle, getBundleNames, getDefaultBundleName, getDefaultCountry, getDefaultLanguage, getDefaultLocale, getString, setBundle`

- -

- + header. +

Locale

getLocale(HttpServletRequest req) +

Attempts to pull the Accept-Language header out of + the HttpServletRequest object and then parse it.

Locale

getLocale(String header) +

Parses the Accept-Language header and attempts to + create a Locale from it.

+ + +
Methods inherited from class org.apache.fulcrum.localization.SimpleLocalizationServiceImpl
+configure, format, format, format, getBundle, getBundle, getBundle, getBundleNames, getDefaultBundleName, getDefaultCountry, getDefaultLanguage, getDefaultLocale, getString, getString, getStringOrNull, initBundleNames, initialize, setBundle

+ + +
Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled
+enableLogging, getLogger, setupLogger, setupLogger, setupLogger

+ + +
Methods inherited from class java.lang.Object
+clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

+ + +
Methods inherited from interface org.apache.fulcrum.localization.SimpleLocalizationService
+format, format, format, getBundle, getBundle, getBundle, getBundleNames, getDefaultBundleName, getDefaultCountry, getDefaultLanguage, getDefaultLocale, getString, getString, setBundle +

+ + +

- - - - - - -
-Constructor Detail
- -
-DefaultLocalizationService
-
```
-public DefaultLocalizationService()
```
-
-
Creates a new instance. -
-
- +
- + + +
  Constructor Detail
  + + + +
  - +
    DefaultLocalizationService
    +
```
public DefaultLocalizationService()
```
    +
    Creates a new instance.
    +
  +
- - - - - - -
-Method Detail
- -
-getBundle
-
```
-public ResourceBundle getBundle(String bundleName,
-                                String languageHeader)
```
-
-
This method returns a ResourceBundle given the bundle name and +
- + + +
  Method Detail
  + + + +
  - +
    getBundle
    +
    public ResourceBundle getBundle(String bundleName, + String languageHeader)
    +
    This method returns a ResourceBundle given the bundle name and the Locale information supplied in the HTTP "Accept-Language" - header. -
    -
    -
    Specified by:
    getBundle in interface LocalizationService
    -
    -
    -
    Parameters:
    bundleName - Name of bundle.
    languageHeader - A String with the language header. -
    Returns:
    A localized ResourceBundle.
    -
    -
-
- -
-getBundle
-
```
-public ResourceBundle getBundle(javax.servlet.http.HttpServletRequest req)
```
-
-
This method returns a ResourceBundle given the Locale + header.

- -org.apache.fulcrum.localization -
-Class DefaultLocalizationService

Class DefaultLocalizationService

Field Summary

Fields inherited from interface org.apache.fulcrum.localization.LocalizationService

Constructor Summary

Method Summary

Methods inherited from class org.apache.fulcrum.localization.SimpleLocalizationServiceImpl

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.fulcrum.localization.SimpleLocalizationService