Skip to content

Commit

Permalink
Merge branch 'release/5.1.2.RELEASE.20240211'
Browse files Browse the repository at this point in the history
  • Loading branch information
JesusHdez960717 committed Feb 11, 2024
2 parents 32ff8d3 + 1937a7a commit 0383954
Show file tree
Hide file tree
Showing 4 changed files with 14 additions and 161 deletions.
3 changes: 3 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
* 5.1.2.RELEASE.20240211:
* **REMOVED** :-: : Removed `ApiResponse`

* 5.1.1.RELEASE.20231215:
* **DOCS** :
* **UPDATE** :+1: : Update `how to use it`.
Expand Down
80 changes: 10 additions & 70 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<!--
Multilanguage:
[Español](README.es.md)
[Espa�ol](README.es.md)
-->

## Root101 Commons [EN]

This library aims to provide standards and utilities that make work easier when creating microservices.

Docs updated for version: `X.X.X.RELEASE.2023XXXX`
Docs updated for version: `5.1.2.RELEASE.20240211`

## Table of Contents
- [1 - Validations](#1)
Expand All @@ -24,9 +24,6 @@ Docs updated for version: `X.X.X.RELEASE.2023XXXX`
- [1.6.3 - Size Exact](#1.6.3)
- [2 - Exceptions](#2)
- [4 - Rest](#3)
- [4.1 - Api response](#3.1)
- [4.2 - Response Extractor (Next)](#3.2)
- [4.3 - Rest Template utils (Next)](#3.3)
- [5 - Utils](#4)
- [5.1 - Jackson](#4.1)
- [5.2 - Enum mappeable](#4.2)
Expand Down Expand Up @@ -86,17 +83,17 @@ ValidationException{
ValidationErrorMessage[
source = root[0].parentName,
invalid_value = Pepito,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
],
ValidationErrorMessage[
source = root[1].childName,
invalid_value = Pepito Junior,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
],
ValidationErrorMessage[
source = root[2].childName,
invalid_value = Pepito Junior 2,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
]
]
}
Expand Down Expand Up @@ -131,7 +128,7 @@ ValidationException{
ValidationErrorMessage[
source = parentName,
invalid_value = Pepito Simple,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
]
]
}
Expand Down Expand Up @@ -181,17 +178,17 @@ ValidationException{
ValidationErrorMessage[
source = parentName,
invalid_value = Pepito,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
],
ValidationErrorMessage[
source = childrens[0].childName,
invalid_value = Pepito Junior,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
],
ValidationErrorMessage[
source = childrens[1].childName,
invalid_value = Pepito Junior 2,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
]
]
}
Expand Down Expand Up @@ -226,7 +223,7 @@ ValidationException{
ValidationErrorMessage[
source = parent_name, // => note here how the value change from `parentName` to `parent_name`
invalid_value = Pepito Simple,
message = el tamaño debe estar entre 1 y 5
message = el tama�o debe estar entre 1 y 5
]
]
}
Expand Down Expand Up @@ -480,63 +477,6 @@ Para estandarizar el uso de las respuestas HTTP se crearon las excepciones(mas c

Oficial docs for HTTP Responses [here](https://datatracker.ietf.org/doc/html/rfc7231).

### 3.1 Api Response <a name="3.1"></a>
The idea of `ApiResponse` is to generalize API responses to a standard.
ALL API responses must follow this guideline.
The `ApiResponse` class has:
- `status`: Representing the HTTP code of the response.
- `message`: The response message to the request.
- `data`: The data or information of the response, if there is a response.
Ejemplos:
1 - A request to modify a record that is executed successfully must return:
```java
ApiResponse{
status = 200,
message = "Success",
data = null
}
```

2 - A request to obtain a list must return:
```java
ApiResponse{
status = 200,
message = "Success",
data = [
"Data 1",
"Data 2",
"Data 3"
]
}
```

3 - A request to obtain an object must return:
```java
ApiResponse{
status = 200,
message = "Success",
data = SomeObject{
field1 = "some data",
field2 = "some data 2"
}
}
```

4 - A request to create users with a name that already exists should return:
```java
ApiResponse{
status = 409,
message = "Username already exists",
}
```

How to use it:
- For response 200 you can use: `ApiResponse.success()`, which by default says `status = 200`, `message = success` and `data = null`.
- For response 200 you can use: `ApiResponse.success(data)`, which by default says `status = 200` and `message = success`.
- For response 200 you can use: `ApiResponse.success(message, data)`, which by default says `status = 200`.
- For generic responses you can use: `ApiResponse.build(status, message, data)`.
- To extract a response from a `ResponseEntity` you can use: `ApiResponse.build(status, message, data)`, which by default says `status = response.getStatusCode().value()`, `message = response. getStatusCode().toString()` and `data = response.getBody()`.

## 4 - Utils <a name="4"></a>

### 4.1 - Jackson <a name="4.1"></a>
Expand Down
2 changes: 1 addition & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ plugins {

group = 'dev.root101.commons'

version = '5.1.1.RELEASE.20231215'
version = '5.1.2.RELEASE.20240211'

repositories {
jcenter()
Expand Down
90 changes: 0 additions & 90 deletions src/main/java/dev/root101/commons/rest/ApiResponse.java

This file was deleted.

0 comments on commit 0383954

Please sign in to comment.