Java library for mapping Excel sheets to POJO
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

XLSBeans Build Status Maven Central

XLSBeans is a Java library for mapping Excel sheets to POJO.


To use XLSBeans, add the following dependency to your pom.xml:


Getting Started

For example, here is one Excel sheet.

Sample Excel

Map this Excel sheet to POJO using @HorizontalRecords and @LabelledCell.

public class UserList {

  @LabelledCell(label="Title", type=LabelledCellType.Right)
  public String title;

  @HorizontalRecords(tableLabel="User list", recordClass=User.class)
  public List<User> users;


And the following is the record class. Properties of the record class is mapped to columns by @Column.

public class User {

  public int id;

  public String name;

  @Column(columnName="Gender", merged=true)
  public String gender;


You can get the mapped POJO using XLSBeans#load() like following:

UserList userList = (UserList)new XLSBeans().load(
  new FileInputStream("example.xls"), UserList.class);


See more details in (in Japanese)