Object mapping is a common task in applications and API development. As your application evolves, you may find yourself dealing with different data structures, such as entities from a database, DTOs for communication, and view models for presentation. Manually writing code to map objects from one type to another can be tedious, error-prone, and time-consuming.
This is where ModelMapper comes into play. It automates the process of object mapping, allowing developers to focus on business logic rather than writing repetitive mapping code.
ModelMapper is a powerful Java library designed to simplify the process of mapping objects from one type to another. It provides a flexible and convention-based approach to object mapping, reducing the boilerplate code typically associated with data transfer between different models.
To use ModelMapper in your Java project, you must include the library as a dependency. If you are using Maven, add the following to your pom.xml:
<dependency>
<groupId>org.modelmapper</groupId>
<artifactId>modelmapper</artifactId>
<version>3.1.1</version>
</dependency>
Related read: React Virtual Dom vs Real Dom
Implementation ‘org.modelmapper:modelmapper:3.1.1’:
Here’s a Simple Example Demonstrating the Usage of ModelMapper:
public class UserDTO {
private String name;
private String email;
private String phone;
private String dateOfBirth;
//constructor,getters and setters
}
public class UserEntity {
private String name;
private String emailId;
private String phone;
private LocalDate dateOfBirth;
//constructor,getters and setters
}
ModelMapper modelMapper = new ModelMapper();
UserEntity userEntity = new UserEntity("Brock","brock@example.com","1234567890",LocalDate.of(1998, 04, 24));
UserDTO userDTO = modelMapper.map(userEntity, UserDTO.class);
System.out.println("Name :: "+userDTO.getName());
System.out.println("Email :: "+userDTO.getEmail());
System.out.println("Phone :: "+userDTO.getPhone());
System.out.println("Date Of birth:"+userDTO.getDateOfBirth());
In this example, ModelMapper automatically maps properties with matching names and types from UserEntity to UserDTO i.e. email, name, phone, and date of birth.
Most of the time model mapper handles the conversion but sometimes you may need to handle more complex conversions between types. This is where ModelMapper’s custom converters come into play.
ModelMapper allows the creation of custom converters to handle more complex mappings. You can implement the Converter interface and register it with ModelMapper.
For example:
ModelMapper modelMapper = new ModelMapper();
Converter<Date, String> dateToStringConverter = new Converter<>()
{
@Override
public String convert(MappingContext<Date, String> context)
{
SimpleDateFormat dateFormat = newSimpleDateFormat("yyyy-MM-dd");
return dateFormat.format(context.getSource());
}
// Register the custom converter
modelMapper.addConverter(dateToStringConverter);
UserEntity userEntity = new UserEntity(new Date());
UserDTO userDTO = modelMapper.map(userEntity, UserDTO.class);
System.out.println(userDTO.getDateOfBirth());
In this example, we are formatting the date of birth to the date format we want.
Property binding refers to the association of properties between source and destination objects during the mapping process. ModelMapper provides a flexible way to handle property binding, allowing developers to configure mappings based on property names or custom expressions.
modelMapper.createTypeMap(UserEntity.class, UserDTO.class)
.addMapping(src -> src.getEmailId(), UserDTO::setEmailAddress);
In this example, we create a custom type mapping and explicitly define the property bindings. We specify that the email ID property in the source object should be bound to the emailAddress property in the destination object.
ModelMapper allows for conditional mapping, where certain mappings are applied based on conditions. This is useful when you want to apply different mappings depending on the state of the source object.
modelMapper.createTypeMap(UserEntity.class, UserDTO.class)
.addMappings(mapping -> mapping.using(ctx -> {
LocalDate dateOfBirth = ((Date)ctx.getSource()).toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
return
String.valueOf(Period.between(dateOfBirth,LocalDate.now()).getYears());
}).map(UserEntity::getDateOfBirth, UserDTO::setAge));
In this example we have calculated age from date of birth and set the value of age in UserDTO object.
Sometimes, you may want to ignore certain properties during the mapping process. ModelMapper provides mechanisms to achieve this.
modelMapper.createTypeMap(UserEntity.class, UserDTO.class)
.addMappings(mapping -> mapping.skip(UserDTO::setDateOfBirth));
In this example, we use the skip method to instruct ModelMapper to ignore the dateOfBirth property during mapping.
Collection mapping in the context of ModelMapper refers to the process of mapping collections of objects from one type to another. It involves mapping each element within a source collection to its corresponding element in a destination collection.
List<UserEntity> users = Arrays.asList(new UserEntity("Brock","brock@example.com","1234567890",new Date()));
List<UserDTO> userDTOs = modelMapper.map(users, new TypeToken<List<UserDTO>>() {}.getType());
In this example, the ModelMapper will handle each mapping from UserEntity to UserDTO.
ModelMapper significantly simplifies object mapping in Java applications. Whether you are dealing with basic one-to-one mappings or complex hierarchies with nested collections, ModelMapper provides the tools to handle the job efficiently.
By mastering ModelMapper, you can enhance the maintainability and readability of your code, making it easier to adapt to changes in your data model. This guide has covered the basics and advanced features of ModelMapper.
How to Effectively Hire and Manage a Remote Team of Developers.
Download NowMindbowser played a crucial role in helping us bring everything together into a unified, cohesive product. Their commitment to industry-standard coding practices made an enormous difference, allowing developers to seamlessly transition in and out of the project without any confusion....
CEO, MarketsAI
I'm thrilled to be partnering with Mindbowser on our journey with TravelRite. The collaboration has been exceptional, and I’m truly grateful for the dedication and expertise the team has brought to the development process. Their commitment to our mission is...
Founder & CEO, TravelRite
The Mindbowser team's professionalism consistently impressed me. Their commitment to quality shone through in every aspect of the project. They truly went the extra mile, ensuring they understood our needs perfectly and were always willing to invest the time to...
CTO, New Day Therapeutics
I collaborated with Mindbowser for several years on a complex SaaS platform project. They took over a partially completed project and successfully transformed it into a fully functional and robust platform. Throughout the entire process, the quality of their work...
President, E.B. Carlson
Mindbowser and team are professional, talented and very responsive. They got us through a challenging situation with our IOT product successfully. They will be our go to dev team going forward.
Founder, Cascada
Amazing team to work with. Very responsive and very skilled in both front and backend engineering. Looking forward to our next project together.
Co-Founder, Emerge
The team is great to work with. Very professional, on task, and efficient.
Founder, PeriopMD
I can not express enough how pleased we are with the whole team. From the first call and meeting, they took our vision and ran with it. Communication was easy and everyone was flexible to our schedule. I’m excited to...
Founder, Seeke
Mindbowser has truly been foundational in my journey from concept to design and onto that final launch phase.
CEO, KickSnap
We had very close go live timeline and Mindbowser team got us live a month before.
CEO, BuyNow WorldWide
If you want a team of great developers, I recommend them for the next project.
Founder, Teach Reach
Mindbowser built both iOS and Android apps for Mindworks, that have stood the test of time. 5 years later they still function quite beautifully. Their team always met their objectives and I'm very happy with the end result. Thank you!
Founder, Mindworks
Mindbowser has delivered a much better quality product than our previous tech vendors. Our product is stable and passed Well Architected Framework Review from AWS.
CEO, PurpleAnt
I am happy to share that we got USD 10k in cloud credits courtesy of our friends at Mindbowser. Thank you Pravin and Ayush, this means a lot to us.
CTO, Shortlist
Mindbowser is one of the reasons that our app is successful. These guys have been a great team.
Founder & CEO, MangoMirror
Kudos for all your hard work and diligence on the Telehealth platform project. You made it possible.
CEO, ThriveHealth
Mindbowser helped us build an awesome iOS app to bring balance to people’s lives.
CEO, SMILINGMIND
They were a very responsive team! Extremely easy to communicate and work with!
Founder & CEO, TotTech
We’ve had very little-to-no hiccups at all—it’s been a really pleasurable experience.
Co-Founder, TEAM8s
Mindbowser was very helpful with explaining the development process and started quickly on the project.
Executive Director of Product Development, Innovation Lab
The greatest benefit we got from Mindbowser is the expertise. Their team has developed apps in all different industries with all types of social proofs.
Co-Founder, Vesica
Mindbowser is professional, efficient and thorough.
Consultant, XPRIZE
Very committed, they create beautiful apps and are very benevolent. They have brilliant Ideas.
Founder, S.T.A.R.S of Wellness
Mindbowser was great; they listened to us a lot and helped us hone in on the actual idea of the app. They had put together fantastic wireframes for us.
Co-Founder, Flat Earth
Ayush was responsive and paired me with the best team member possible, to complete my complex vision and project. Could not be happier.
Founder, Child Life On Call
The team from Mindbowser stayed on task, asked the right questions, and completed the required tasks in a timely fashion! Strong work team!
CEO, SDOH2Health LLC
Mindbowser was easy to work with and hit the ground running, immediately feeling like part of our team.
CEO, Stealth Startup
Mindbowser was an excellent partner in developing my fitness app. They were patient, attentive, & understood my business needs. The end product exceeded my expectations. Thrilled to share it globally.
Owner, Phalanx
Mindbowser's expertise in tech, process & mobile development made them our choice for our app. The team was dedicated to the process & delivered high-quality features on time. They also gave valuable industry advice. Highly recommend them for app development...
Co-Founder, Fox&Fork