Return-Path: X-Original-To: apmail-tamaya-commits-archive@minotaur.apache.org Delivered-To: apmail-tamaya-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 1CC7D1092D for ; Mon, 2 Mar 2015 21:36:41 +0000 (UTC) Received: (qmail 27719 invoked by uid 500); 2 Mar 2015 21:36:41 -0000 Delivered-To: apmail-tamaya-commits-archive@tamaya.apache.org Received: (qmail 27694 invoked by uid 500); 2 Mar 2015 21:36:41 -0000 Mailing-List: contact commits-help@tamaya.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@tamaya.incubator.apache.org Delivered-To: mailing list commits@tamaya.incubator.apache.org Received: (qmail 27684 invoked by uid 99); 2 Mar 2015 21:36:40 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Mar 2015 21:36:40 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED,T_RP_MATCHES_RCVD X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO mail.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with SMTP; Mon, 02 Mar 2015 21:36:15 +0000 Received: (qmail 23214 invoked by uid 99); 2 Mar 2015 21:35:55 -0000 Received: from eris.apache.org (HELO hades.apache.org) (140.211.11.105) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Mar 2015 21:35:55 +0000 Received: from hades.apache.org (localhost [127.0.0.1]) by hades.apache.org (ASF Mail Server at hades.apache.org) with ESMTP id 60FBFAC0840 for ; Mon, 2 Mar 2015 21:35:55 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1663440 [14/16] - in /incubator/tamaya/site/trunk/content: ./ javadoc/ javadoc/api/ javadoc/api/index-files/ javadoc/api/org/ javadoc/api/org/apache/ javadoc/api/org/apache/tamaya/ javadoc/api/org/apache/tamaya/spi/ javadoc/core/ javadoc/c... Date: Mon, 02 Mar 2015 21:35:52 -0000 To: commits@tamaya.incubator.apache.org From: anatole@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20150302213555.60FBFAC0840@hades.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/ZoneIdConverter.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/ZoneIdConverter.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/ZoneIdConverter.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/ZoneIdConverter.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,287 @@ + + + + + +ZoneIdConverter + + + + + + + + + + + + +
+
org.apache.tamaya.core.internal.converters
+

Class ZoneIdConverter

+
+
+
    +
  • java.lang.Object
  • +
  • +
      +
    • org.apache.tamaya.core.internal.converters.ZoneIdConverter
    • +
    +
  • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    org.apache.tamaya.PropertyConverter<java.time.ZoneId>
    +
    +
    +
    +
    public class ZoneIdConverter
    +extends java.lang.Object
    +implements org.apache.tamaya.PropertyConverter<java.time.ZoneId>
    +
    Converter, converting from String to ZoneId. Valid inputs are as defined by ZoneId.of(String).
    +
  • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      ZoneIdConverter() 
      +
    • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.time.ZoneIdconvert(java.lang.String value) +
      Convert the given configuration keys from it' String representation into the required target type.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • +
      +
    • +
    +
  • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        ZoneIdConverter

        +
        public ZoneIdConverter()
        +
      • +
      +
    • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        convert

        +
        public java.time.ZoneId convert(java.lang.String value)
        +
        Description copied from interface: org.apache.tamaya.PropertyConverter
        +
        Convert the given configuration keys from it' String representation into the required target type.
        +
        +
        Specified by:
        +
        convert in interface org.apache.tamaya.PropertyConverter<java.time.ZoneId>
        +
        Parameters:
        +
        value - the configuration keys
        +
        Returns:
        +
        converted keys
        +
        +
      • +
      +
    • +
    +
  • +
+
+
+ + + + + + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-frame.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-frame.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-frame.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-frame.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,39 @@ + + + + + +org.apache.tamaya.core.internal.converters + + + + + +

org.apache.tamaya.core.internal.converters

+ + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-summary.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-summary.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-summary.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-summary.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,348 @@ + + + + + +org.apache.tamaya.core.internal.converters + + + + + + + + + + + +
+

Package org.apache.tamaya.core.internal.converters

