Can I modify the interface?

[David Kachen]

Hi all,

I want to add some methods throws IllegalArgumentException. In the implementation, I plan to check the parameters and if with them that something is wrong, I will throw IllegalArgumentException. It is admissible?

Best Regards..

[Carlos Morillo]

Hi David,


Yes, you can do that, but there is no need to change the signature of the Sun interface methods,
since IllegalArgumentException extends RuntimeException and therefore it is NOT a checked Exception.

Hope this helps,


Carlos.

[David Kachen]

Carlos, you are right..
But I mean a javadoc. In the javadoc I need to list all possible situations.
If I pre-suppose that IllegalArgumentException may be thrown, I need to describe it in the javadoc.
Such changes are allowed?

[Carlos Morillo]

No, there is no need.
You only document checked exceptions.

[Roel De Nijs]

No changes are allowed to Sun's interface! Creating your own interface and redefining each method could be an option (and that's what I did)

interface Sun {
  String[] read(int recNo);
}
interface Roel extends Sun {
  String[] read(int recNo) throws IllegalArgumentException;
}

[Roel De Nijs]

Carlos Morillo wrote:You only document checked exceptions.

I also documented in javadoc the unchecked exceptions, although I didn't mention them in the method signatures. Just like for example the compareTo method from class Date.

[David Kachen]

I'm not going to change the method signature, I just want to competently write Javadoc.

[David Kachen]

Roel, I understood you.

Thank you all