Added the parseToObject() method present in ExcelSheet which is used to parse a Sheet into a Java object.

Author: MBenincasa

src/main/java/io/github/mbenincasa/javaexcelutils/annotations/ExcelCellMapping.java

@@ -0,0 +1,26 @@
+package io.github.mbenincasa.javaexcelutils.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation is needed when the parseToObject() method in ExcelSheet is used
+ * @author Mirko Benincasa
+ * @since 0.5.0
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.FIELD)
+public @interface ExcelCellMapping {
+
+    /**
+     * @return the value to add to the source row
+     */
+    int deltaRow();
+
+    /**
+     * @return the value to add to the source column
+     */
+    int deltaCol();
+}

src/main/java/io/github/mbenincasa/javaexcelutils/model/excel/ExcelSheet.java

@@ -1,14 +1,19 @@
 package io.github.mbenincasa.javaexcelutils.model.excel;
 
+import io.github.mbenincasa.javaexcelutils.annotations.ExcelCellMapping;
 import io.github.mbenincasa.javaexcelutils.exceptions.CellNotFoundException;
+import io.github.mbenincasa.javaexcelutils.exceptions.ReadValueException;
 import io.github.mbenincasa.javaexcelutils.exceptions.RowNotFoundException;
+import io.github.mbenincasa.javaexcelutils.model.parser.ExcelCellParser;
 import io.github.mbenincasa.javaexcelutils.tools.ExcelUtility;
 import lombok.*;
 import org.apache.poi.ss.usermodel.Cell;
 import org.apache.poi.ss.usermodel.Row;
 import org.apache.poi.ss.usermodel.Sheet;
 import org.apache.poi.ss.util.CellRangeAddress;
 
+import java.lang.reflect.Field;
+import java.lang.reflect.InvocationTargetException;
 import java.util.LinkedList;
 import java.util.List;
 import java.util.concurrent.atomic.AtomicInteger;
@@ -165,18 +170,6 @@ public void appendCells(String startingCell, Stream<Object[]> data) {
         writeOrAppendCells(data, rowIndex, colIndex);
     }
 
-    private void writeOrAppendCells(Stream<Object[]> data, AtomicInteger rowIndex, int colIndex) {
-        data.forEach(rowData -> {
-            ExcelRow excelRow = getOrCreateRow(rowIndex.get());
-            for (int i = 0; i < rowData.length; i++) {
-                Object value = rowData[i];
-                ExcelCell excelCell = excelRow.getOrCreateCell(colIndex + i);
-                excelCell.writeValue(value);
-            }
-            rowIndex.getAndIncrement();
-        });
-    }
-
     /**
      * Method used to delete cells based on the selected range, for example: 'A1:B2'
      * @param cellRange The range of cells to be deleted
@@ -260,4 +253,56 @@ public Integer countAllRows(Boolean alsoEmpty) {
 
         return count;
     }
+
+    /**
+     * @param clazz The class of the object to return
+     * @param startingCell The name of the source cell
+     * @param <T> The class parameter of the object
+     * @return The object parsed
+     * @throws NoSuchMethodException If the setting method or empty constructor of the object is not found
+     * @throws InvocationTargetException If an error occurs while instantiating a new object or setting a field
+     * @throws InstantiationException If an error occurs while instantiating a new object
+     * @throws IllegalAccessException If a field or fields of the {@code clazz} could not be accessed
+     * @throws ReadValueException If an error occurs while reading a cell
+     * @since 0.5.0
+     */
+    public <T> T parseToObject(Class<T> clazz, String startingCell) throws NoSuchMethodException, InvocationTargetException, InstantiationException, IllegalAccessException, ReadValueException {
+        T obj = clazz.getDeclaredConstructor().newInstance();
+        int[] cellIndexes = ExcelUtility.getCellIndexes(startingCell);
+        int startingRow = cellIndexes[0];
+        int startingCol = cellIndexes[1];
+        Field[] fields = clazz.getDeclaredFields();
+
+        for (Field field : fields) {
+            if (!field.isAnnotationPresent(ExcelCellMapping.class))
+                continue;
+
+            ExcelCellMapping excelCellMapping = field.getAnnotation(ExcelCellMapping.class);
+            int deltaRow = excelCellMapping.deltaRow();
+            int deltaCol = excelCellMapping.deltaCol();
+            ExcelRow excelRow = getOrCreateRow(startingRow + deltaRow);
+            ExcelCell excelCell = excelRow.getOrCreateCell(startingCol + deltaCol);
+            field.setAccessible(true);
+
+            Object value = ExcelCellParser.class.isAssignableFrom(field.getType())
+                    ? parseToObject(field.getType(), ExcelUtility.getCellName(startingRow + deltaRow, startingCol + deltaCol))
+                    : excelCell.readValue(field.getType());
+            field.set(obj, value);
+
+        }
+
+        return obj;
+    }
+
+    private void writeOrAppendCells(Stream<Object[]> data, AtomicInteger rowIndex, int colIndex) {
+        data.forEach(rowData -> {
+            ExcelRow excelRow = getOrCreateRow(rowIndex.get());
+            for (int i = 0; i < rowData.length; i++) {
+                Object value = rowData[i];
+                ExcelCell excelCell = excelRow.getOrCreateCell(colIndex + i);
+                excelCell.writeValue(value);
+            }
+            rowIndex.getAndIncrement();
+        });
+    }
 }

