add javadoc

Author: sergejsvisockis

active-record/src/main/java/com/iluwatar/activerecord/base/RecordBase.java

@@ -101,6 +101,8 @@ protected static Connection getConnection() {
   /**
    * Find all the records for a corresponding domain model.
    *
+   * @param clazz the record class.
+   * @param <T>   the record type.
    * @return all the domain model related records.
    */
   public static <T extends RecordBase> List<T> findAll(Class<T> clazz) {
@@ -126,7 +128,9 @@ public static <T extends RecordBase> List<T> findAll(Class<T> clazz) {
   /**
    * Find a domain model by its ID.
    *
-   * @param id domain model identifier.
+   * @param id    domain model identifier.
+   * @param clazz the record class.
+   * @param <T>   the record type.
    * @return the domain model.
    */
   public static <T extends RecordBase> Optional<T> findById(Long id, Class<T> clazz) {
@@ -151,6 +155,13 @@ public static <T extends RecordBase> Optional<T> findById(Long id, Class<T> claz
     }
   }
 
+  /**
+   * Delete the record by its unique identifier.
+   *
+   * @param id    the record identifier.
+   * @param clazz the record class.
+   * @param <T>   the record type.
+   */
   public static <T extends RecordBase> void delete(Long id, Class<T> clazz) {
     String deleteStatement = Query
         .deleteFrom(getDeclaredClassInstance(clazz).getTableName())
@@ -168,6 +179,9 @@ public static <T extends RecordBase> void delete(Long id, Class<T> clazz) {
 
   /**
    * Save the record.
+   *
+   * @param clazz the record class.
+   * @param <T>   the record type.
    */
   public <T extends RecordBase> void save(Class<T> clazz) {
     try (Connection connection = getConnection();
@@ -184,6 +198,13 @@ public <T extends RecordBase> void save(Class<T> clazz) {
 
   protected abstract void setPreparedStatementParams(PreparedStatement pstmt) throws SQLException;
 
+  /**
+   * Constructs an insertion query based on the descending type's fields.
+   *
+   * @param clazz the record class.
+   * @param <T>   the record type.
+   * @return a full insert query.
+   */
   protected static <T extends RecordBase> String constructInsertionQuery(Class<T> clazz) {
     List<Object> arguments = new ArrayList<>();
     try {