org.languagetool

Class Languages

java.lang.Object

org.languagetool.Languages

public final class Languages
extends Object

Helper methods to list all supported languages and to get language objects by their name or language code etc.

Since:

2.9

Method Summary

Methods

Modifier and Type	Method and Description
static List<Language>	get() Language classes are detected at runtime by searching the classpath for files named META-INF/org/languagetool/language-module.properties.
static Language	getLanguageForLocale(Locale locale) Get the best match for a locale, using American English as the final fallback if nothing else fits.
static Language	getLanguageForName(String languageName) Get the Language object for the given language name.
static Language	getLanguageForShortName(String langCode) Get the Language object for the given short language name.
static List<Language>	getWithDemoLanguage() Like get() but the list contains also LanguageTool's internal 'Demo' language, if available.
static boolean	isLanguageSupported(String langCode) Return whether a language with the given language code is supported.

Methods inherited from class java.lang.Object

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

Method Detail

get

public static List<Language> get()

Language classes are detected at runtime by searching the classpath for files named META-INF/org/languagetool/language-module.properties. Those file(s) need to contain a key languageClasses which specifies the fully qualified class name(s), e.g. org.languagetool.language.English. Use commas to specify more than one class.

Returns:

an unmodifiable list of all supported languages

getWithDemoLanguage

public static List<Language> getWithDemoLanguage()

Like get() but the list contains also LanguageTool's internal 'Demo' language, if available. Only useful for tests.

Returns:

an unmodifiable list

getLanguageForName

@Nullable
public static Language getLanguageForName(String languageName)

Get the Language object for the given language name.

Parameters:

languageName - e.g. English or German (case is significant)

Returns:

a Language object or null if there is no such language

getLanguageForShortName

public static Language getLanguageForShortName(String langCode)

Get the Language object for the given short language name.

Parameters:

langCode - e.g. en or es-US

Returns:

a Language object

Throws:

IllegalArgumentException - if the language is not supported or if the language code is invalid

isLanguageSupported

public static boolean isLanguageSupported(String langCode)

Return whether a language with the given language code is supported. Which languages are supported depends on the classpath when the Language object is initialized.

Parameters:

langCode - e.g. en or en-US

Returns:

true if the language is supported

Throws:

IllegalArgumentException - in some cases of an invalid language code format

getLanguageForLocale

public static Language getLanguageForLocale(Locale locale)

Get the best match for a locale, using American English as the final fallback if nothing else fits. The returned language will be a country variant language (e.g. British English, not just English) if available.

Throws:

RuntimeException - if no language was found and American English as a fallback is not available