Improve code quality of the Thin mode code

Author: sharadraju

lib/thin/lob.js

@@ -59,10 +59,21 @@ class ThinLobImpl extends LobImpl {
     }
   }
 
+  //---------------------------------------------------------------------------
+  // getChunkSize()
+  //
+  // Internal method for returning the chunk size of the LOB.
+  //---------------------------------------------------------------------------
   getChunkSize() {
     return this._chunkSize;
   }
 
+  //---------------------------------------------------------------------------
+  // _getChunkSizeAsync()
+  //
+  // Internal method for returning the chunk size of the LOB fetched from
+  // the database.
+  //---------------------------------------------------------------------------
   async _getChunkSizeAsync() {
     this.checkConn();
     const options = {
@@ -73,29 +84,60 @@ class ThinLobImpl extends LobImpl {
     this._chunkSize = this._pieceSize = await this._sendMessage(options);
   }
 
+  //---------------------------------------------------------------------------
+  // getLength()
+  //
+  // Internal method for returning the length of a LOB.
+  //---------------------------------------------------------------------------
   getLength() {
     return this._length;
   }
 
+  //---------------------------------------------------------------------------
+  // getPieceSize()
+  //
+  // Internal method returning the size to use for each piece that is
+  // transferred when reading from the LOB.
+  //---------------------------------------------------------------------------
   getPieceSize() {
     return this._pieceSize;
   }
 
+  //---------------------------------------------------------------------------
+  // setPieceSize()
+  //
+  // Internal method to set the pieceSize for LOBs.
+  //---------------------------------------------------------------------------
   setPieceSize(value) {
     this._pieceSize = value;
   }
 
+  //---------------------------------------------------------------------------
+  // getType()
+  //
+  // Internal method returning the datatype of LOBs.
+  //---------------------------------------------------------------------------
   getType() {
     return this.dbType;
   }
 
+  //---------------------------------------------------------------------------
+  // getData()
+  //
+  // Internal method returning the data obtained from the database.
+  //---------------------------------------------------------------------------
   async getData(offset = 1, len = this._length) {
     if (!len) {
       len = this._length;
     }
     return await this.read(offset, len);
   }
 
+  //---------------------------------------------------------------------------
+  // read()
+  //
+  // Internal method for reading a portion (or all) of the data in the LOB.
+  //---------------------------------------------------------------------------
   async read(offset, length) {
     this.checkConn();
     const options = {
@@ -108,6 +150,11 @@ class ThinLobImpl extends LobImpl {
     return await this._sendMessage(options);
   }
 
+  //---------------------------------------------------------------------------
+  // write()
+  //
+  // Internal method for writing data to the LOB object.
+  //---------------------------------------------------------------------------
   async write(offset, data) {
     this.checkConn();
     const options = {
@@ -120,6 +167,11 @@ class ThinLobImpl extends LobImpl {
     this._length += data.length;
   }
 
+  //---------------------------------------------------------------------------
+  // getCsfrm()
+  //
+  // Return the character set encoding used by the LOB.
+  //---------------------------------------------------------------------------
   getCsfrm() {
     if (this.dbType._csfrm !== constants.CSFRM_NCHAR) {
       if (this._locator[constants.TNS_LOB_LOC_OFFSET_FLAG_3] &
@@ -155,11 +207,21 @@ class ThinLobImpl extends LobImpl {
     await this._getChunkSizeAsync();
   }
 
+  //---------------------------------------------------------------------------
+  // checkConn()
+  //
+  // Internal method to check the connection.
+  //---------------------------------------------------------------------------
   checkConn() {
     if (!this.conn.nscon.connected)
       errors.throwErr(errors.ERR_INVALID_CONNECTION);
   }
 
+  //---------------------------------------------------------------------------
+  // close()
+  //
+  // Internal method to close the LOBs using piggyback mechanism.
+  //---------------------------------------------------------------------------
   close() {
     this.checkConn();
     if (this._isTempLob) {
@@ -169,6 +231,11 @@ class ThinLobImpl extends LobImpl {
     }
   }
 
+  //---------------------------------------------------------------------------
+  // init()
+  //
+  // Internal method to initialize LOBs.
+  //---------------------------------------------------------------------------
   init(conn, locator, dbType, len, chunkSize) {
     this.dirtyLength = false;
     this.conn = conn;