Mapping Java Beans to CSV Using OpenCSV

The need to convert Java Beans(Objects) to CSV file arises very commonly and there are many ways to write Bean into CSV file but one of the best ways to map java bean to CSV is by using OpenCSV Library. In OpenCSV there is a class name StatefulBeanToCsvBuilder which helps to convert Java Beans to CSV.

1. The first task is to add the OpenCSV library into the Project.
   • For maven project,include the OpenCSV maven dependency in pom.xml file.

     <dependency>
         <groupId>com.opencsv</groupId>
         <artifactId>opencsv</artifactId>
         <version>4.1</version>
     </dependency>
   • For Gradle Project, include the OpenCSV dependency.

     compile group: 'com.opencsv', name: 'opencsv', version: '4.1'

   • You can Download OpenCSV Jar and include in your project class path.
2. Mapping JavaBeans to CSV
   Below is the step-by-step procedure to map Java Beans to CSV.
   1. Create Writer instance for writing data to the CSV file.

      Writer writer = Files.newBufferedWriter(Paths.get(file_location));

   2. Create a List of objects which are needed to be written into the CSV file.
   3. Using ColumnPositionMappingStrategy map the columns of Created objects, to Column of csv.
      This is an optional step. If ColumnPositionMappingStrategy is not used, then object will be written to csv with column name same as attribute name of object.

      ColumnPositionMappingStrategy mappingStrategy = new ColumnPositionMappingStrategy();
          mappingStrategy.setType(Employee.class);
      
      where Employee is the object to be mapped with CSV.
      

   4. Create object of StatefulBeanToCsv class by calling build method of StatefulBeanToCsvBuilder class after the creation of StatefulBeanToCsvBuilder, with writer object as parameter. According to the requirement the user can also provide:
      • ColumnPositionMappingStrategy with the help of withMappingStrategy function of StatefulBeanToCsvBuilder object.
      • Separator of generated csv file with the help of withSeparator function of StatefulBeanToCsvBuilder object.
      • withQuotechar of generated csv file with the help of withQuotechar function of StatefulBeanToCsvBuilder object.

      StatefulBeanToCsv beanToCsv = new StatefulBeanToCsvBuilder(writer)
      .withMappingStrategy(mappingStrategy)
      . withSeparator('#')
                          .withQuotechar(CSVWriter.NO_QUOTE_CHARACTER)
                          .build();
      

   5. After creating object of StatefulBeanToCsv class you can add list of object or object to csv file with the help of write method of StatefulBeanToCsv object.

      beanToCsv.write(Employeelist);
      

Example: In this example, we are going to create the list of Employee Object which has attributes like Name, Age, Company, Salary. Then we will generate a CSV file Employees.csv which contains Employee objects.
Codes:

1. Employee.java

   public class Employee {
   
       public String Name, Age, Company, Salary;
   
       public Employee(String name, String age,
                   String company, String salary)
       {
           super();
           Name = name;
           Age = age;
           Company = company;
           Salary = salary;
       }
   
       @Override
       public String toString()
       {
          return "Employee [Name=" + Name + ",
          Age=" + Age + ", Company=" + Company + ",
          Salary=" + Salary + "]";
       }
   }
2. BeanToCSV.java

   import java.io.FileWriter;
   import java.io.Writer;
   import java.nio.*;
   import java.nio.file.Files;
   import java.nio.file.Paths;
   import java.util.*;
   import com.opencsv.bean.ColumnPositionMappingStrategy;
   import com.opencsv.bean.StatefulBeanToCsv;
   import com.opencsv.bean.StatefulBeanToCsvBuilder;
   
   public class BeanToCSV {
       public static void main(String[] args)
       {
   
           // name of generated csv
           final String CSV_LOCATION = "Employees.csv ";
   
           try {
   
               // Creating writer class to generate
               // csv file
               FileWriter writer = new
                          FileWriter(CSV_LOCATION);
   
               // create a list of employee
               List<Employee> EmployeeList = new
                                    ArrayList<Employee>();
               Employee emp1 = new Employee
                        ("Mahafuj", "24", "HTc", "75000");
               Employee emp2 = new Employee
                     ("Aman", "24", "microsoft", "79000");
               Employee emp3 = new Employee
                       ("Suvradip", "26", "tcs", "39000");
               Employee emp4 = new Employee
                        ("Riya", "22", "NgGear", "15000");
               Employee emp5 = new Employee
                       ("Prakash", "29", "Sath", "51000");
               EmployeeList.add(emp1);
               EmployeeList.add(emp2);
               EmployeeList.add(emp3);
               EmployeeList.add(emp4);
               EmployeeList.add(emp5);
   
               // Create Mapping Strategy to arrange the
               // column name in order
               ColumnPositionMappingStrategy mappingStrategy=
                           new ColumnPositionMappingStrategy();
               mappingStrategy.setType(Employee.class);
   
               // Arrange column name as provided in below array.
               String[] columns = new String[]
                       { "Name", "Age", "Company", "Salary" };
               mappingStrategy.setColumnMapping(columns);
   
               // Creating StatefulBeanToCsv object
               StatefulBeanToCsvBuilder<Employee> builder=
                           new StatefulBeanToCsvBuilder(writer);
               StatefulBeanToCsv beanWriter =
             builder.withMappingStrategy(mappingStrategy).build();
   
               // Write list to StatefulBeanToCsv object
               beanWriter.write(EmployeeList);
   
               // closing the writer object
               writer.close();
           }
           catch (Exception e) {
               e.printStackTrace();
           }
       }
   }

Output:

EmployeeData.csv
CSV file contains:-----

"Mahafuj", "24", "HTc", "75000"
"Aman", "24", "microsoft", "79000"
"Suvradip", "26", "tcs", "39000"
"Riya", "22", "NgGear", "15000"
"Prakash", "29", "Sath", "51000"

Reference: BeanToCsv Official Documentation