RELEASE v0.5.0

Author: MBenincasa

CHANGELOG.MD

@@ -1,3 +1,17 @@
+# v0.5.0
+### Features
+* Methods for writing a matrix of values starting from a source cell or in append and the method for deleting a matrix of cells has been added to Excel Sheet
+* Wrapper classes can be initialized with static of() methods
+* There are methods parseToObject() and parseToList() in ExcelSheet which allow, through defined rules, to assign the values of precise cells to the fields of an object.
+### Fixes
+* The readValue() method correctly returns the Date type
+* The readValue(Class<?> type) method checks better if the return value is a date
+### Removed
+* Methods that have been deprecated since v0.4.0 have been removed
+### Changes
+* Constructor methods of wrapper classes are now private
+* The writeValue() method uses the yyyy-MM-dd and yyyy-MM-dd HH:mm style to represent date and time
+
 # v0.4.2
 ### Features
 * Now there is a method to zip a list of files

README.md

@@ -1,6 +1,7 @@
 [![Maven Central](https://img.shields.io/maven-central/v/io.github.mbenincasa/java-excel-utils.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.github.mbenincasa%22%20AND%20a:%22java-excel-utils%22)
 [![GitHub release](https://img.shields.io/github/release/MBenincasa/java-excel-utils)](https://github.com/MBenincasa/java-excel-utils/releases/)
-[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)<br>
+[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/donate/?hosted_button_id=WXYAJVFZD82BJ)
 
 # Java Excel Utils
 
@@ -32,6 +33,14 @@ public void toPOI() {
     Row row = excelRow.getRow();
     Cell cell = excelCell.getCell();
 }
+
+public void fromPOI() {
+    // Initialize the components
+    ExcelWorkbook excelWorkbook = ExcelWorkbook.of(workbook);
+    ExcelSheet excelSheet = ExcelSheet.of(sheet);
+    ExcelRow excelRow = ExcelRow.of(row);
+    ExcelCell excelCell = ExcelCell.of(cell);
+}
 ```
 
 One of the main features of the library is to be able to perform conversions. The **Converter** class has methods that convert **EXCEL <-> POJOs**, **EXCEL <-> CSV** and **EXCEL <-> JSON**<br>
@@ -59,6 +68,18 @@ public void objectsToExcel() {
 }
 ```
 
+ExcelSheet provides two methods for parsing the Sheet into an object or a list of objects.<br>
+The advantage of these methods comes from the annotations and the mapping class that allow you to define the positions of the values of each field and the rules on how the various objects are positioned
+```
+public void parseSheet() {
+   ExcelWorkbook excelWorkbook = ExcelWorkbook.open(file);
+   ExcelSheet excelSheet = excelWorkbook.getSheet("DATA");
+   Employee employee = excelSheet.parseToObject(Employee.class, "A1");
+   ExcelListParserMapping mapping = new ExcelListParserMapping("A1", Direction.VERTICAL, 8);
+   List<Employee> employees = excelSheet.parseToList(Employee.class, mapping);
+}
+```
+
 ExcelCell provides generic methods for reading a cell.
 ```
 public void readValue() {
@@ -91,7 +112,7 @@ Java 17 or above.
 <dependency>
   <groupId>io.github.mbenincasa</groupId>
   <artifactId>java-excel-utils</artifactId>
-  <version>0.4.2</version>
+  <version>0.5.0</version>
 </dependency>
 ```
 
@@ -115,3 +136,7 @@ Distributed under the GNU General Public License v3.0. See `LICENSE.md` for more
 
 ## Contact
 Mirko Benincasa - [email protected]
+
+## Donations
+Another way to support and contribute to the project is by sending a donation. The project will always be free and open source.<br>
+Click [here](https://www.paypal.com/donate/?hosted_button_id=WXYAJVFZD82BJ) to make a donation on PayPal

SECURITY.md

@@ -4,8 +4,8 @@
 The following versions of this project are currently being supported with security updates:
 | Version     | Supported            |
 |:-----------:|:--------------------:|
-| v0.4.x      | :white_check_mark:   |
-| < v0.3.y    | :x:                  |
+| v0.5.x      | :white_check_mark:   |
+| < v0.4.y    | :x:                  |
 
 ### Reporting a Vulnerability
 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.github.mbenincasa</groupId>
     <artifactId>java-excel-utils</artifactId>
-    <version>0.4.2</version>
+    <version>0.5.0</version>
     <packaging>jar</packaging>
     <name>Java library with tools for Excel files</name>
     <description>Java library that collects tools and methods to speed up development with Excel sheets</description>

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

@@ -306,6 +306,7 @@ public <T> T parseToObject(Class<T> clazz, String startingCell) throws NoSuchMet
      * @throws NoSuchMethodException If the setting method or empty constructor of the object is not found
      * @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
+     * @since 0.5.0
      */
     public <T> List<T> parseToList(Class<T> clazz, ExcelListParserMapping mapping) throws ReadValueException, InvocationTargetException, NoSuchMethodException, InstantiationException, IllegalAccessException {
         List<T> objectList = new LinkedList<>();