src/main/java/io/github/mbenincasa/javaexcelutils/model/parser/ExcelCellParser.java

@@ -0,0 +1,10 @@
+package io.github.mbenincasa.javaexcelutils.model.parser;
+
+/**
+ * This interface is needed when the parseToObject() method in the ExcelSheet is used.
+ * All objects to be parsed must implement this interface to identify that it is not a cell to read.
+ * @author Mirko Benincasa
+ * @since 0.5.0
+ */
+public interface ExcelCellParser {
+}

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjectsSample/Employee.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjects/Employee.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjectsSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjects;
 
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelBodyStyle;
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelField;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjectsSample/Main.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjects/Main.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjectsSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjects;
 
 import io.github.mbenincasa.javaexcelutils.model.converter.ExcelToObject;
 import io.github.mbenincasa.javaexcelutils.tools.Converter;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjectsSample/Office.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertExcelFileToObjects/Office.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjectsSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertExcelFileToObjects;
 
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelBodyStyle;
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelField;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFileSample/Employee.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFile/Employee.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFileSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFile;
 
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelBodyStyle;
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelField;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFileSample/Main.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFile/Main.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFileSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFile;
 
 import io.github.mbenincasa.javaexcelutils.enums.Extension;
 import io.github.mbenincasa.javaexcelutils.model.converter.ObjectToExcel;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFileSample/Office.java renamed to src/main/java/io/github/mbenincasa/javaexcelutils/samples/convertObjectsToExcelFile/Office.java

@@ -1,4 +1,4 @@
-package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFileSample;
+package io.github.mbenincasa.javaexcelutils.samples.convertObjectsToExcelFile;
 
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelBodyStyle;
 import io.github.mbenincasa.javaexcelutils.annotations.ExcelField;

src/main/java/io/github/mbenincasa/javaexcelutils/samples/parseSheetToExcel/Address.java

@@ -0,0 +1,20 @@
+package io.github.mbenincasa.javaexcelutils.samples.parseSheetToExcel;
+
+import io.github.mbenincasa.javaexcelutils.annotations.ExcelCellMapping;
+import io.github.mbenincasa.javaexcelutils.model.parser.ExcelCellParser;
+import lombok.AllArgsConstructor;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
+
+@AllArgsConstructor
+@NoArgsConstructor
+@Setter
+@ToString
+public class Address implements ExcelCellParser {
+
+    @ExcelCellMapping(deltaRow = 1, deltaCol = 0)
+    private String city;
+    @ExcelCellMapping(deltaRow = 2, deltaCol = 0)
+    private String cap;
+}