+
+
+
    +
  • + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Class Summary 
    ClassDescription
    BigDecimalConverter +
    Converter, converting from String to BigDecimal, the supported format is one of the following: + + 232573527352.76352753 + -23257352.735276352753 + -0xFFFFFF (integral numbers only) + -0XFFFFAC (integral numbers only) + 0xFFFFFF (integral numbers only) + 0XFFFFAC (integral numbers only) +
    +
    BigIntegerConverter +
    Converter, converting from String to BigInteger, the supported format is one of the following: + + 0xFFFFFF + 0XFFFFAC + 23257352735276352753 + -0xFFFFFF + -0XFFFFAC + -23257352735276352753 +
    +
    BooleanConverter +
    Converter, converting from String to Boolean.
    +
    ByteConverter +
    Converter, converting from String to Byte, the supported format is one of the following: + + 123 (byte value) + 0xFF (byte value) + 0XDF (byte value) + 0D1 (byte value) + -123 (byte value) + -0xFF (byte value) + -0XDF (byte value) + -0D1 (byte value) + MIN_VALUE (ignoring case) + MIN (ignoring case) + MAX_VALUE (ignoring case) + MAX (ignoring case) +
    +
    CharConverter +
    Converter, converting from String to Character, the supported format is one of the following: + + 'a' + 123 (byte value) + 0xFF (byte value) + 0XDF (byte value) + 0D1 (byte value) +
    +
    ClassConverter +
    Converter, converting from String to Class, hereby using the following classloaders: + + The current ThreadContext ClassLoader + The Classloader of this class + The system Classloader +
    +
    CurrencyConverter +
    Converter, converting from String to Currency, the supported format is one of the following: + + CHF (currency code) + 123 (numeric currency value >= 0) + DE (ISO 2-digit country) + de_DE, de_DE_123 (Locale) +
    +
    DoubleConverter +
    Converter, converting from String to Double, using the Java number syntax: + (-)?
    +
    EnumConverter<T> +
    Converter, converting from String to tge given enum type.
    +
    FloatConverter +
    Converter, converting from String to Float, using the Java number syntax: + (-)?
    +
    IntegerConverter +
    Converter, converting from String to Integer, the supported format is one of the following: + + 123 (byte value) + 0xFF (byte value) + 0XDF (byte value) + 0D1 (byte value) + -123 (byte value) + -0xFF (byte value) + -0XDF (byte value) + -0D1 (byte value) + MIN_VALUE (ignoring case) + MIN (ignoring case) + MAX_VALUE (ignoring case) + MAX (ignoring case) +
    +
    LocalDateConverter +
    Converter, converting from String to LocalDate.
    +
    LocalDateTimeConverter +
    Converter, converting from String to LocalDateTime.
    +
    LocalTimeConverter +
    Converter, converting from String to LocalTime.
    +
    LongConverter +
    Converter, converting from String to Long, the supported format is one of the following: + + 123 (byte value) + 0xFF (byte value) + 0XDF (byte value) + 0D1 (byte value) + -123 (byte value) + -0xFF (byte value) + -0XDF (byte value) + -0D1 (byte value) + MIN_VALUE (ignoring case) + MIN (ignoring case) + MAX_VALUE (ignoring case) + MAX (ignoring case) +
    +
    NumberConverter +
    Converter, converting from String to Number.
    +
    ShortConverter +
    Converter, converting from String to Short, the supported format is one of the following: + + 123 (byte value) + 0xFF (byte value) + 0XDF (byte value) + 0D1 (byte value) + -123 (byte value) + -0xFF (byte value) + -0XDF (byte value) + -0D1 (byte value) + MIN_VALUE (ignoring case) + MIN (ignoring case) + MAX_VALUE (ignoring case) + MAX (ignoring case) +
    +
    URiConverter +
    Converter, converting from String to URI, using new URI(value).
    +
    URLConverter +
    Converter, converting from String to URI, using new URL(value).
    +
    ZoneIdConverter +
    Converter, converting from String to ZoneId.
    +
    +
  • +
