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.
      filter_none

      edit
      close

      play_arrow

      link
      brightness_4
      code

      <dependency>
          <groupId>com.opencsv</groupId>
          <artifactId>opencsv</artifactId>
          <version>4.1</version>
      </dependency>

      chevron_right

      
      

    • 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

    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    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 + "]";
        }
    }

    chevron_right

    
    

  2. BeanToCSV.java

    filter_none

    edit
    close

    play_arrow

    link
    brightness_4
    code

    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);
      
                // Createing 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();
            }
        }
    }

    chevron_right

    
    

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



My Personal Notes arrow_drop_up

I am a Developer I love to code and bring my ideas alive

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :
Practice Tags :


Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.