https://github.com/dotxyteam/jvisualmapper
A Java graphical mapping (between POJOs, JavaBeans, etc.) tool.
https://github.com/dotxyteam/jvisualmapper
gui java mapping-tools mappings
Last synced: 5 months ago
JSON representation
A Java graphical mapping (between POJOs, JavaBeans, etc.) tool.
- Host: GitHub
- URL: https://github.com/dotxyteam/jvisualmapper
- Owner: dotxyteam
- Created: 2025-12-23T20:18:48.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-03T14:27:24.000Z (5 months ago)
- Last Synced: 2026-01-13T19:42:44.194Z (5 months ago)
- Topics: gui, java, mapping-tools, mappings
- Language: Java
- Homepage:
- Size: 2.26 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# J-Visual Mapper
# Overview
The goal of this project is to provide a graphical alternative to tools (such as [MapStruct](http://mapstruct.org/), [Dozer](https://github.com/DozerMapper/dozer), [Orika](https://github.com/orika-mapper/orika), [ModelMapper](http://modelmapper.org/), [JMapper](https://github.com/jmapper-framework/jmapper-core), [Selma](http://www.selma-java.org/), etc.) that implement mappings between Java types.
# Use Cases
- Format conversion
- Mappings between domain objects (see DDD=Domain-driven design) and DTOs (data transfer objects)
- …
# Advantages
- Graphical and XML-based
- JIT (just in time) mapping compilation
- Java-based expression editor (no specific language to learn)
- Can cohabit with other mapping frameworks (MapStruct, ...)
# Compatibility
Tested on Windows & Linux with Java 8 & 21.
# Licensing
It is distributed under this
[license](https://github.com/dotxyteam/JVisualMapper/blob/master/j-visual-mapper/LICENSE).
# Download
* [Get the source code and the binaries↓](https://github.com/dotxyteam/JVisualMapper/releases)
# Getting started
* Add the dependency to your project (Maven dependency above):
```xml
com.github.dotxyteam
j-visual-mapper
LATEST
```
* Snippets:
```java
// Create a Mapper instance, open it in the graphical editor, and then validate it:
Mapper mapper = new Mapper(Rectangle.class, Polygon.class);
SwingUtilities.invokeAndWait(new Runnable() {
@Override
public void run() {
UI.INSTANCE.openMappingsEditor(mapper, null, null, true);
}
});
mapper.validate();
```
```java
// Execute the mappings:
Rectangle source = new Rectangle();
System.out.println(source);
Polygon target = (Polygon) mapper.map(source);
```
```java
// Save/Load the mappings to/from a file (could be IO streams):
File mappingsFile = new File("tmp/mappings.xml");
mapper.saveMappings(mappingsFile);
mapper.loadMappings(mappingsFile);
```
```java
// Conveniently declare a constant Mapper instance associated with a resource
// (if the resource is not found then the graphical editor will open automatically
// and the mappings modifications will be testable in realtime and storable):
public static final Mapper MY_MAPPER = Mapper.get(Rectangle.class, Polygon.class, MappingsExample.class,
"mappings.xml");
target = (Polygon) MY_MAPPER.map(source);
System.out.println(target);
```
```java
// Hide the implementation details of the mappings in an interface and (optionally)
// allow the solution to coexist with other mappings frameworks (MapStruct, etc.):
public static MappingsExample INSTANCE = com.otk.jvm.util.Mappers.getMapper(MappingsExample.class,
com.otk.jvm.util.Mappers.MAP_STRUCT_FALLBACK_HANDLER);
// Note that the mappings method must have the @MappingsResource(location = ...) annotation.
target = INSTANCE.map(source);
System.out.println(target);
```
# Support
The support page is hosted [here on GitHub](https://github.com/dotxyteam/JVisualMapper/issues). You can also contact us by email: [dotxyteam@yahoo.fr](mailto:dotxyteam@yahoo.fr).