@Extension public interface NameFactory
Implementation note: despite the "create" name, implementations may return cached instances.
Modifier and Type | Method and Description |
---|---|
GenericName |
createGenericName(NameSpace scope,
CharSequence... parsedNames)
Creates a local or scoped name from an array of parsed names.
|
InternationalString |
createInternationalString(Map<Locale,String> strings)
Creates an international string from a set of strings in different locales.
|
LocalName |
createLocalName(NameSpace scope,
CharSequence name)
Creates a local name from the given character sequence.
|
NameSpace |
createNameSpace(GenericName name,
String headSeparator,
String separator)
Creates a namespace having the given name and separators.
|
GenericName |
parseGenericName(NameSpace scope,
CharSequence name)
Constructs a generic name from a qualified name.
|
InternationalString createInternationalString(Map<Locale,String> strings)
strings
- String value for each locale key.NameSpace createNameSpace(GenericName name, String headSeparator, String separator)
Implementation note: despite the "create" name, implementations may return existing instances.
name
- The name of the namespace to be returned. This argument can be created using
createGenericName(null, parsedNames)
.headSeparator
- The separator to insert between the namespace and the head. For HTTP namespace, it is "://"
. For URN namespace, it is
typically ":"
.separator
- The separator to insert between parsed names in that namespace. For HTTP namespace, it is "."
. For URN
namespace, it is typically ":"
.LocalName createLocalName(NameSpace scope, CharSequence name)
String
or an InternationalString
instance. In the later case,
implementations can use an arbitrary locale (typically ENGLISH
, but not necessarly) for the unlocalized string to be returned by
LocalName.toString()
.scope
- The scope of the local name to be created, or
null
for a global namespace.name
- The local name as a string or an international string.GenericName createGenericName(NameSpace scope, CharSequence... parsedNames)
String
or InternationalString
instances. In the later case,
implementations can use an arbitrary locale (typically ENGLISH
, but not necessarly) for the unlocalized string to be returned by
GenericName.toString()
.
If the length of the parsedNames
array is 1, then this method returns an instance
of LocalName
. If the length is 2 or more, then this method returns an instance of
ScopedName
.
scope
- The scope of the generic name to be created, or
null
for a global namespace.parsedNames
- The local names as an array of strings or international strings. This
array must contains at least one element.GenericName parseGenericName(NameSpace scope, CharSequence name)
For example if the scope
argument is the namespace "urn:ogc:def"
with
":"
as the separator, and if the name
argument is the string "crs:epsg:4326"
, then the result is a scoped name having a
depth of 3, which is the length of the list of parsed names ("crs"
, "epsg"
, "4326"
).
scope
- The scope of the generic name to be created, or
null
for a global namespace.name
- The qualified name, as a sequence of names separated by a scope-dependant
separator.Copyright © 1996–2022 Geotools. All rights reserved.