Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/akkinoc/orika-spring-boot-starter
Spring Boot Starter for Orika.
https://github.com/akkinoc/orika-spring-boot-starter
java java-library kotlin kotlin-library mapper mapping orika spring-boot spring-boot-starter spring-framework
Last synced: 27 days ago
JSON representation
Spring Boot Starter for Orika.
- Host: GitHub
- URL: https://github.com/akkinoc/orika-spring-boot-starter
- Owner: akkinoc
- License: apache-2.0
- Created: 2016-12-06T17:07:58.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-09-27T23:28:09.000Z (about 1 month ago)
- Last Synced: 2024-09-29T00:05:20.039Z (about 1 month ago)
- Topics: java, java-library, kotlin, kotlin-library, mapper, mapping, orika, spring-boot, spring-boot-starter, spring-framework
- Language: Kotlin
- Homepage:
- Size: 771 KB
- Stars: 151
- Watchers: 11
- Forks: 32
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# orika-spring-boot-starter
[![maven central badge]][maven central]
[![javadoc badge]][javadoc]
[![release badge]][release]
[![build badge]][build]
[![codecov badge]][codecov]
[![license badge]][license]
[![sponsor badge]][sponsor][maven central]: https://maven-badges.herokuapp.com/maven-central/dev.akkinoc.spring.boot/orika-spring-boot-starter
[maven central badge]: https://maven-badges.herokuapp.com/maven-central/dev.akkinoc.spring.boot/orika-spring-boot-starter/badge.svg
[javadoc]: https://javadoc.io/doc/dev.akkinoc.spring.boot/orika-spring-boot-starter
[javadoc badge]: https://javadoc.io/badge2/dev.akkinoc.spring.boot/orika-spring-boot-starter/javadoc.svg
[release]: https://github.com/akkinoc/orika-spring-boot-starter/releases
[release badge]: https://img.shields.io/github/v/release/akkinoc/orika-spring-boot-starter?color=brightgreen&sort=semver
[build]: https://github.com/akkinoc/orika-spring-boot-starter/actions/workflows/build.yml
[build badge]: https://github.com/akkinoc/orika-spring-boot-starter/actions/workflows/build.yml/badge.svg
[codecov]: https://codecov.io/gh/akkinoc/orika-spring-boot-starter
[codecov badge]: https://codecov.io/gh/akkinoc/orika-spring-boot-starter/branch/main/graph/badge.svg
[license]: LICENSE.txt
[license badge]: https://img.shields.io/github/license/akkinoc/orika-spring-boot-starter?color=blue
[sponsor]: https://github.com/sponsors/akkinoc
[sponsor badge]: https://img.shields.io/static/v1?logo=github&label=sponsor&message=%E2%9D%A4&color=db61a2[Spring Boot] Starter for [Orika].
[Spring Boot]: https://spring.io/projects/spring-boot
[Orika]: https://orika-mapper.github.io/orika-docs⚠️ Please note that [Orika] has not been maintained for a long time ([orika-mapper/orika#372]).
[orika-mapper/orika#372]: https://github.com/orika-mapper/orika/issues/372
## Features
* Manages MapperFacade in the application context and makes it injectable into your code.
* Provides an interface to configure MapperFactory.
* Provides an interface to configure MapperFactoryBuilder.
* Provides configuration properties to configure MapperFactoryBuilder.## Dependencies
Depends on:
* Java 17 or 21
* Kotlin 1.9
* Spring Boot 3.3
* Orika 1.5The following JVM option is required ([orika-mapper/orika#377]).
[orika-mapper/orika#377]: https://github.com/orika-mapper/orika/issues/377
```console
--add-opens java.base/java.lang=ALL-UNNAMED
```## Usage
### Adding the Dependency
The artifact is published on [Maven Central Repository][maven central].
If you are using Maven, add the following dependency.```xml
dev.akkinoc.spring.boot
orika-spring-boot-starter
${orika-spring-boot-starter.version}```
### Injecting the MapperFacade
The MapperFacade is managed in the application context.
Inject the MapperFacade into your code.For example in Java:
```java
import ma.glasnost.orika.MapperFacade;
``````java
@Autowired
private MapperFacade orikaMapperFacade;
```### Mapping Your Beans
Map your beans using the MapperFacade.
For example in Java:
```java
// Maps from PersonSource to PersonDestination
PersonSource src = new PersonSource("John", "Smith", 23);
System.out.println(src); // => "PersonSource(firstName=John, lastName=Smith, age=23)"
PersonDestination dest = orikaMapperFacade.map(src, PersonDestination.class);
System.out.println(dest); // => "PersonDestination(givenName=John, sirName=Smith, age=23)"
```## MapperFactory Configuration
If you need to configure the MapperFactory,
create an instance of OrikaMapperFactoryConfigurer in the application context.
The OrikaMapperFactoryConfigurer components are auto-detected and the "configure" method is called.For example in Java:
```java
import dev.akkinoc.spring.boot.orika.OrikaMapperFactoryConfigurer;
import ma.glasnost.orika.MapperFactory;@Component
public class PersonMapping implements OrikaMapperFactoryConfigurer {
@Override
public void configure(MapperFactory orikaMapperFactory) {
orikaMapperFactory.classMap(PersonSource.class, PersonDestination.class)
.field("firstName", "givenName")
.field("lastName", "sirName")
.byDefault()
.register();
}
}
```See also the Orika User Guide:
* [Declarative Mapping Configuration](https://orika-mapper.github.io/orika-docs/mappings-via-classmapbuilder.html)
* [Advanced Mapping Configurations](https://orika-mapper.github.io/orika-docs/advanced-mappings.html)## MapperFactoryBuilder Configuration
If you need to configure the MapperFactoryBuilder,
create an instance of OrikaMapperFactoryBuilderConfigurer in the application context.
The OrikaMapperFactoryBuilderConfigurer components are auto-detected and the "configure" method is called.For example in Java:
```java
import dev.akkinoc.spring.boot.orika.OrikaMapperFactoryBuilderConfigurer;
import ma.glasnost.orika.impl.DefaultMapperFactory.MapperFactoryBuilder;@Component
public class OrikaConfiguration implements OrikaMapperFactoryBuilderConfigurer {
@Override
public void configure(MapperFactoryBuilder, ?> orikaMapperFactoryBuilder) {
// Your configuration codes.
}
}
```See also the Orika User Guide:
* [MapperFactory Configuration](https://orika-mapper.github.io/orika-docs/mapper-factory.html)
## Configuration Properties
Provides the following configuration properties.
These can be configured by your "application.yml", "application.properties", etc.```yaml
# The configuration properties for Orika.
orika:
# Whether to enable auto-configuration.
# Defaults to true.
enabled: true
# Whether to use built-in converters.
# See also MapperFactoryBuilder.useBuiltinConverters.
# By default, follows Orika's behavior.
use-builtin-converters: true
# Whether to use auto-mapping.
# See also MapperFactoryBuilder.useAutoMapping.
# By default, follows Orika's behavior.
use-auto-mapping: true
# Whether to map nulls.
# See also MapperFactoryBuilder.mapNulls.
# By default, follows Orika's behavior.
map-nulls: true
# Whether to dump the current state of the mapping infrastructure objects
# upon occurrence of an exception while mapping.
# See also MapperFactoryBuilder.dumpStateOnException.
# By default, follows Orika's behavior.
dump-state-on-exception: false
# Whether to favor extension by default in registered class-maps.
# See also MapperFactoryBuilder.favorExtension.
# By default, follows Orika's behavior.
favor-extension: false
# Whether full field context should be captured.
# See also MapperFactoryBuilder.captureFieldContext.
# By default, follows Orika's behavior.
capture-field-context: false
```## API Reference
Please refer to the [Javadoc][javadoc].
## Release Notes
Please refer to the [Releases][release] page.
## License
Licensed under the [Apache License, Version 2.0][license].
## Support the Project
If this project is useful to you, I appreciate giving a ⭐ star to this repository.
I would also appreciate if you would consider 💖 [sponsoring][sponsor] as well.
Your support is my biggest motive force. Thanks ✨