Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Received-SPF: pass (nike.apache.org: domain of sebbaz@gmail.com designates
 209.85.216.43 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type
         :content-transfer-encoding;
        b=KFmu3G6j6IwcBpMlEU178O4trnQ07Y29Hes/iK7ccOOLSkqoRcvoEDhxfNkEndG+bQ
         5uYAFrMlCXmfn+v8OhdoRrOtRPk6QKvU+CDYtMQp7afTAxXBR74HJTDHSV3Eix4NXUrH
         Sv488r5+kauZ2sxV1OfLqDz8NfTLmGLz4IJoo=
MIME-Version: 1.0
Date: Thu, 4 Nov 2010 01:48:43 +0000
Message-ID: <AANLkTinww=CjgSh9MP_6R1C+sRYUdsfLkuzTOeO95eSR@mail.gmail.com>
Subject: Re: svn commit: r1030464 [1/3] - in /commons/proper/math/trunk/src:
 main/java/org/apache/commons/math/
 main/java/org/apache/commons/math/analysis/
 main/java/org/apache/commons/math/analysis/integration/
 main/java/org/apache/commons/math/analysis/inte
From: sebb <sebbaz@gmail.com>
To: Commons Developers List <dev@commons.apache.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On 4 November 2010 01:31, Brent Worden <brent.worden@gmail.com> wrote:
> On 11/3/2010 8:10 PM, Bill Barker wrote:
>>>
>>> =A0*/
>>> public interface UnivariateRealFunction {
>>> -
>>> =A0 =A0/**
>>> - =A0 =A0 * Compute the value for the function.
>>> - =A0 =A0 * @param x the point for which the function value should be
>>> computed
>>> - =A0 =A0 * @return the value
>>> - =A0 =A0 * @throws FunctionEvaluationException if the function evaluat=
ion
>>> fails
>>> + =A0 =A0 * Compute the value of the function.
>>> + =A0 =A0 *
>>> + =A0 =A0 * @param x Point at which the function value should be comput=
ed.
>>> + =A0 =A0 * @return the value.
>>> =A0 =A0 */
>>> - =A0 =A0double value(double x) throws FunctionEvaluationException;
>>> -
>>> + =A0 =A0double value(double x);
>>> }
>>>
>> =A0* @version $Revision$ $Date$
>>
>> IMHO we still need the @throws line in the javadoc. =A0Otherwise end use=
rs
>> are going to get a nasty surprise when they get an unchecked exception
>> thrown.
>>
>>
> +1. =A0This is a nicety other commons projects have employed and is indee=
d
> quite useful during development.

Also, the abstract class that implements the interface -
ComposableFunction - has the method sig:

public abstract double value(double x) throws FunctionEvaluationException;

It's confusing that the interface and class don't agree.

> Thanks,
>
> Brent.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org