Class Characteristics


  • public final class Characteristics
    extends java.lang.Object
    Collection of immutable properties, holding behaviour characteristics. See The PicoContainer Website for details on the usage of Characteristics.
    Author:
    Paul Hammant
    See Also:
    ComponentAdapter, Behavior
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.util.Properties AUTOMATIC  
      static java.util.Properties CACHE
      Turns on Caching of component instances.
      static java.util.Properties CDI
      Turns on constructor injection.
      static java.util.Properties EMJECTION_ENABLED  
      static java.util.Properties ENABLE_CIRCULAR  
      static java.lang.String FALSE
      Since properties use strings, we supply String constants for Boolean conditions.
      static java.util.Properties GUARD  
      static java.util.Properties HIDE_IMPL
      Turns on implementation hiding.
      static java.util.Properties LOCK
      Uses a java.util.concurrent.Lock to provide faster access than synchronized.
      static java.util.Properties METHOD_INJECTION
      Turns on Method Injection.
      static java.util.Properties NO_CACHE
      Turns off Caching of component instances.
      static java.util.Properties NO_HIDE_IMPL
      Turns off implementation hiding.
      static java.util.Properties NO_LOCK
      Turns off locking synchronization.
      static java.util.Properties NO_PROPERTY_APPLYING
      Turns off bean-setting property applications.
      static java.util.Properties NO_SINGLE
      Synonym for NO_CACHE.
      static java.util.Properties NO_SYNCHRONIZE
      Turns off synchronized access to the component instance.
      static java.util.Properties NONE  
      static java.util.Properties PROPERTY_APPLYING
      Turns on bean-setting property applications where certain simple properties are set after the object is created based.
      static java.util.Properties SDI
      Turns on Setter Injection.
      static java.util.Properties SINGLE
      Synonym for CACHE.
      static java.util.Properties SYNCHRONIZE
      Turns on synchronized access to the component instance.
      static java.lang.String TRUE
      Since properties use strings, we supply String constants for Boolean conditions.
      static java.util.Properties USE_NAMES  
    • Constructor Summary

      Constructors 
      Constructor Description
      Characteristics()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.util.Properties GUARD​(java.lang.String with)  
      static java.util.Properties immutable​(java.lang.String name, java.lang.String value)
      Transforms a single name value pair unto a read only Properties instance.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • FALSE

        public static final java.lang.String FALSE
        Since properties use strings, we supply String constants for Boolean conditions.
        See Also:
        Constant Field Values
      • TRUE

        public static final java.lang.String TRUE
        Since properties use strings, we supply String constants for Boolean conditions.
        See Also:
        Constant Field Values
      • CDI

        public static final java.util.Properties CDI
        Turns on constructor injection.
        See Also:
        ConstructorInjection
      • SDI

        public static final java.util.Properties SDI
        Turns on Setter Injection.
        See Also:
        SetterInjection
      • METHOD_INJECTION

        public static final java.util.Properties METHOD_INJECTION
        Turns on Method Injection.
      • NO_CACHE

        public static final java.util.Properties NO_CACHE
        Turns off Caching of component instances. (Often referred to in other circles as singleton).
        See Also:
        Caching
      • CACHE

        public static final java.util.Properties CACHE
        Turns on Caching of component instances. (Often referred to in other circles as singleton)
        See Also:
        Caching
      • SYNCHRONIZE

        public static final java.util.Properties SYNCHRONIZE
        Turns on synchronized access to the component instance. (Under JDK 1.5 conditions, it will be better to use LOCK instead.
        See Also:
        Synchronizing
      • NO_SYNCHRONIZE

        public static final java.util.Properties NO_SYNCHRONIZE
        Turns off synchronized access to the component instance.
        See Also:
        Synchronizing
      • LOCK

        public static final java.util.Properties LOCK
        Uses a java.util.concurrent.Lock to provide faster access than synchronized.
        See Also:
        Locking
      • NO_LOCK

        public static final java.util.Properties NO_LOCK
        Turns off locking synchronization.
        See Also:
        Locking
      • SINGLE

        public static final java.util.Properties SINGLE
        Synonym for CACHE.
        See Also:
        Caching
      • NO_SINGLE

        public static final java.util.Properties NO_SINGLE
        Synonym for NO_CACHE.
        See Also:
        Caching
      • HIDE_IMPL

        public static final java.util.Properties HIDE_IMPL
        Turns on implementation hiding. You may use the JDK Proxy implementation included in this version, or the ASM-based implementation hiding method included in PicoContainer Gems. However, you cannot use both in a single PicoContainer instance.
      • NO_HIDE_IMPL

        public static final java.util.Properties NO_HIDE_IMPL
        Turns off implementation hiding.
        See Also:
        for more information.
      • ENABLE_CIRCULAR

        public static final java.util.Properties ENABLE_CIRCULAR
      • NONE

        public static final java.util.Properties NONE
      • PROPERTY_APPLYING

        public static final java.util.Properties PROPERTY_APPLYING
        Turns on bean-setting property applications where certain simple properties are set after the object is created based.
      • NO_PROPERTY_APPLYING

        public static final java.util.Properties NO_PROPERTY_APPLYING
        Turns off bean-setting property applications.
        See Also:
        PropertyApplying
      • AUTOMATIC

        public static final java.util.Properties AUTOMATIC
      • USE_NAMES

        public static final java.util.Properties USE_NAMES
      • EMJECTION_ENABLED

        public static final java.util.Properties EMJECTION_ENABLED
      • GUARD

        public static final java.util.Properties GUARD
    • Constructor Detail

      • Characteristics

        public Characteristics()
    • Method Detail

      • GUARD

        public static final java.util.Properties GUARD​(java.lang.String with)
      • immutable

        public static java.util.Properties immutable​(java.lang.String name,
                                                     java.lang.String value)
        Transforms a single name value pair unto a read only Properties instance.

        Example Usage:

                        Properties readOnly = immutable("oneKey","oneValue"};
                        assert readOnly.getProperty("oneKey") != null);
         
        Parameters:
        name - the property key.
        value - the property value.
        Returns:
        Read Only properties instance.