Re: Java language and library suggestions
Tomas Mikula wrote:
On Jul 20, 1:43 am, Arne Vajh?j <a...@vajhoej.dk> wrote:
Tom Anderson wrote:
On Sun, 19 Jul 2009, Arne Vajh?j wrote:
Tomas Mikula wrote:
On Jul 19, 3:42 pm, Arne Vajh?j <a...@vajhoej.dk> wrote:
Tom Anderson wrote:
On Sun, 19 Jul 2009, Lew wrote:
Tomas Mikula wrote:
Anyway there are still many cases when one could use safely it
to get
more readable code.
Arne Vajh?j wrote:
It can happen, but I don't think it occur frequently enough to
justify a feature that is so easy to misuse.
Tomas Mikula wrote:
I disagree again. Almost everything can be misused. If someone feels
like their code never throws an exception, they could tend to
write an
empty exception handler:
try {
// code that is incorrectly assumed not to throw any exception
} catch(Exception e) { }
If the Exception can actually be thrown and should be handled,
this is
very bad.
I guess that the following would be a much better (although still
bad)
solution in this case.
@safe
// code that is incorrectly assumed not to throw any exception
So even if it's going to be misused, it could eventually restrain
from
worse things.
"could" != "would".
The proposed language feature would be a change to the language that
would be easy to misuse, might just possibly (if you're right) help
ever-so-slightly in some corner cases, in order to save a little bit
of typing. It doesn't seem like a good tradeoff. Just write the
damn
exception handler and quit complaining.
This *is* an exception handler! It's shorthand for:
try {
STATEMENT
}
catch (EXCEPTION e) {
throw new AssertionError(e);
}
How is that not an exception handler?
It is an exception handler.
But it is converting the exception that the designer of the API
being called consider a real possibility to an exception that should
never happen by the designer of the calling code.
The designer of the API may as well state that the declared exception
will only be thrown under certain circumstances. If I avoided these
circumstances, then the exception won't be thrown. I will provide an
example:
class WriterEncoder {
public WriterEncoder(Writer w);
/** @throws IOException if and only if the write() methods of
underlying Writer throw an exception. */
public void writeEncoded(MyClass obj) throws IOException;
}
Now if I construct the WriterEncoder with StringWriter which does not
throw IOException on write, I can be sure that
WriterEncoder.writeEncoded() won't throw IOException either.
Yes.
But it is very bad code.
The safe construct is relying on knowledge about implementation of
both the calling and the called code instead of just relying on the
exposed API's.
But this is complete nonsense! That example DOES only rely on the
exposed APIs!
No.
It relies on:
1) that it is indeed a StringWriter and not another writer that gets
passed in as argument
The very same method that uses @Safe passed StringWriter to the
constructor of WriterEncoder just a couple of lines before. So the
method is only relying on itself.
I don't think "the declaration of the argument is probably just
a few lines above" is a good argument in software development.
It may start there and then be refactored to somewhere else.
2) that writeEncoded only throws IOException if the passed Writer
throws IOException.
Bad code.
WriterEncoder.writeEncoded's API specifies that it throws the same
checked exceptions as the writer's write method.
No it does not.
WriterEncoder.writeEncoded's API specifies that it
throw IOException. It does not say anything about
when it does it.
The API can't fully express the semantics.
>
If the semantics of WriterEncoder changes without generating compiler
warning or error, that is a bad decision of the WriterEncoder
designer.
No no.
He is not changing anything.
He gave you an API where he said that he might throw an
exception.
You decided to code against his implementation instead
of the API he gave you.
He changed the implementation without changing the API.
Your code broke.
You violated the rules of encapsulation.
He was doing good OOP.
And you can't avoid this risk of changing semantics with almost
anything.
Maybe not. But in this case the API actually provides the
information that it may throw an exception.
The fact that some information may be missing is not a good
argument to ignore the information provided.
You rely on the documentation all the time. For example, is
it a bad practice to rely on java.sql.Statement.close() to close
associated ResultSet? (I guess you will say yes, so I provide another
example.)
In this case the JDBC specification says that the implementation
must do that, so that it is not up to the implementer whether
what he does.
It can still be argued that it is good to do it explicit,
because the implementation may have an error.
It would still be an error in the implementation, but
defensive programming is good.
Is it bad to rely on String.length() to return non-negative
value? The String.length's API specifies that it returns int. It does
not say anything about the particular value of returned int.
No, but it has to return the length. Length can not be negative.
So a correct implementation will always return an int >= 0.
Again this is not something that is left to the implementation.
StringWriter.write
declares that it throws no checked exceptions. Therefore, if you use
WriterEncoder.writeEncoded with a StringWriter,
But the day the code is changed to pass another Writer, then
the code still compiles fine, but the code is broken.
As usual happens when coding to implementation instead of
interface.
you are permitted to
conclude that it won't throw any checked exceptions. That is not bad
code, and it is not relying on knowledge of implementation details.
It is bad code, because it makes two assumptions about
implementation.
Summarized:
- it doesn't do the first assumption
It does.
- you do the second kind of assumptions all the time
1) That does not make it good.
2) And it is hopefully very rare that such blatant violations of
OOP encapsulation are done
Arne