Package org.openjdk.jmc.common.unit

Interface IConstrainedMap<K>

  • Type Parameters:
    K - the type of the keys in the map
    All Known Subinterfaces:
    IDescribedMap<K>, IMutableConstrainedMap<K>
    All Known Implementing Classes:
    MutableConstrainedMap, SimpleConstrainedMap
    public interface IConstrainedMap<K>
    Read only interface for a map where the values are constrained by an IConstraint per key. Note that as this is read only, its methods shouldn't throw any exceptions. This means that all implementations must ensure upon creation and insertion that their contents are valid.

    • Method Detail

      • keySet

        Set<K> keySet()
        Returns:
        A set of keys which are known to be valid. That is, those that currently are known to have a constraint. This includes all keys which currently have a value, but additional keys may be included. In other words, get(Object) may return null for some keys included in this set.

      • get

        Object get​(K key)
        Get the mapped value for key, or null if no value is currently mapped. If this method ever returns a non-null value, getConstraint(Object) for the same key will from that point forward return the same matching non-null constraint.
        Returns:
        the mapped value or null

      • getConstraint

        IConstraint<?> getConstraint​(K key)
        Get a constraint for mapped values of key, if a constraint has been imposed for key.
        Returns:
        a constraint or null

      • getPersistableString

        String getPersistableString​(K key)
        Get the persistable string of the mapped value for key, or null if no value is currently mapped. If this method ever returns a non-null value, getConstraint(Object) for the same key will from that point forward return the same matching non-null constraint.
        Returns:
        a persistable string or null

      • emptyWithSameConstraints

        IMutableConstrainedMap<K> emptyWithSameConstraints()
        Create an empty mutable map, with the same initial constraints as this map. It might be possible to add constraints to the created map, depending on the restrictions built into this map.

      • mutableCopy

        IMutableConstrainedMap<K> mutableCopy()
        Create a mutable copy of this map, containing the same initial values as this map. It might be possible to add constraints to the copy, depending on the restrictions built into this map.