Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

http://jmapper-framework.github.io/jmapper-core/

Elegance, high performance and robustness all in one java bean mapper
http://jmapper-framework.github.io/jmapper-core/

annotations api bytecode java jmapper mapper mapping xml

Last synced: 3 months ago
JSON representation

Elegance, high performance and robustness all in one java bean mapper

Lists

README

        

# JMapper Framework [![Join the chat at https://gitter.im/jmapper-framework/jmapper-core](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jmapper-framework/jmapper-core?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/avurro)

_Fast as hand-written code with zero compromise._

## Artifact information
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.googlecode.jmapper-framework/jmapper-core/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.googlecode.jmapper-framework/jmapper-core) [![Javadocs](http://www.javadoc.io/badge/com.googlecode.jmapper-framework/jmapper-core.svg)](http://www.javadoc.io/doc/com.googlecode.jmapper-framework/jmapper-core) [![Dependency Status](https://www.versioneye.com/user/projects/5539172d1d2989cb78000002/badge.svg?style=flat)](https://www.versioneye.com/user/projects/5539172d1d2989cb78000002)

## Status
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/ab9b20d7580c4e5d852e6cbe1de509a2)](https://www.codacy.com/app/alessandro-vurro_2/jmapper-core?utm_source=github.com&utm_medium=referral&utm_content=jmapper-framework/jmapper-core&utm_campaign=Badge_Grade) [![Build Status](https://travis-ci.org/jmapper-framework/jmapper-core.svg?branch=master)](https://travis-ci.org/jmapper-framework/jmapper-core)

##### Write the configuration using what you prefer: Annotation, XML or API.
Most relevant features:

* [One to Many](https://github.com/jmapper-framework/jmapper-core/wiki/One-To-Many) and [Many to One](https://github.com/jmapper-framework/jmapper-core/wiki/Many-To-One) relationship
* [dynamic conversions](https://github.com/jmapper-framework/jmapper-core/wiki/Conversion-examples), whose body adapts to every relationship
* [inherited configurations](https://github.com/jmapper-framework/jmapper-core/wiki/Inheritance-examples), you can split the configuration along the hierarchy
* and more..


**especially its use is intuitive**

## Configuration
Below it is shown the same configuration in the three types allowed
##### Annotation
```java
class Destination{ class Source{
@JMap
private String id; private String id;
@JMap("sourceField")
private String destinationField; private String sourceField;
private String other; private String other;

// getters and setters... // getters and setters...
} }
```
##### XML
```xml








```
##### API
```java
JMapperAPI jmapperAPI = new JMapperAPI()
.add(mappedClass(Destination.class)
.add(attribute("id")
.value("id"))
.add(attribute("destinationField")
.value("sourceField")));
```

## Creation
```java
JMapper mapper;
```
##### Annotation
```java
mapper = new JMapper<>(Destination.class, Source.class);
```
##### XML
```java
mapper = new JMapper<>(Destination.class, Source.class, xml);
```
##### API
```java
mapper = new JMapper<>(Destination.class, Source.class, jmapperAPI);
```
## Usage
```java
Source source = new Source("id", "sourceField", "other");
Destination destination = mapper.getDestination(source);
```
## Result
```java
destination ["id", "sourceField", null]
```
*With JMapper we have all the advantages of dynamic mapping with the performance of static code, with 0 memory consumption.*

**Required java 8+**

**Would you like to contribute to the development of JMapper?**

contact us ([email protected]) for more information.

**Follow us on twitter**