https://github.com/marcosvidolin/ditiow
🚀 Ditiow is a simple aspect library designed to help you safely expose features of your Spring REST API without having to expose data from the persistence or business layer of your application.
https://github.com/marcosvidolin/ditiow
api data-transfer-object dto microservices resource rest rest-api spring spring-boot webservice
Last synced: 11 months ago
JSON representation
🚀 Ditiow is a simple aspect library designed to help you safely expose features of your Spring REST API without having to expose data from the persistence or business layer of your application.
- Host: GitHub
- URL: https://github.com/marcosvidolin/ditiow
- Owner: marcosvidolin
- License: mit
- Created: 2019-12-22T15:33:02.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-05-15T20:04:23.000Z (about 5 years ago)
- Last Synced: 2025-04-05T16:12:08.243Z (about 1 year ago)
- Topics: api, data-transfer-object, dto, microservices, resource, rest, rest-api, spring, spring-boot, webservice
- Language: Java
- Homepage:
- Size: 272 KB
- Stars: 4
- Watchers: 2
- Forks: 4
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[  ](https://bintray.com/marcosvidolin/maven/ditiow/1.2.0/link) [](https://www.codacy.com/manual/marcosvidolin/ditiow?utm_source=github.com&utm_medium=referral&utm_content=marcosvidolin/ditiow&utm_campaign=Badge_Grade) 
Ditiow is an aspect library designed to help you safely expose features of your Spring REST API without having to expose data from the persistence or business layer of your application.
## Setup
1. Ditiow is release by publishing in to the JCenter. So add the "jcenter" in your dependency management.
- Gradle
```groovy
repositories {
jcenter()
}
```
- Maven
```xml
jcenter
jcenter
https://jcenter.bintray.com
```
2. Declaring the dependency
- Gradle
```groovy
compile 'com.vidolima:ditiow:1.2.0'
```
- Maven
```xml
com.vidolima
ditiow
1.2.0
pom
```
3. Declare DitiowAspect as a bean. Add aspect bean in one of the @Configuration classes
```java
@Configuration
public class DitiowConfig {
@Bean
public DitiowAspect ditiow() {
return new DitiowAspect();
}
}
```
## How to use
Domain class with all fields. **Nothing needs to be done at this point**.
```java
public class Post {
private Long code;
private UUID uuid;
private User author;
private String content;
private Date publishedAt;
private Collection comments;
// ...
}
```
### Returning a resource from the controller
- Here we specify the resource or how our Post object will be exposed by the API.
We do this by extending the AbstractResource class and informing the domain class (Post) as type.
Note that the name of the attributes are the same as Post.
*But I don't want to expose some attributes like database id and comments, for example.*
```java
public class PostGetResource extends AbstractResource {
private UUID uuid;
private User author;
private String content;
private Date publishedAt;
// ...
}
```
- Enable conversion by adding @ResponseResource annotation on controller class with the "PostGetResource" as the value of the annotation.
```java
@GetMapping(path = "/posts/{uuid}")
@ResponseResource(PostGetResource.class)
public ResponseEntity> get(@PathVariable UUID uuid) {
Post post = this.postService.findPostByUuid(uuid);
return ResponseEntity.ok(post);
}
```
Here the magic happens. The response will be converted to a PostGetResource object that is inserted into the body of the ResponseEntity object.
### Ignore the properties of a Resource at response time
- In this example the values of `author` and `publichedAt` fields will not be returned in the response
*Whenever a primitive field is ignored, its original value will be omitted and the corresponding default value will be returned.*
```java
@GetMapping(path = "/posts/{uuid}")
@ResponseResource(PostGetResource.class, ignoreProperties = {"author", "publishedAt"})
public ResponseEntity> get(@PathVariable UUID uuid) {
Post post = this.postService.findPostByUuid(uuid);
return ResponseEntity.ok(post);
}
```
### Retrieving a resource as a parameter
```java
public class PostCreateResource extends AbstractResource {
private UUID uuid;
@NotEmpty
@Length(min = 50, max = 300)
private String content;
// ...
}
```
```java
@PostMapping(path = "/posts")
@ResponseResource(PostGetResource.class)
public ResponseEntity> create(@Valid @RequestBody PostCreateResource resource) {
Post post = resource.toDomain(); // converts the resource into a Post
post.setAuthor(this.currentUserUtil.getUser());
return ResponseEntity.ok(this.postService.create(post));
}
```
## Contributors
[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/0)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/1)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/2)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/3)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/4)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/5)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/6)[](https://sourcerer.io/fame/marcosvidolin/marcosvidolin/ditiow/links/7)