Package org.apache.sis.metadata

# Enum KeyNamePolicy

Object
Enum<KeyNamePolicy>
KeyNamePolicy

All Implemented Interfaces:
  `Serializable`, `Comparable<KeyNamePolicy>`, `Constable`

public enum KeyNamePolicy extends Enum<KeyNamePolicy>
The name of the keys included in a `Map` of metadata. Those maps are created by the `AbstractMetadata​.asMap()` method. The keys in those map are `String`s which can be inferred from the UML identifier, the name of the Javabeans property, or the method name.

In GeoAPI implementation of ISO 19115, `UML_IDENTIFIER` and `JAVA_PROPERTY` names are usually identical except for collections: `JAVA_PROPERTY` names are plural when the property is a collection while `UML_IDENTIFIER` usually stay singular no matter the property multiplicity.

Since:
  0.3
See Also:
  - `MetadataStandard​.asValueMap(Object, Class, KeyNamePolicy, ValueExistencePolicy)`

Defined in the `sis-metadata` module

- ## Nested Class Summary

  ## Nested classes/interfaces inherited from class Enum

  `Enum​.EnumDesc<E extends Enum<E>>`

- ## Enum Constant Summary

  Enum Constants
  Enum Constant
  Description
  `JAVABEANS_PROPERTY`
  The keys in the map are the Javabeans property names.
  `METHOD_NAME`
  The keys in the map are the plain method names.
  `SENTENCE`
  The keys in the map are sentences inferred from the UML identifiers.
  `UML_IDENTIFIER`
  The keys in the map are the UML identifier of the metadata properties.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static KeyNamePolicy`
  `valueOf(String name)`
  Returns the enum constant of this type with the specified name.
  `static KeyNamePolicy[]`
  `values()`
  Returns an array containing the constants of this enum type, in the order they are declared.

  ### Methods inherited from class Enum

  `clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf`

  ### Methods inherited from class Object

  `getClass, notify, notifyAll, wait, wait, wait`

- ## Enum Constant Details

  - ### UML_IDENTIFIER

    public static final KeyNamePolicy UML_IDENTIFIER
    The keys in the map are the UML identifier of the metadata properties. If a property has no UML annotation, then the Javabeans property name is used as a fallback.

  - ### JAVABEANS_PROPERTY

    public static final KeyNamePolicy JAVABEANS_PROPERTY
    The keys in the map are the Javabeans property names. This is the method name with the `get` or `is` prefix removed, and the first letter made lower-case.

    This is the default type of names returned by `AbstractMetadata​.asMap()`.

  - ### METHOD_NAME

    public static final KeyNamePolicy METHOD_NAME
    The keys in the map are the plain method names.

  - ### SENTENCE

    public static final KeyNamePolicy SENTENCE
    The keys in the map are sentences inferred from the UML identifiers. This policy starts with the same names than `UML_IDENTIFIER`, searches for word boundaries (defined as a lower case letter followed by a upper case letter) and inserts a space between the words found. The first letter in the sentence is made upper-case. The first letters of following words are made lower-case.

- ## Method Details

  - ### values

    public static KeyNamePolicy[] values()
    Returns an array containing the constants of this enum type, in the order they are declared.
    Returns:
      an array containing the constants of this enum type, in the order they are declared

  - ### valueOf

    public static KeyNamePolicy valueOf(String name)
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    Parameters:
      `name` - the name of the enum constant to be returned.
    Returns:
      the enum constant with the specified name
    Throws:
      `IllegalArgumentException` - if this enum type has no constant with the specified name
      `NullPointerException` - if the argument is null