ADBA javadoc issues
Mark Rotteveel
mark at lawinegevaar.nl
Mon May 7 16:04:56 UTC 2018
I notice that in the ADBA javadoc, a lot of @link and @see links are
syntactically invalid.
For example in DataSource, the {@link getConnection} should be {@link
#getConnection()}, and there are a lot of example.
I notice these problems in:
- AdbaConnectionProperty
- AdbaType
- Connection
- ConnectionProperty
- DataSource
- Result
- SqlBlob
- SqlClob
- Submission
- Transaction
The following classes have sparse javadoc and may need more:
- Connection.LifeCycle (especially the boolean getters)
- SqlException (especially the constructors)
- SqlSkippedException
Need documentation
- DataSource.close()
I notice that occasionally covariant overrides get documented, and some
times not, while the override is not really adding new information (eg
DynamicMultiOperation.onError(Consumer<Throwable> handler) vs other
overrides in the same class).
Mark
--
Mark Rotteveel
More information about the jdbc-spec-discuss
mailing list