Package org.apache.openjpa.lib.conf

Class Value

    • Method Detail

      • getProperty

        public String getProperty()
        The property name that will be used when setting or getting this value in a Map.

      • setProperty

        public void setProperty​(String prop)
        The property name that will be used when setting or getting this value in a Map.

      • addEquivalentKey

        public void addEquivalentKey​(String other)
        Adds a moniker that is equivalent to the original property key used during construction.
        Since:
        2.0.0

      • getEquivalentKeys

        public Set<String> getEquivalentKeys()
        Gets the unmodifiable view of the equivalent keys or an empty set if no equivalent key has been added.
        Since:
        2.0.0

      • getPropertyKeys

        public List<String> getPropertyKeys()
        Gets unmodifiable view of all the property keys set on this receiver. The 0-th element in the returned list is always the same as the original key returned by getProperty() method.
        Since:
        2.0.0

      • matches

        public boolean matches​(String p)
        Affirms if the given key matches the property (or any of its equivalent).
        Since:
        2.0.0

      • getLoadKey

        public String getLoadKey()
        The key under which this value was loaded, or null.

      • setLoadKey

        public void setLoadKey​(String key)
        Sets key under which this value was loaded.

      • getAliases

        public String[] getAliases()
        Aliases for the value in the form key1, value1, key2, value2, ... All alias values must be in string form.

      • setAliases

        public void setAliases​(String[] aliases)
        Aliases for the value in the form key1, value1, key2, value2, ... All alias values must be in string form.

        To avoid potential side-effects, this method copies the array passed in.

      • setAlias

        public void setAlias​(String key,
                     String value)
        Replaces an existing alias, or adds the given alias to the front of the alias list if it does not already exist. All alias values must be in string form.

      • setAlias

        protected String[] setAlias​(String key,
                            String value,
                            String[] aliases)
        Set an alias into a current alias list, returning the new list.

      • isAliasListComprehensive

        public boolean isAliasListComprehensive()
        Whether or not the alias list defines all possible settings for this value. If so, an error will be generated when attempting to invoke any method on this value with an unknown option.

      • setAliasListComprehensive

        public void setAliasListComprehensive​(boolean aliasListIsComprehensive)
        Whether or not the alias list defines all possible settings for this value. If so, an error will be generated when attempting to invoke any method on this value with an unknown option.

      • alias

        public String alias​(String str)
        Alias the given setting.

      • alias

        protected String alias​(String str,
                       String[] aliases,
                       boolean nullNotFound)
        Alias the given setting.

      • unalias

        public String unalias​(String str)
        Unalias the given setting.

      • unalias

        protected String unalias​(String str,
                         String[] aliases,
                         boolean nullNotFound)
        Unalias the given setting.

      • getDefault

        public String getDefault()
        The default value for the property as a string.

      • setDefault

        public void setDefault​(String def)
        The default value for the property as a string.

      • getInstantiatingGetter

        public String getInstantiatingGetter()
        The name of the getter method for the instantiated value of this property(as opposed to the string value)

      • setInstantiatingGetter

        public void setInstantiatingGetter​(String getter)
        The name of the getter method for the instantiated value of this property(as opposed to the string value). If the string starts with this., then the getter will be looked up on the value instance itself. Otherwise, the getter will be looked up on the configuration instance.

      • getScope

        public Class getScope()
        A class defining the scope in which this value is defined. This will be used by the configuration framework to look up metadata about the value.

      • setScope

        public void setScope​(Class cls)
        A class defining the scope in which this value is defined. This will be used by the configuration framework to look up metadata about the value.

      • getString

        public String getString()
        Return a stringified version of this value. If the current value has a short alias key, the alias key is returned.

      • setString

        public void setString​(String val)
        Set this value from the given string. If the given string is null or empty and a default is defined, the default is used. If the given string(or default) is an alias key, it will be converted to the corresponding value internally.
        If this Value is being set to a non-default value for the first time (as designated by originalString being null), then the value is remembered as original. This original value is used for equality and hashCode computation if this Value is dynamic.

      • setObject

        public void setObject​(Object obj)
        Set this value as an object.
        If this Value is being set to a non-default value for the first time (as designated by originalString being null), then the value is remembered as original. This original value is used for equality and hashCode computation if this Value is dynamic.

      • getOriginalValue

        public String getOriginalValue()
        Gets the original value. Original value denotes the Stringified form of this Value, from which it has been set, if ever. If this Value has never been set to a non-default value, then returns the default value, which itself can be null.
        Since:
        1.1.0

      • getValueType

        public abstract Class<?> getValueType()
        Returns the type of the property that this Value represents.

      • getInternalString

        protected abstract String getInternalString()
        Return the internal string form of this value.

      • setInternalString

        protected abstract void setInternalString​(String str)
        Set this value from the given string.

      • setInternalObject

        protected abstract void setInternalObject​(Object obj)
        Set this value from an object.

      • getListeners

        public List<ValueListener> getListeners()
        Gets unmodifable list of listeners for value changes.

      • addListener

        public void addListener​(ValueListener listener)
        Listener for value changes.

      • removeListener

        public void removeListener​(ValueListener listener)

      • valueChanged

        public void valueChanged()
        Subclasses should call this method when their internal value changes.

      • assertChangeable

        protected void assertChangeable()
        Asserts if this receiver can be changed. Subclasses must invoke this method before changing its internal state. This receiver can not be changed if all of the following is true
      • this receiver is not dynamic
      • ValueListener attached to this receiver is a Configuration
      • Configuration is read-only