commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Gary Gregory (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (LANG-1134) New methods for lang3.Validate
Date Mon, 25 Apr 2016 21:40:12 GMT

    [ https://issues.apache.org/jira/browse/LANG-1134?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15257098#comment-15257098
] 

Gary Gregory commented on LANG-1134:
------------------------------------

IMO, the whole class should be deprecated and moved to [validator]. It is confusing and lame
IMO that we have two validation thingies in Commons.

> New methods for lang3.Validate
> ------------------------------
>
>                 Key: LANG-1134
>                 URL: https://issues.apache.org/jira/browse/LANG-1134
>             Project: Commons Lang
>          Issue Type: Improvement
>          Components: lang.*
>    Affects Versions: 3.4
>            Reporter: Stardust
>            Assignee: Charles Honton
>            Priority: Minor
>             Fix For: Review Patch, 3.5
>
>
> These are suggestions for new methods for the Validate class.
> h1. Floating point values
> h2. notNaN(value)
> Throws an exception if value != value .
> {code}double value;
> value = Double.NaN;
> Validate.notNaN(value);    // Throws exception
> value = 1.0;
> Validate.notNaN(value);    // Validates
> value = Double.POSITIVE_INFINITY;
> Validate.notNaN(value);    // Validates{code}
> h2. finite(value)
> Validates that the argument contains a numeric value (not NaN or infinite).
> {code}double value;
> value = Double.NaN;
> Validate.finite(value);    // Throws exception
> value = Double.POSITIVE_INFINITY;
> Validate.finite(value);    // Throws exception
> value = 1.0;
> Validate.finite(value);    // Validates{code}
> h1. Integers and floats
> The following methods are overloaded to accept both integers and floating point values.
> h2. greater(reference, value), greaterOrEqual(reference, value)
> Ensures the argument is greater than (or equal to) a given value.
> {code}double value;
> value = 0.0;
> Validate.greater(0.0, value);    // Throws exception
> Validate.greaterOrEqual(0.0, value); // Validates
> value = Double.POSITIVE_INFINITY;
> Validate.greater(0.0, value);    // Validates
> value = Double.NaN;
> Validate.greater(0.0, value);    // Throws exception{code}
> h2. smaller(reference, value), smallerOrEqual(reference, value)
> Ensures the argument is smaller than (or equal to) a given value. Does the opposite of
greater(), see example above.
> h2. different(reference, value)
> Ensures the argument is not equal to a given value. A typical use case would be to accept
only non-zero values.
> {code}double value;
> value = 0.0;
> Validate.different(0.0, value);    // Throws exception
> Validate.different(1.0, value);    // Validates
> value = Double.NaN;
> Validate.different(0.0, value);    // Validates{code}



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message