----- "Gilles Sadowski" <gil...@harfang.homelinux.org> a écrit :

> Hi.
> 
> > >public interface UnivariateRealFunction {
> > >-
> > >    /**
> > >-     * Compute the value for the function.
> > >-     * @param x the point for which the function value should be
> computed
> > >-     * @return the value
> > >-     * @throws FunctionEvaluationException if the function
> > >evaluation fails
> > >+     * Compute the value of the function.
> > >+     *
> > >+     * @param x Point at which the function value should be
> computed.
> > >+     * @return the value.
> > >     */
> > >-    double value(double x) throws FunctionEvaluationException;
> > >-
> > >+    double value(double x);
> > >}
> > >
> > 
> > IMHO we still need the @throws line in the javadoc.  Otherwise end
> > users are going to get a nasty surprise when they get an unchecked
> > exception thrown.
> > 
> 
> Any existing user code (throwing a "FunctionEvaluationException" at
> some
> point and catching it at another) will still work the same as before
> (provided they change the "import" statement). No surprise to be
> expected.

So go ahead with the change, removing the throws from the declaration but 
keeping the javadoc as suggested previously.

Luc

> 
> 
> Best,
> Gilles
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
> For additional commands, e-mail: dev-h...@commons.apache.org

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

Reply via email to