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