diff src/main/java/org/monetdb/jdbc/MonetConnection.java @ 626:06d69b82d409

Resolve javadoc error and warnings : [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetDriver.java:35: error: tag not supported in the generated HTML version: tt [javadoc] * <tt>jdbc:monetdb://&lt;host&gt;[:&lt;port&gt;]/&lt;database&gt;</tt> [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/io/LineType.java:58: warning: no @param for line [javadoc] public static final LineType classify(String line) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/io/LineType.java:58: warning: no @return [javadoc] public static final LineType classify(String line) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/io/LineType.java:72: warning: no @param for line [javadoc] public static final LineType classify(byte[] line) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/io/LineType.java:72: warning: no @return [javadoc] public static final LineType classify(byte[] line) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:1700: warning: no @return [javadoc] public UploadHandler getUploadHandler() { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:1716: warning: no @return [javadoc] public DownloadHandler getDownloadHandler() { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3511: warning: no @param for errorMessage [javadoc] public void sendError(final String errorMessage) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3511: warning: no @throws for java.io.IOException [javadoc] public void sendError(final String errorMessage) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3525: warning: no @return [javadoc] public InputStream getStream() throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3525: warning: no @throws for java.io.IOException [javadoc] public InputStream getStream() throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3539: warning: no @param for stream [javadoc] public void downloadTo(final OutputStream stream) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3539: warning: no @throws for java.io.IOException [javadoc] public void downloadTo(final OutputStream stream) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3553: warning: no description for @param [javadoc] * @param writer [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3555: warning: no @throws for java.io.IOException [javadoc] public void downloadTo(final Writer writer) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3336: warning: no @throws for java.io.IOException [javadoc] void handleDownload(Download handle, String name, boolean textMode) throws IOException; [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3367: warning: no @throws for java.io.IOException [javadoc] public void sendError(final String errorMessage) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3378: warning: no @param for chunkSize [javadoc] public void setChunkSize(final int chunkSize) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3387: warning: no @return [javadoc] public PrintStream getStream() throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3387: warning: no @throws for java.io.IOException [javadoc] public PrintStream getStream() throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3423: warning: no @param for inputStream [javadoc] public void uploadFrom(final InputStream inputStream) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3423: warning: no @throws for java.io.IOException [javadoc] public void uploadFrom(final InputStream inputStream) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3441: warning: no @throws for java.io.IOException [javadoc] public void uploadFrom(final BufferedReader reader, final long linesToSkip) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3456: warning: no @throws for java.io.IOException [javadoc] public void uploadFrom(final Reader reader) throws IOException { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetConnection.java:3308: warning: no @throws for java.io.IOException [javadoc] void handleUpload(Upload handle, String name, boolean textMode, long linesToSkip) throws IOException; [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/jdbc/MonetDatabaseMetaData.java:114: warning: @return has already been specified [javadoc] * @return negative of nullsAreSortedHigh() [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:732: warning: no @param for b [javadoc] public boolean setInsertFakePrompts(boolean b) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:732: warning: no @return [javadoc] public boolean setInsertFakePrompts(boolean b) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:1184: warning: no @return [javadoc] public UploadStream uploadStream(int chunkSize) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:1193: warning: no @return [javadoc] public UploadStream uploadStream() { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:1203: warning: no @return [javadoc] public DownloadStream downloadStream(boolean prependCr) { [javadoc] ^ [javadoc] /home/dinther/dev/javadev/src/main/java/org/monetdb/mcl/net/MapiSocket.java:1259: warning: no @param for cancellationCallback [javadoc] public void setCancellationCallback(final Runnable cancellationCallback) { [javadoc] ^ [javadoc] Building index for all the packages and classes... [javadoc] Building index for all classes... [javadoc] Building index for all classes... [javadoc] Generating /home/dinther/dev/javadev/doc/help-doc.html... [javadoc] 1 error [javadoc] 31 warnings
author Martin van Dinther <martin.van.dinther@monetdbsolutions.com>
date Thu, 20 Jan 2022 19:07:45 +0100 (2022-01-20)
parents 1c3cdf0667d7
children 849f99124e32
line wrap: on
line diff
--- a/src/main/java/org/monetdb/jdbc/MonetConnection.java
+++ b/src/main/java/org/monetdb/jdbc/MonetConnection.java
@@ -1695,7 +1695,7 @@ public class MonetConnection
 	}
 
 	/**
-	 * Returns the currently registerered {@link UploadHandler}, or null
+	 * @return the currently registerered {@link UploadHandler}, or null
 	 */
 	public UploadHandler getUploadHandler() {
 		return uploadHandler;
@@ -1711,7 +1711,7 @@ public class MonetConnection
 	}
 
 	/**
-	 * Returns the currently registerered {@link DownloadHandler} handler, or null
+	 * @return the currently registerered {@link DownloadHandler} handler, or null
 	 */
 	public DownloadHandler getDownloadHandler() {
 		return downloadHandler;
@@ -3304,6 +3304,7 @@ public class MonetConnection
 		 *                    0 means upload everything, 1 means skip the first line, etc.
 		 *                    Note: this is different from the OFFSET option of the COPY INTO,
 		 *                    where both 0 and 1 mean 'upload everything'
+		 * @throws IOException when I/O problem occurs
 		 */
 		void handleUpload(Upload handle, String name, boolean textMode, long linesToSkip) throws IOException;
 
@@ -3332,6 +3333,7 @@ public class MonetConnection
 		 * @param name Name of the file the server would like to write. Make sure
 		 *             to validate this before writing to the file system
 		 * @param textMode Whether this is text or binary data.
+		 * @throws IOException when I/O problem occurs
 		 */
 		void handleDownload(Download handle, String name, boolean textMode) throws IOException;
 	}
