public interface LanguageHandler
The language handler may optionally provide normalization and verification services for string literals based on the language tags, including translation, grammar and spelling checks. However, this behavior is entirely driven by the user.
Modifier and Type | Field and Description |
---|---|
static String |
BCP47
Identifier for the language tag format defined by BCP47, which is referenced by the RDF-1.1
specification.
|
static String |
RFC3066
Identifier for the language tag format defined by RFC3066, which is referenced by the RDF-1.0
specification.
|
static String |
RFC4646
Identifier for the language tag format defined by RFC4646, which obsoletes RFC3066, but which is not
referenced by the RDF specification.
|
Modifier and Type | Method and Description |
---|---|
boolean |
isRecognizedLanguage(String theLangTag)
Checks if the given language tag is recognized by this language handler, including cases where the
language tag is recognized, but is not yet normalized.
|
String |
key()
A unique key for this language handler
|
Literal |
normalizeLanguage(String theValue,
String theLang)
Normalize both the language tag and the language if appropriate.
|
String |
normalizeLanguageTag(String theLang)
Normalize the language tag.
|
boolean |
verifyLanguage(String theValue,
String theLang)
Verifies that the language tag is valid, optionally including an automated check on the literal value.
|
static final String RFC3066
static final String RFC4646
static final String BCP47
boolean isRecognizedLanguage(@Nonnull String theLangTag)
theLangTag
- The language tag to check.verifyLanguage(String, String)
and
normalizeLanguage(String, String)
.boolean verifyLanguage(@Nonnull String theValue, @Nonnull String theLang) throws InvalidLiteral
This method must only be called after verifying that isRecognizedLanguage(String)
returns true
for the given language tag.
theValue
- Literal value matching the given language tag.theLang
- A language tag that matched with isRecognizedLanguage(String)
.InvalidLiteral
- If the language tag was not recognized.@Nonnull Literal normalizeLanguage(@Nonnull String theValue, @Nonnull String theLang) throws InvalidLiteral
This method must only be called after verifying that isRecognizedLanguage(String)
returns true
for the given language tag, and verifyLanguage(String, String)
also returns true for the given
language and literal value.
theValue
- Required literal value to use in the normalization process and to provide the value for the
resulting literal.theLang
- The language tag which is to be normalized. This tag is available in normalized form from the
result using Literal.lang()
.Literal
containing the normalized literal value and language tag.InvalidLiteral
- If the language tag was not recognized or verified, or the literal value could not be
normalized due to an error.@Nonnull String normalizeLanguageTag(@Nonnull String theLang)
verifyLanguage(String, String)
to ensure the language is valid.theLang
- The language tag which is to be normalized.Copyright © 2010-2016 Stardog Union. All Rights Reserved.