jp.go.nict.langrid.language
クラス Language

java.lang.Object
  jp.go.nict.langrid.language.Language

すべての実装されたインタフェース:

Serializable

public class Language
extends Object
implements Serializable

言語グリッドにおける文字列表現を格納する。 参考:

 RFC 3066: Tags for the Identification of Languages
 http://www.ietf.org/rfc/rfc3066.txt
 ISO 639: Codes for the Representation of Names of Languages
 http://www.loc.gov/standards/iso639-2/englangn.html
 ISO 3166: Codes for Country Names
 http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html
 IANA LANGUAGE TAGS
 http://www.iana.org/assignments/language-tags
 

バージョン:

$Revision: 8841 $

作成者:

$Author: kkadowaki $

関連項目:

ISO639_1, ISO639_2, ISO3166, IANALanguageTags, LangridLanguageTags, 直列化された形式

コンストラクタの概要

Language(String expression)
コンストラクタ。

メソッドの概要

boolean	equals(Language value) このオブジェクトとvalueが等しい場合、trueを返す。
boolean	equals(Object value) このオブジェクトとvalueが等しい場合、trueを返す。
static Language	get(LanguageTag language) 言語表現を取得する。
static Language	get(LanguageTag language, CountryName country, String... additionals) 言語表現を取得する。
static Language	get(LanguageTag language, String countryOrCharset, String... additionals) 言語表現を取得する。
String	getCode() RFC3066準拠の言語コードを返す。
String	getLocalizedName(Locale locale) 指定されたロケールでの文字列表現を返す。
int	hashCode() このオブジェクトのハッシュコードを返す。
boolean	isDeprecated() この言語表現にdeprecated指定が行われている場合、trueを返す。
boolean	matches(Language value) 特定の言語表現がこの言語表現にマッチするかどうかを判別する。
static Language	parse(String expression) 文字列表現を解析し、Languageオブジェクトを作成して返す。
String	toString() getCodeと同じ値を返す。

クラス java.lang.Object から継承されたメソッド

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Language

public Language(String expression)
         throws InvalidLanguageTagException

コンストラクタ。

パラメータ:

expression - 言語表現

例外:

InvalidLanguageTagException - 不正な言語タグが検出された

メソッドの詳細

hashCode

public int hashCode()

このオブジェクトのハッシュコードを返す。

オーバーライド:

クラス Object 内の hashCode

戻り値:

ハッシュコード

equals

public boolean equals(Language value)

このオブジェクトとvalueが等しい場合、trueを返す。

パラメータ:

value - 比較するオブジェクト

戻り値:

等しい場合true

equals

public boolean equals(Object value)

このオブジェクトとvalueが等しい場合、trueを返す。

オーバーライド:

クラス Object 内の equals

パラメータ:

value - 比較するオブジェクト

戻り値:

等しい場合true

isDeprecated

public boolean isDeprecated()

この言語表現にdeprecated指定が行われている場合、trueを返す。

戻り値:

deprecated指定が行われている場合true

getCode

public String getCode()

RFC3066準拠の言語コードを返す。

戻り値:

言語コード

getLocalizedName

public String getLocalizedName(Locale locale)

指定されたロケールでの文字列表現を返す。 定義されていない場合、言語コードを返す。

パラメータ:

locale - ロケール

戻り値:

指定されたロケールでの文字列表現。例: "日本語"

toString

public String toString()

getCodeと同じ値を返す。

オーバーライド:

クラス Object 内の toString

戻り値:

文字列表現

matches

public boolean matches(Language value)

特定の言語表現がこの言語表現にマッチするかどうかを判別する。 マッチングは前方一致で行われる。valueが"*"の場合、trueを返す。

パラメータ:

value - 判別する言語表現

戻り値:

マッチする場合true

get

public static Language get(LanguageTag language)

言語表現を取得する。

パラメータ:

language - 言語タグ

戻り値:

言語表現

get

public static Language get(LanguageTag language,
                           CountryName country,
                           String... additionals)
                    throws InvalidLanguageTagError

言語表現を取得する。

パラメータ:

language - 言語タグ

country - 国名

additionals - 追加タグ

戻り値:

言語表現

例外:

InvalidLanguageTagError - 無効な文字が含まれている

get

public static Language get(LanguageTag language,
                           String countryOrCharset,
                           String... additionals)
                    throws InvalidLanguageTagError

言語表現を取得する。

パラメータ:

language - 言語タグ

countryOrCharset - 国名又はキャラクタセット

additionals - 追加指定文字列

戻り値:

言語表現

例外:

InvalidLanguageTagError - 無効な文字が含まれている

parse

public static Language parse(String expression)
                      throws InvalidLanguageTagException

文字列表現を解析し、Languageオブジェクトを作成して返す。 文字列表現がRFC3066に適合していなければ、例外を投げる。
検証方法は、以下のとおり。

• IANA(IANALanguageTags)に登録されていれば適合("i"から始まるものを含む)。
• 最初のタグが"x"から始まっており、タグが2つ以上あれば適合。
• 最初のタグがISO639、2番目のタグがISO3166に含まれていれば適合。 この際、大文字小文字は区別しない。
• 上記以外の場合は不適合

パラメータ:

expression - 言語表現

戻り値:

言語表現オブジェクト

例外:

InvalidLanguageTagException - 言語表現が不正