eu.ehri.project.utils

Class LanguageHelpers

java.lang.Object

eu.ehri.project.utils.LanguageHelpers

public class LanguageHelpers
extends Object

Utilities for language code conversions.

Constructor Summary

Constructors

Constructor and Description
LanguageHelpers()

Method Summary

Modifier and Type	Method and Description
static String	codeToName(String code) Convert a 2- or 3-letter language code to its (English) name.
static Optional<String>	countryCodeToContinent(String countryCode)
static String	countryCodeToName(String code) Convert and ISO639-2 code to its (English) name.
static Optional<Description>	getBestDescription(Described item, Optional<Description> priorDescOpt, String langCode) Get the best description for a given language code.
static Optional<Description>	getBestDescription(Described item, String langCode)
static String	iso3166dashOneCodeToName(String code) Convert an ISO 3166-1 country code to its (English) name.
static String	iso639DashOneCode(String nameOrCode) Take an ISO-639-2 code or a language name and try and map to a valid ISO639-1 code.
static String	iso639DashTwoCode(String nameOrCode) Take an ISO-639-1 code or a language name and try and map to a valid ISO639-2 code.

Methods inherited from class java.lang.Object

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

Constructor Detail

LanguageHelpers

public LanguageHelpers()

Method Detail

countryCodeToContinent

public static Optional<String> countryCodeToContinent(String countryCode)

getBestDescription

public static Optional<Description> getBestDescription(Described item,
                                                       Optional<Description> priorDescOpt,
                                                       String langCode)

Get the best description for a given language code.

Parameters:

item - a described item

priorDescOpt - if the object is hierarchical, the parent-level description

langCode - a 3-letter language code.

Returns:

the best matching description found

getBestDescription

public static Optional<Description> getBestDescription(Described item,
                                                       String langCode)

iso639DashTwoCode

public static String iso639DashTwoCode(String nameOrCode)

Take an ISO-639-1 code or a language name and try and map to a valid ISO639-2 code.

Parameters:

nameOrCode - a language code or name to convert

Returns:

the ISO 639-2 language code for that code or name, or the input string if no conversion was found

iso639DashOneCode

public static String iso639DashOneCode(String nameOrCode)

Take an ISO-639-2 code or a language name and try and map to a valid ISO639-1 code.

Parameters:

nameOrCode - a language code or name to convert

Returns:

the ISO 639-1 language code for that code or name, or the input string if no conversion was found

codeToName

public static String codeToName(String code)

Convert a 2- or 3-letter language code to its (English) name.

If no name can be found the input code will be returned.

Parameters:

code - a 2- or 3-letter ISO639 code

Returns:

a language name, with the original code as a fall back

iso3166dashOneCodeToName

public static String iso3166dashOneCodeToName(String code)

Convert an ISO 3166-1 country code to its (English) name.

Parameters:

code - the 2-letter country code

Returns:

the country name, or the code as a fallback

countryCodeToName

public static String countryCodeToName(String code)

Convert and ISO639-2 code to its (English) name.

Parameters:

code - the 2-letter country code

Returns:

the country name