+
+ + + + + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-tree.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-tree.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-tree.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/converters/package-tree.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,154 @@ + + + + + +org.apache.tamaya.core.internal.converters Class Hierarchy + + + + + + + + + + + +
+

Hierarchy For Package org.apache.tamaya.core.internal.converters

+Package Hierarchies: + +
+
+

Class Hierarchy

+
    +
  • java.lang.Object +
      +
    • org.apache.tamaya.core.internal.converters.BigDecimalConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.BigIntegerConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.BooleanConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.ByteConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.CharConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.ClassConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.CurrencyConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.DoubleConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.EnumConverter<T> (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.FloatConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.IntegerConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.LocalDateConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.LocalDateTimeConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.LocalTimeConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.LongConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.NumberConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.ShortConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.URiConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.URLConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    • org.apache.tamaya.core.internal.converters.ZoneIdConverter (implements org.apache.tamaya.PropertyConverter<T>)
    • +
    +
  • +
+
+ + + + + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-frame.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-frame.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-frame.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-frame.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,27 @@ + + + + + +org.apache.tamaya.core.internal + + + + + +

org.apache.tamaya.core.internal

+ + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-summary.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-summary.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-summary.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-summary.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,184 @@ + + + + + +org.apache.tamaya.core.internal + + + + + + + + + + + +
+

Package org.apache.tamaya.core.internal

+
+
+ +
+ + + + + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-tree.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-tree.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-tree.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/internal/package-tree.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,142 @@ + + + + + +org.apache.tamaya.core.internal Class Hierarchy + + + + + + + + + + + +
+

Hierarchy For Package org.apache.tamaya.core.internal

+Package Hierarchies: + +
+
+

Class Hierarchy

+ +
+ + + + + + Added: incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/propertysource/BasePropertySource.html URL: http://svn.apache.org/viewvc/incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/propertysource/BasePropertySource.html?rev=1663440&view=auto ============================================================================== --- incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/propertysource/BasePropertySource.html (added) +++ incubator/tamaya/site/trunk/content/javadoc/core/org/apache/tamaya/core/propertysource/BasePropertySource.html Mon Mar 2 21:35:50 2015 @@ -0,0 +1,436 @@ + + + + + +BasePropertySource + + + + + + + + + + + + +
+
org.apache.tamaya.core.propertysource
+

Class BasePropertySource

+
+
+
    +
  • java.lang.Object
  • +
  • +
      +
    • org.apache.tamaya.core.propertysource.BasePropertySource
    • +
    +
  • +
+
+
    +
  • +
    +
    All Implemented Interfaces:
    +
    org.apache.tamaya.spi.PropertySource
    +
    +
    +
    Direct Known Subclasses:
    +
    EnvironmentPropertySource, PropertiesFilePropertySource, SystemPropertySource
    +
    +
    +
    +
    public abstract class BasePropertySource
    +extends java.lang.Object
    +implements org.apache.tamaya.spi.PropertySource
    +
    A base class for PropertySources. It provides a initializeOrdinal(int) method that + reads the ordinal from the config source itself, allowing the ordinal to be "self-configured" by + the configuration read.
    +
  • +
+
+
+
    +
  • + +
      +
    • + + +

      Field Summary

      +
        +
      • + + +

        Fields inherited from interface org.apache.tamaya.spi.PropertySource

        +TAMAYA_ORDINAL
      • +
      +
    • +
    + +
      +
    • + + +

      Constructor Summary

      + + + + + + + + +
      Constructors 
      Constructor and Description
      BasePropertySource() 
      +
    • +
    + +
      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + +
      All Methods Instance Methods Concrete Methods 
      Modifier and TypeMethod and Description
      java.lang.Stringget(java.lang.String key) +
      Access a property.
      +
      intgetOrdinal() +
      Lookup order: + TODO rethink whole default PropertySources and ordering: + TODO introduce default values or constants for ordinals + + System properties (ordinal 400) + Environment properties (ordinal 300) + JNDI values (ordinal 200) + Properties file values (/META-INF/applicationConfiguration.properties) (ordinal 100) + +

      + Important Hints for custom implementations: + + If a custom implementation should be invoked before the default implementations, use a value > 400 + + + If a custom implementation should be invoked after the default implementations, use a value < 100 + +

      + Reordering of the default order of the config-sources: + Example: If the properties file/s should be used before the other implementations, + you have to configure an ordinal > 400.

      +
      protected voidinitializeOrdinal(int defaultOrdinal) +
      Initializing the ordinal of this PropertySource with the given defaultOrdinal.
      +
      booleanisScannable() +
      Determines if this config source could be scanned for its list of properties.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • +
      +
        +
      • + + +

        Methods inherited from interface org.apache.tamaya.spi.PropertySource

        +getName, getProperties
      • +
      +
    • +
    +
  • +
+
+
+
    +
  • + +
      +
    • + + +

      Constructor Detail

      + + + +
        +
      • +

        BasePropertySource

        +
        public BasePropertySource()
        +
      • +
      +
    • +
    + +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getOrdinal

        +
        public int getOrdinal()
        +
        Description copied from interface: org.apache.tamaya.spi.PropertySource
        +
        Lookup order: + TODO rethink whole default PropertySources and ordering: + TODO introduce default values or constants for ordinals +
          +
        1. System properties (ordinal 400)
        2. +
        3. Environment properties (ordinal 300)
        4. +
        5. JNDI values (ordinal 200)
        6. +
        7. Properties file values (/META-INF/applicationConfiguration.properties) (ordinal 100)
        8. +
        +

        +

        Important Hints for custom implementations:

        +

        + If a custom implementation should be invoked before the default implementations, use a value > 400 +

        +

        + If a custom implementation should be invoked after the default implementations, use a value < 100 +

        +

        +

        Reordering of the default order of the config-sources:

        +

        Example: If the properties file/s should be used before the other implementations, + you have to configure an ordinal > 400. That means, you have to add e.g. deltaspike_ordinal=401 to + /META-INF/apache-deltaspike.properties . Hint: In case of property files every file is handled as independent + config-source, but all of them have ordinal 400 by default (and can be reordered in a fine-grained manner.

        +
        +
        Specified by:
        +
        getOrdinal in interface org.apache.tamaya.spi.PropertySource
        +
        Returns:
        +
        the 'importance' aka ordinal of the configured values. The higher, the more important. + //X TODO think about making this a default method which returns default priority
        +
        +
      • +
      + + + +
        +
      • +

        get

        +
        public java.lang.String get(java.lang.String key)
        +
        Description copied from interface: org.apache.tamaya.spi.PropertySource
        +
        Access a property. + + //X TODO discuss if the key can be null
        +
        +
        Specified by:
        +
        get in interface org.apache.tamaya.spi.PropertySource
        +
        Parameters:
        +
        key - the property's key, not null.
        +
        Returns:
        +
        the property's keys.
        +
        +
      • +
      + + + +
        +
      • +

        isScannable

        +
        public boolean isScannable()
        +
        Description copied from interface: org.apache.tamaya.spi.PropertySource
        +
        Determines if this config source could be scanned for its list of properties. + +

        + PropertySources which are not scannable might not be able to find all the + configured values to provide via PropertySource.getProperties(). This can e.g. happen + if the underlying storage doesn't support listing. +

        +
        +
        Specified by:
        +
        isScannable in interface org.apache.tamaya.spi.PropertySource
        +
        Returns:
        +
        true if this PropertySource could be scanned for its list of properties, + false if it should not be scanned.
        +
        +
      • +
      + + + +
        +
      • +

        initializeOrdinal

        +
        protected void initializeOrdinal(int defaultOrdinal)
        +
        Initializing the ordinal of this PropertySource with the given defaultOrdinal. + + If PropertySource.TAMAYA_ORDINAL is present via get(String) and the + value is a valid Integer then, the defaultOrdinal will be overridden.
        +
        +
        Parameters:
        +
        defaultOrdinal - of the PropertySource
        +
        +
      • +
      +
    • +
    +
  • +
+
+
+ + + + + + +