@@ -3362,7 +3364,9 @@ public class MonetConnection
 		 * This method can only be sent if no data has been sent to the server
 		 * yet. After data has been sent, you can still throw an
 		 * {@link IOException} but this will terminate the connection.
-		 * @param errorMessage error message to send
+		 *
+		 * @param errorMessage the error message to send
+		 * @throws IOException when error message is null
 		 */
 		public void sendError(final String errorMessage) throws IOException {
 			if (error != null) {
@@ -3374,6 +3378,8 @@ public class MonetConnection
 		/**
 		 * After every {@code chunkSize} bytes, the server gets the opportunity to
 		 * terminate the upload.
+		 *
+		 * @param chunkSize size of chunk
 		 */
 		public void setChunkSize(final int chunkSize) {
 			this.customChunkSize = chunkSize;
@@ -3383,6 +3389,9 @@ public class MonetConnection
 		 * Get a {@link PrintStream} to write data to.
 		 *
 		 * For text mode uploads, the data MUST be validly UTF-8 encoded.
+		 *
+		 * @return PrintStream a PrintStream
+		 * @throws IOException when error message is null or I/O problem occurs
 		 */
 		public PrintStream getStream() throws IOException {
 			if (error != null) {
@@ -3419,6 +3428,9 @@ public class MonetConnection
 		 * Read from the given input stream and write it to the server.
 		 *
 		 * For text mode uploads, the data MUST be validly UTF-8 encoded.
+		 *
+		 * @param inputStream stream to read from
+		 * @throws IOException when I/O problem occurs
 		 */
 		public void uploadFrom(final InputStream inputStream) throws IOException {
 			final OutputStream s = getStream();
@@ -3434,9 +3446,11 @@ public class MonetConnection
 
 		/**
 		 * Read data from the given buffered reader and send it to the server
-		 * @param reader reader to read from
+		 *
+		 * @param reader buffered reader to read from
 		 * @param linesToSkip start uploading at line {@code offset}. Value 0 and 1
 		 *        both mean upload the whole file, value 2 means skip the first line, etc.
+		 * @throws IOException when I/O problem occurs
 		 */
 		public void uploadFrom(final BufferedReader reader, final long linesToSkip) throws IOException {
 			for (int i = 0; i < linesToSkip; i++) {
@@ -3451,7 +3465,9 @@ public class MonetConnection
 
 		/**
 		 * Read data from the given buffered reader and send it to the server
+		 *
 		 * @param reader reader to read from
+		 * @throws IOException when ...
 		 */
 		public void uploadFrom(final Reader reader) throws IOException {
 			final OutputStream s = getStream();
@@ -3507,6 +3523,9 @@ public class MonetConnection
 		 *
 		 * Note: as of MonetDB version Jul2021 the server always terminates the connection
 		 * when this error is used.  This will probably change in the future.
+		 *
+		 * @param errorMessage the error message to send
+		 * @throws IOException when error message is null
 		 */
 		public void sendError(final String errorMessage) throws IOException {
 			if (error != null) {
@@ -3521,6 +3540,9 @@ public class MonetConnection
 		 * Textual data is UTF-8 encoded. If the download is in text mode, line endings
 		 * are converted according to {@link java.lang.System#lineSeparator()}.
 		 * This can be overridden with {@link Download#setLineSeparator(String)}.
+		 *
+		 * @return InputStream the stream to read from
+		 * @throws IOException when error message exist or I/O problem occurs
 		 */
 		public InputStream getStream() throws IOException {
 			if (error != null) {
@@ -3535,6 +3557,9 @@ public class MonetConnection
 
 		/**
 		 * Write the data from the server to the given {@link OutputStream}.
+		 *
+		 * @param stream the OutputStream to write to
+		 * @throws IOException when cannot read from InputStream or write to OutputStream
 		 */
 		public void downloadTo(final OutputStream stream) throws IOException {
 			final InputStream s = getStream();
@@ -3550,7 +3575,9 @@ public class MonetConnection
 
 		/**
 		 * Write the textual data from the server to the given {@link Writer}
-		 * @param writer
+		 *
+		 * @param writer to write to
+		 * @throws IOException when cannot read from InputStreamReader or write to Writer
 		 */
 		public void downloadTo(final Writer writer) throws IOException {
 			final InputStream s = getStream();
@@ -3566,7 +3593,7 @@ public class MonetConnection
 		}
 
 		/**
-		 * @return  true if data has been received or an error has been sent.
+		 * @return true if data has been received or an error has been sent.
 		 */
 		public boolean hasBeenUsed() {
 			return stream != null || error != null;
@@ -3595,6 +3622,7 @@ public class MonetConnection
 
 		/**
 		 * Set the line endings used in the stream returned by {@link Download#getStream()}
+		 *
 		 * @param sep separator to use
 		 * @throws IllegalArgumentException if sep is neither "\n" nor "\r\n"
 		 */