Interface MappingService

All Known Implementing Classes:
BidiMappingService, SpringBidiMappingService
@Deprecated(since="6.0", forRemoval=true) public interface MappingService
Deprecated, for removal: This API element is subject to removal in a future version.
as of 6.0, use Mappings, which is String-typed, returns Optional rather than null, and has neither of the two string conventions this interface's implementations carry. Scheduled for removal in IPF 7.0.
Interface for mapping a set of keysets into corresponding values.

The back end mapping implementation is not defined by this interface. Examples could be a simple Map or a remote terminology service, for which proper implementations of this interface must be provided.

Author:
Christian Ohr

  • Method Summary

    Modifier and Type
    Method
    Description
    Object
    get(Object mappingKey, Object key)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Object
    get(Object mappingKey, Object key, Object defaultValue)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Object
    getKey(Object mappingKey, Object value)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Reverse mapping (Optional implementation)
    Object
    getKey(Object mappingKey, Object value, Object defaultKey)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Reverse mapping (Optional implementation)
    Object
    getKeySystem(Object mappingKey)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Object
    getValueSystem(Object mappingKey)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Set<?>
    keys(Object mappingKey)
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Set<?>
    mappingKeys()
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    Collection<?>
    values(Object mappingKey)
    Deprecated, for removal: This API element is subject to removal in a future version.
     

  • Method Details

    • get

      Object get(Object mappingKey, Object key)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping name
      key - left side of the mapping
      Returns:
      the value mapped by a registered mapping. The implementation of the mapping implements the behavior if the key does not exist.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • get

      Object get(Object mappingKey, Object key, Object defaultValue)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping name
      key - left side of the mapping
      defaultValue - default right side if there is no mapping for the code
      Returns:
      the value mapped by a registered mapping. If no mapping exists, the default value if returned. The implementation of the mapping implements the behavior if the key does not exist.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • getKey

      Object getKey(Object mappingKey, Object value)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Reverse mapping (Optional implementation)
      Parameters:
      mappingKey - mapping name
      value - right side of the mapping
      Returns:
      the key mapped by a registered mapping. The implementation of the mapping implements the behavior if the value does not exist.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • getKey

      Object getKey(Object mappingKey, Object value, Object defaultKey)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Reverse mapping (Optional implementation)
      Parameters:
      mappingKey - mapping name
      value - right side of the mapping
      defaultKey - default left side
      Returns:
      the key mapped by a registered mapping. If no mapping exists, the default value if returned. The implementation of the mapping implements the behavior if the key does not exist.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • getKeySystem

      Object getKeySystem(Object mappingKey)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping name
      Returns:
      a formal identification of the key system (e.g. an OID)
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • getValueSystem

      Object getValueSystem(Object mappingKey)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping name
      Returns:
      a formal identification of the value system (e.g. an OID)
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • mappingKeys

      Set<?> mappingKeys()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns:
      a set of names of all registered mappings. Changes to the set do not change the registry itself.

    • keys

      Set<?> keys(Object mappingKey)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping key
      Returns:
      key set of a registered mapping. Changes to the set do not change the registry itself.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.

    • values

      Collection<?> values(Object mappingKey)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Parameters:
      mappingKey - mapping key
      Returns:
      value set of a registered mapping. Changes to the set do not change the registry itself.
      Throws:
      IllegalArgumentException - if the mappingKey is not registered.