org.ametys.core.cocoon

Class I18nTextResourceHandler

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.core.cocoon.AbstractResourceHandler

org.ametys.core.cocoon.I18nTextResourceHandler

All Implemented Interfaces:

ResourceHandler, LogEnabled, Component, Configurable, Contextualizable, Serviceable

public class I18nTextResourceHandler
extends AbstractResourceHandler
implements Component

This class generates a translated version of an input file. It is designed to handle the following notation : {{i18n x}}
When encountering this pattern, we instantiate an I18nizableText with x and try to translate it.
Unknown translations are logged and do not prevent the generation process from continuing.

Field Summary

Fields

Modifier and Type	Field and Description
private static char[]	__I18N_BEGINNING_CHARS The beginning of a valid declaration for an internationalizable text as characters
private static String	__I18N_DEFAULT_CATALOGUE_ID This configuration parameter specifies the id of the catalogue to be used as default catalogue, allowing to redefine the default catalogue on the pipeline level.
private static String	__I18N_LOCALE
private static Pattern	__LOCALE_PATTERN
private I18nUtils	_i18nUtils Avalon component gathering utility methods concerning I18nizableText, allowing their translation in several languages
private boolean	_isDeclarationValid Is the last analyzed i18n declaration valid ?

Fields inherited from class org.ametys.core.cocoon.AbstractResourceHandler

_cocoonContext, _context, _resolver, _supportedSuffixes

Fields inherited from interface org.ametys.core.cocoon.ResourceHandler

MAX_PRIORITY, MIN_PRIORITY

Constructor Summary

Constructors

Constructor and Description
I18nTextResourceHandler()

Method Summary

Modifier and Type	Method and Description
private int	_analyzeI18nDeclaration(char[] srcChars, int candidateBeginIdx, BufferedWriter outWriter, int initialOffset, Source source, Parameters par) Analyze characters from the key beginning index to the possible closure sequence '}}', and write the appropriate replacement in the output string builder
private String	_getLocale(Parameters par)
private boolean	_testI18nDeclarationPrefix(char[] srcChars, int start) Test if the given character is the start of an i18n declaration
private void	_translateKey(char[] srcChars, BufferedWriter outWriter, int candidateBeginIdx, int lastIdx, int initialOffset, String locale, Parameters par) Try to translate the key and write the output stream with its translation if found, the key itself if not
void	generateResource(Source source, OutputStream out, Parameters par) Generate the resource configured during setup, and output it
Serializable	getKey(Source source, Parameters par) Get the unique key for this resource, for cache purpose.
String	getMimeType(Source source, Parameters par) Return the mime type of the configured resource.
void	service(ServiceManager serviceManager)
Source	setup(String location, Parameters par) Initialize the resource handler with a resource.

Methods inherited from class org.ametys.core.cocoon.AbstractResourceHandler

configure, contextualize, getLastModified, getPriority, getSize, getValidity, isSupported

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

__I18N_DEFAULT_CATALOGUE_ID

private static final String __I18N_DEFAULT_CATALOGUE_ID

This configuration parameter specifies the id of the catalogue to be used as default catalogue, allowing to redefine the default catalogue on the pipeline level.

See Also:

Constant Field Values

__I18N_LOCALE

private static final String __I18N_LOCALE

See Also:

Constant Field Values

__I18N_BEGINNING_CHARS

private static final char[] __I18N_BEGINNING_CHARS

The beginning of a valid declaration for an internationalizable text as characters

__LOCALE_PATTERN

private static final Pattern __LOCALE_PATTERN

_i18nUtils

private I18nUtils _i18nUtils

Avalon component gathering utility methods concerning I18nizableText, allowing their translation in several languages

_isDeclarationValid

private boolean _isDeclarationValid

Is the last analyzed i18n declaration valid ?

Constructor Detail

I18nTextResourceHandler

public I18nTextResourceHandler()

Method Detail

service

public void service(ServiceManager serviceManager)
             throws ServiceException

Specified by:

service in interface Serviceable

Overrides:

service in class AbstractResourceHandler

Throws:

ServiceException

setup

public Source setup(String location,
                    Parameters par)
             throws ProcessingException,
                    IOException

Description copied from interface: ResourceHandler

Initialize the resource handler with a resource.

Specified by:

setup in interface ResourceHandler

Overrides:

setup in class AbstractResourceHandler

Parameters:

location - The source uri

par - The parameters

Returns:

the resolved source

Throws:

ProcessingException - If an error occurs

IOException - If an error occurs

_getLocale

private String _getLocale(Parameters par)

generateResource

public void generateResource(Source source,
                             OutputStream out,
                             Parameters par)
                      throws IOException,
                             ProcessingException

Description copied from interface: ResourceHandler

Generate the resource configured during setup, and output it

Specified by:

generateResource in interface ResourceHandler

Parameters:

source - The source

out - The output stream to write to

par - The parameters

Throws:

IOException - If an error occurs

ProcessingException - If an error occurs

_testI18nDeclarationPrefix

private boolean _testI18nDeclarationPrefix(char[] srcChars,
                                           int start)

Test if the given character is the start of an i18n declaration

Parameters:

srcChars - the input file as characters

start - the index of the given character

Returns:

true if this is a start of an i18n declaration, false otherwise

_analyzeI18nDeclaration

private int _analyzeI18nDeclaration(char[] srcChars,
                                    int candidateBeginIdx,
                                    BufferedWriter outWriter,
                                    int initialOffset,
                                    Source source,
                                    Parameters par)
                             throws IOException

Analyze characters from the key beginning index to the possible closure sequence '}}', and write the appropriate replacement in the output string builder

Parameters:

srcChars - the input file as characters

candidateBeginIdx - the index at which we started analyzing a viable i18n declaration

outWriter - the buffered writer where we store the output string

initialOffset - the initial offset

source - The source using the i18n

par - The declaration parameters (to get locale)

Returns:

the amount of analyzed characters

Throws:

IOException - if an error occurs while writing the output

_translateKey

private void _translateKey(char[] srcChars,
                           BufferedWriter outWriter,
                           int candidateBeginIdx,
                           int lastIdx,
                           int initialOffset,
                           String locale,
                           Parameters par)
                    throws IOException

Try to translate the key and write the output stream with its translation if found, the key itself if not

Parameters:

srcChars - the input source as characters

outWriter - the string builder where to write

candidateBeginIdx - the index at which the i18n declaration started

lastIdx - the last index analyzed

initialOffset - the amount of characters that we have to write before the i18n declaration

locale - The locale to use

par - The declaration parameters

Throws:

IOException - if an error occurs while writing the output

getKey

public Serializable getKey(Source source,
                           Parameters par)

Description copied from interface: ResourceHandler

Get the unique key for this resource, for cache purpose.

Specified by:

getKey in interface ResourceHandler

Overrides:

getKey in class AbstractResourceHandler

Parameters:

source - The source

par - The parameters

Returns:

The cache key.

getMimeType

public String getMimeType(Source source,
                          Parameters par)

Description copied from interface: ResourceHandler

Return the mime type of the configured resource.

Specified by:

getMimeType in interface ResourceHandler

Overrides:

getMimeType in class AbstractResourceHandler

Parameters:

source - The source

par - The parameters

Returns:

The mime type.