Package com.transifex.txnative.missingpolicy

Class AndroidMissingPolicy

java.lang.Object

com.transifex.txnative.missingpolicy.AndroidMissingPolicy

All Implemented Interfaces:

MissingPolicy

public class AndroidMissingPolicy
extends Object
implements MissingPolicy

Returns a translated string using Android's localization system.

You can use this policy to fall back to translations provided via strings.xml when a translation string can't be provided by TxNative's cache.

Constructor Summary

Constructors

Constructor	Description
AndroidMissingPolicy()
AndroidMissingPolicy(Context applicationContext)	Deprecated.

Method Summary

Modifier and Type	Method	Description
CharSequence	get(Resources resources, CharSequence sourceString, int id, String resourceName, String locale)	Returns a translated string using Android's localization system.
CharSequence	getQuantityString(Resources resources, CharSequence sourceQuantityString, int id, int quantity, String resourceName, String locale)	Returns a translated quantity string using Android's localization system.

Methods inherited from class java.lang.Object

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

Constructor Detail

AndroidMissingPolicy

public AndroidMissingPolicy()

AndroidMissingPolicy

@Deprecated
public AndroidMissingPolicy(@NonNull
                            Context applicationContext)

Deprecated.

Creates a new instance.

This constructor has been deprecated. A context is no longer needed.

Parameters:

applicationContext - The application context. Do not provide a context wrapped by TxNative#wrap(Context) or TxNative#generalWrap(Context).

Method Detail

get

@NonNull
public CharSequence get(@NonNull
                        Resources resources,
                        @NonNull
                        CharSequence sourceString,
                        @StringRes
                        int id,
                        @NonNull
                        String resourceName,
                        @NonNull
                        String locale)

Returns a translated string using Android's localization system.

The result is equivalent to calling Resources.getText(int) without using TxNative functionality.

Specified by:

get in interface MissingPolicy

Parameters:

resources - A Resources object. This is the wrapped resources object returned by TxResources.getWrappedResources().

sourceString - The source string.

id - The string resource identifier as defined by Resources.getIdentifier(String, String, String).

resourceName - The entry name of the string resource as defined by Resources.getResourceEntryName(int).

locale - The current locale as returned by LocaleState.getResolvedLocale().

Returns:

The translated string.

getQuantityString

@NonNull
public CharSequence getQuantityString(@NonNull
                                      Resources resources,
                                      @NonNull
                                      CharSequence sourceQuantityString,
                                      @PluralsRes
                                      int id,
                                      int quantity,
                                      @NonNull
                                      String resourceName,
                                      @NonNull
                                      String locale)

Returns a translated quantity string using Android's localization system.

The result is equivalent to calling Resources.getQuantityText(int, int) without using TxNative functionality.

Specified by:

getQuantityString in interface MissingPolicy

Parameters:

resources - A Resources object. This is the wrapped resources object returned by TxResources.getWrappedResources().

sourceQuantityString - The source string having grammatically correct pluralization for the given quantity.

id - The plurals resource identifier as defined by Resources.getIdentifier(String, String, String).

quantity - The number used to get the correct string for the current language's plural rules.

resourceName - The entry name of the plurals resource as defined by Resources.getResourceEntryName(int).

locale - The current locale as returned by LocaleState.getResolvedLocale().

Returns:

The translated string.