├── .mvn └── wrapper │ ├── maven-wrapper.jar │ └── maven-wrapper.properties ├── README.md ├── src ├── main │ ├── java │ │ └── com │ │ │ └── services │ │ │ └── ms │ │ │ └── student │ │ │ └── app │ │ │ ├── domain │ │ │ ├── exception │ │ │ │ └── StudentNotFoundException.java │ │ │ └── model │ │ │ │ ├── ErrorResponse.java │ │ │ │ └── Student.java │ │ │ ├── infrastructure │ │ │ └── adapters │ │ │ │ ├── output │ │ │ │ └── persistence │ │ │ │ │ ├── repository │ │ │ │ │ └── StudentRepository.java │ │ │ │ │ ├── mapper │ │ │ │ │ └── StudentPersistenceMapper.java │ │ │ │ │ ├── entity │ │ │ │ │ └── StudentEntity.java │ │ │ │ │ └── StudentPersistenceAdapter.java │ │ │ │ └── input │ │ │ │ └── rest │ │ │ │ ├── model │ │ │ │ ├── response │ │ │ │ │ ├── StudentResponse.java │ │ │ │ │ └── ErrorResponse.java │ │ │ │ └── request │ │ │ │ │ └── StudentCreateRequest.java │ │ │ │ ├── mapper │ │ │ │ └── StudentRestMapper.java │ │ │ │ ├── StudentRestAdapter.java │ │ │ │ └── GlobalControllerAdvice.java │ │ │ ├── application │ │ │ ├── ports │ │ │ │ ├── input │ │ │ │ │ └── StudentServicePort.java │ │ │ │ └── output │ │ │ │ │ └── StudentPersistencePort.java │ │ │ └── service │ │ │ │ └── StudentService.java │ │ │ ├── utils │ │ │ └── ErrorCatalog.java │ │ │ └── StudentServiceApplication.java │ └── resources │ │ ├── data.sql │ │ └── application.yml └── test │ └── java │ └── com │ └── services │ └── ms │ └── student │ └── app │ └── StudentServiceApplicationTests.java ├── .gitignore ├── docker-compose.yml ├── Dockerfile ├── pom.xml ├── mvnw.cmd └── mvnw /.mvn/wrapper/maven-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/UserAccount11/student-service/HEAD/.mvn/wrapper/maven-wrapper.jar -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # API REST DE ESTUDIANTES USANDO ARQUITECTURA HEXAGONAL CON SPRINGBOOT 3 2 | 3 | Proyecto de creación de un api rest de estudiantes usando arquitectura hexagonal. 4 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/domain/exception/StudentNotFoundException.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.domain.exception; 2 | 3 | public class StudentNotFoundException extends RuntimeException { 4 | } 5 | -------------------------------------------------------------------------------- /.mvn/wrapper/maven-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.5/apache-maven-3.9.5-bin.zip 2 | wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar 3 | -------------------------------------------------------------------------------- /src/test/java/com/services/ms/student/app/StudentServiceApplicationTests.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app; 2 | 3 | import org.junit.jupiter.api.Test; 4 | import org.springframework.boot.test.context.SpringBootTest; 5 | 6 | @SpringBootTest 7 | class StudentServiceApplicationTests { 8 | 9 | @Test 10 | void contextLoads() { 11 | } 12 | 13 | } 14 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/output/persistence/repository/StudentRepository.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.output.persistence.repository; 2 | 3 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.entity.StudentEntity; 4 | import org.springframework.data.jpa.repository.JpaRepository; 5 | 6 | public interface StudentRepository extends JpaRepository { 7 | } 8 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/application/ports/input/StudentServicePort.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.application.ports.input; 2 | 3 | import com.services.ms.student.app.domain.model.Student; 4 | 5 | import java.util.List; 6 | 7 | public interface StudentServicePort { 8 | 9 | Student findById(Long id); 10 | List findAll(); 11 | Student save(Student student); 12 | Student update(Long id, Student student); 13 | void deleteById(Long id); 14 | 15 | } 16 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/application/ports/output/StudentPersistencePort.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.application.ports.output; 2 | 3 | import com.services.ms.student.app.domain.model.Student; 4 | 5 | import java.util.List; 6 | import java.util.Optional; 7 | 8 | public interface StudentPersistencePort { 9 | 10 | Optional findById(Long id); 11 | List findAll(); 12 | Student save(Student student); 13 | void deleteById(Long id); 14 | 15 | } 16 | -------------------------------------------------------------------------------- /src/main/resources/data.sql: -------------------------------------------------------------------------------- 1 | INSERT INTO students (id, firstname, lastname, age, address) VALUES 2 | (1, 'Juan', 'Mendoza', 28, 'Calle 1'); 3 | 4 | INSERT INTO students (id, firstname, lastname, age, address) VALUES 5 | (2, 'Pedro', 'Ramirez', 30, 'Calle 2'); 6 | 7 | INSERT INTO students (id, firstname, lastname, age, address) VALUES 8 | (3, 'Pepito', 'Jimenez', 10, 'Calle 3'); 9 | 10 | INSERT INTO students (id, firstname, lastname, age, address) VALUES 11 | (4, 'Carmen', 'Velasquez', 40, 'Calle 4'); -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/domain/model/ErrorResponse.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.domain.model; 2 | 3 | import lombok.Builder; 4 | import lombok.Getter; 5 | import lombok.Setter; 6 | 7 | import java.time.LocalDateTime; 8 | import java.util.List; 9 | 10 | @Builder 11 | @Getter 12 | @Setter 13 | public class ErrorResponse { 14 | 15 | private String code; 16 | private String message; 17 | private List details; 18 | private LocalDateTime timestamp; 19 | 20 | } 21 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | HELP.md 2 | target/ 3 | !.mvn/wrapper/maven-wrapper.jar 4 | !**/src/main/**/target/ 5 | !**/src/test/**/target/ 6 | 7 | ### STS ### 8 | .apt_generated 9 | .classpath 10 | .factorypath 11 | .project 12 | .settings 13 | .springBeans 14 | .sts4-cache 15 | 16 | ### IntelliJ IDEA ### 17 | .idea 18 | *.iws 19 | *.iml 20 | *.ipr 21 | 22 | ### NetBeans ### 23 | /nbproject/private/ 24 | /nbbuild/ 25 | /dist/ 26 | /nbdist/ 27 | /.nb-gradle/ 28 | build/ 29 | !**/src/main/**/build/ 30 | !**/src/test/**/build/ 31 | 32 | ### VS Code ### 33 | .vscode/ 34 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/domain/model/Student.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.domain.model; 2 | 3 | import lombok.AllArgsConstructor; 4 | import lombok.Builder; 5 | import lombok.Getter; 6 | import lombok.NoArgsConstructor; 7 | import lombok.Setter; 8 | 9 | @Builder 10 | @Getter 11 | @Setter 12 | @NoArgsConstructor 13 | @AllArgsConstructor 14 | public class Student { 15 | 16 | private Long id; 17 | private String firstname; 18 | private String lastname; 19 | private Integer age; 20 | private String address; 21 | 22 | } 23 | -------------------------------------------------------------------------------- /src/main/resources/application.yml: -------------------------------------------------------------------------------- 1 | spring: 2 | application: 3 | name: student-service 4 | jackson: 5 | default-property-inclusion: non_null 6 | property-naming-strategy: SNAKE_CASE 7 | datasource: 8 | url: ${DB_HOST} 9 | username: ${DB_USER} 10 | password: ${DB_PASSWORD} 11 | driver-class-name: org.postgresql.Driver 12 | jpa: 13 | show-sql: true 14 | hibernate: 15 | ddl-auto: create 16 | properties: 17 | hibernate: 18 | dialect: org.hibernate.dialect.PostgreSQLDialect 19 | logging: 20 | level: 21 | org.hibernate.SQL: debug -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/utils/ErrorCatalog.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.utils; 2 | 3 | import lombok.Getter; 4 | 5 | @Getter 6 | public enum ErrorCatalog { 7 | 8 | STUDENT_NOT_FOUND("ERR_STUDENT_001", "Student not found."), 9 | INVALID_STUDENT("ERR_STUDENT_002", "Invalid student parameters."), 10 | GENERIC_ERROR("ERR_GEN_001", "An unexpected error occurred."); 11 | 12 | private final String code; 13 | private final String message; 14 | 15 | ErrorCatalog(String code, String message) { 16 | this.code = code; 17 | this.message = message; 18 | } 19 | 20 | } 21 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/model/response/StudentResponse.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest.model.response; 2 | 3 | import lombok.AllArgsConstructor; 4 | import lombok.Builder; 5 | import lombok.Getter; 6 | import lombok.NoArgsConstructor; 7 | import lombok.Setter; 8 | 9 | @Builder 10 | @Getter 11 | @Setter 12 | @AllArgsConstructor 13 | @NoArgsConstructor 14 | public class StudentResponse { 15 | 16 | private Long id; 17 | private String firstname; 18 | private String lastname; 19 | private Integer age; 20 | private String address; 21 | 22 | } 23 | -------------------------------------------------------------------------------- /docker-compose.yml: -------------------------------------------------------------------------------- 1 | version: '3.8' 2 | 3 | services: 4 | postgres: 5 | image: postgres:16-alpine 6 | container_name: postgres16 7 | environment: 8 | POSTGRES_USER: postgres 9 | POSTGRES_PASSWORD: postgres 10 | POSTGRES_DB: students_db 11 | ports: 12 | - "5432:5432" 13 | student-service: 14 | build: 15 | context: . 16 | dockerfile: Dockerfile 17 | image: student-service:latest 18 | container_name: student-service 19 | depends_on: 20 | - postgres 21 | environment: 22 | DB_HOST: jdbc:postgresql://postgres:5432/students_db 23 | DB_USER: postgres 24 | DB_PASSWORD: postgres 25 | ports: 26 | - "8080:8080" -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/model/response/ErrorResponse.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest.model.response; 2 | 3 | import lombok.AllArgsConstructor; 4 | import lombok.Builder; 5 | import lombok.Getter; 6 | import lombok.NoArgsConstructor; 7 | import lombok.Setter; 8 | 9 | import java.time.LocalDateTime; 10 | import java.util.List; 11 | 12 | @Builder 13 | @Getter 14 | @Setter 15 | @AllArgsConstructor 16 | @NoArgsConstructor 17 | public class ErrorResponse { 18 | 19 | private String code; 20 | private String message; 21 | private List details; 22 | private LocalDateTime timestamp; 23 | 24 | } 25 | -------------------------------------------------------------------------------- /Dockerfile: -------------------------------------------------------------------------------- 1 | ARG MSVC_NAME=student-service 2 | 3 | FROM openjdk:21 AS builder 4 | 5 | ARG MSVC_NAME 6 | 7 | WORKDIR /app/$MSVC_NAME 8 | 9 | COPY ./.mvn ./.mvn 10 | COPY ./mvnw . 11 | COPY ./pom.xml . 12 | 13 | RUN ./mvnw clean package -Dmaven.test.skip -Dmaven.main.skip -Dspring-boot.repackage.skip && rm -r ./target/ 14 | 15 | COPY ./src ./src 16 | 17 | RUN ./mvnw clean package -DskipTests 18 | 19 | 20 | FROM openjdk:21 21 | 22 | ARG MSVC_NAME 23 | 24 | WORKDIR /app 25 | 26 | ARG TARGET_FOLDER=/app/$MSVC_NAME/target 27 | COPY --from=builder $TARGET_FOLDER/student-service-0.0.1-SNAPSHOT.jar . 28 | ARG APP_PORT=8080 29 | ENV PORT $APP_PORT 30 | EXPOSE $PORT 31 | 32 | CMD ["java", "-jar", "student-service-0.0.1-SNAPSHOT.jar"] -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/output/persistence/mapper/StudentPersistenceMapper.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.output.persistence.mapper; 2 | 3 | import com.services.ms.student.app.domain.model.Student; 4 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.entity.StudentEntity; 5 | import org.mapstruct.Mapper; 6 | 7 | import java.util.List; 8 | 9 | @Mapper(componentModel = "spring") 10 | public interface StudentPersistenceMapper { 11 | 12 | StudentEntity toStudentEntity(Student student); 13 | 14 | Student toStudent(StudentEntity entity); 15 | 16 | List toStudentList(List entityList); 17 | 18 | } 19 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/mapper/StudentRestMapper.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest.mapper; 2 | 3 | import com.services.ms.student.app.domain.model.Student; 4 | import com.services.ms.student.app.infrastructure.adapters.input.rest.model.request.StudentCreateRequest; 5 | import com.services.ms.student.app.infrastructure.adapters.input.rest.model.response.StudentResponse; 6 | import org.mapstruct.Mapper; 7 | import org.mapstruct.ReportingPolicy; 8 | 9 | import java.util.List; 10 | 11 | @Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE) 12 | public interface StudentRestMapper { 13 | 14 | Student toStudent(StudentCreateRequest request); 15 | 16 | StudentResponse toStudentResponse(Student student); 17 | 18 | List toStudentResponseList(List studentList); 19 | 20 | } 21 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/output/persistence/entity/StudentEntity.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.output.persistence.entity; 2 | 3 | import jakarta.persistence.Entity; 4 | import jakarta.persistence.GeneratedValue; 5 | import jakarta.persistence.GenerationType; 6 | import jakarta.persistence.Id; 7 | import jakarta.persistence.Table; 8 | import lombok.AllArgsConstructor; 9 | import lombok.Getter; 10 | import lombok.NoArgsConstructor; 11 | import lombok.Setter; 12 | 13 | @Getter 14 | @Setter 15 | @Entity 16 | @AllArgsConstructor 17 | @NoArgsConstructor 18 | @Table(name = "students") 19 | public class StudentEntity { 20 | 21 | @Id 22 | @GeneratedValue(strategy = GenerationType.IDENTITY) 23 | private Long id; 24 | 25 | private String firstname; 26 | private String lastname; 27 | private Integer age; 28 | private String address; 29 | 30 | } 31 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/model/request/StudentCreateRequest.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest.model.request; 2 | 3 | import jakarta.validation.constraints.NotBlank; 4 | import jakarta.validation.constraints.NotNull; 5 | import lombok.AllArgsConstructor; 6 | import lombok.Builder; 7 | import lombok.Getter; 8 | import lombok.NoArgsConstructor; 9 | import lombok.Setter; 10 | 11 | @Builder 12 | @Getter 13 | @Setter 14 | @AllArgsConstructor 15 | @NoArgsConstructor 16 | public class StudentCreateRequest { 17 | 18 | @NotBlank(message = "Field firstname cannot be empty or null.") 19 | private String firstname; 20 | 21 | @NotBlank(message = "Field lastname cannot be empty or null.") 22 | private String lastname; 23 | 24 | @NotNull(message = "Field age cannot be null.") 25 | private Integer age; 26 | 27 | @NotBlank(message = "Field address cannot be empty or null.") 28 | private String address; 29 | 30 | } 31 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/StudentServiceApplication.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app; 2 | 3 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.entity.StudentEntity; 4 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.repository.StudentRepository; 5 | import lombok.RequiredArgsConstructor; 6 | import org.springframework.boot.CommandLineRunner; 7 | import org.springframework.boot.SpringApplication; 8 | import org.springframework.boot.autoconfigure.SpringBootApplication; 9 | 10 | import java.util.Arrays; 11 | import java.util.List; 12 | 13 | @SpringBootApplication 14 | @RequiredArgsConstructor 15 | public class StudentServiceApplication implements CommandLineRunner { 16 | 17 | private final StudentRepository repository; 18 | 19 | public static void main(String[] args) { 20 | SpringApplication.run(StudentServiceApplication.class, args); 21 | } 22 | 23 | @Override 24 | public void run(String... args) throws Exception { 25 | List entities = Arrays.asList( 26 | new StudentEntity(null, "Juan", "Mendoza", 28, "Calle 1"), 27 | new StudentEntity(null, "Carlos", "Rodriguez", 30, "Calle 2"), 28 | new StudentEntity(null, "Julio", "Perez", 10, "Calle 3"), 29 | new StudentEntity(null, "Roman", "Ramirez", 40, "Calle 4") 30 | ); 31 | repository.saveAll(entities); 32 | } 33 | 34 | } 35 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/output/persistence/StudentPersistenceAdapter.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.output.persistence; 2 | 3 | import com.services.ms.student.app.application.ports.output.StudentPersistencePort; 4 | import com.services.ms.student.app.domain.model.Student; 5 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.mapper.StudentPersistenceMapper; 6 | import com.services.ms.student.app.infrastructure.adapters.output.persistence.repository.StudentRepository; 7 | import lombok.RequiredArgsConstructor; 8 | import org.springframework.stereotype.Component; 9 | 10 | import java.util.List; 11 | import java.util.Optional; 12 | 13 | @Component 14 | @RequiredArgsConstructor 15 | public class StudentPersistenceAdapter implements StudentPersistencePort { 16 | 17 | private final StudentRepository repository; 18 | private final StudentPersistenceMapper mapper; 19 | 20 | @Override 21 | public Optional findById(Long id) { 22 | return repository.findById(id) 23 | .map(mapper::toStudent); 24 | } 25 | 26 | @Override 27 | public List findAll() { 28 | return mapper.toStudentList(repository.findAll()); 29 | } 30 | 31 | @Override 32 | public Student save(Student student) { 33 | return mapper.toStudent( 34 | repository.save(mapper.toStudentEntity(student))); 35 | } 36 | 37 | @Override 38 | public void deleteById(Long id) { 39 | repository.deleteById(id); 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/application/service/StudentService.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.application.service; 2 | 3 | import com.services.ms.student.app.application.ports.input.StudentServicePort; 4 | import com.services.ms.student.app.application.ports.output.StudentPersistencePort; 5 | import com.services.ms.student.app.domain.exception.StudentNotFoundException; 6 | import com.services.ms.student.app.domain.model.Student; 7 | import lombok.RequiredArgsConstructor; 8 | import org.springframework.stereotype.Service; 9 | 10 | import java.util.List; 11 | 12 | @Service 13 | @RequiredArgsConstructor 14 | public class StudentService implements StudentServicePort { 15 | 16 | private final StudentPersistencePort persistencePort; 17 | 18 | @Override 19 | public Student findById(Long id) { 20 | return persistencePort.findById(id) 21 | .orElseThrow(StudentNotFoundException::new); 22 | } 23 | 24 | @Override 25 | public List findAll() { 26 | return persistencePort.findAll(); 27 | } 28 | 29 | @Override 30 | public Student save(Student student) { 31 | return persistencePort.save(student); 32 | } 33 | 34 | @Override 35 | public Student update(Long id, Student student) { 36 | return persistencePort.findById(id) 37 | .map(savedStudent -> { 38 | savedStudent.setFirstname(student.getFirstname()); 39 | savedStudent.setLastname(student.getLastname()); 40 | savedStudent.setAge(student.getAge()); 41 | savedStudent.setAddress(student.getAddress()); 42 | return persistencePort.save(savedStudent); 43 | }) 44 | .orElseThrow(StudentNotFoundException::new); 45 | } 46 | 47 | @Override 48 | public void deleteById(Long id) { 49 | if (persistencePort.findById(id).isEmpty()) { 50 | throw new StudentNotFoundException(); 51 | } 52 | 53 | persistencePort.deleteById(id); 54 | } 55 | } 56 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/StudentRestAdapter.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest; 2 | 3 | import com.services.ms.student.app.application.ports.input.StudentServicePort; 4 | import com.services.ms.student.app.infrastructure.adapters.input.rest.mapper.StudentRestMapper; 5 | import com.services.ms.student.app.infrastructure.adapters.input.rest.model.request.StudentCreateRequest; 6 | import com.services.ms.student.app.infrastructure.adapters.input.rest.model.response.StudentResponse; 7 | import jakarta.validation.Valid; 8 | import lombok.RequiredArgsConstructor; 9 | import org.springframework.http.HttpStatus; 10 | import org.springframework.http.ResponseEntity; 11 | import org.springframework.web.bind.annotation.DeleteMapping; 12 | import org.springframework.web.bind.annotation.GetMapping; 13 | import org.springframework.web.bind.annotation.PathVariable; 14 | import org.springframework.web.bind.annotation.PostMapping; 15 | import org.springframework.web.bind.annotation.PutMapping; 16 | import org.springframework.web.bind.annotation.RequestBody; 17 | import org.springframework.web.bind.annotation.RequestMapping; 18 | import org.springframework.web.bind.annotation.RestController; 19 | 20 | import java.util.List; 21 | 22 | @RestController 23 | @RequiredArgsConstructor 24 | @RequestMapping("/students") 25 | public class StudentRestAdapter { 26 | 27 | private final StudentServicePort servicePort; 28 | private final StudentRestMapper restMapper; 29 | 30 | @GetMapping("/v1/api") 31 | public List findAll() { 32 | return restMapper.toStudentResponseList(servicePort.findAll()); 33 | } 34 | 35 | @GetMapping("/v1/api/{id}") 36 | public StudentResponse findById(@PathVariable Long id) { 37 | return restMapper.toStudentResponse(servicePort.findById(id)); 38 | } 39 | 40 | @PostMapping("/v1/api") 41 | public ResponseEntity save(@Valid @RequestBody StudentCreateRequest request) { 42 | return ResponseEntity.status(HttpStatus.CREATED) 43 | .body(restMapper.toStudentResponse( 44 | servicePort.save(restMapper.toStudent(request)))); 45 | } 46 | 47 | @PutMapping("/v1/api/{id}") 48 | public StudentResponse update(@PathVariable Long id, @Valid @RequestBody StudentCreateRequest request) { 49 | return restMapper.toStudentResponse( 50 | servicePort.update(id, restMapper.toStudent(request))); 51 | } 52 | 53 | @DeleteMapping("/v1/api/{id}") 54 | public void delete(@PathVariable Long id) { 55 | servicePort.deleteById(id); 56 | } 57 | 58 | } 59 | -------------------------------------------------------------------------------- /src/main/java/com/services/ms/student/app/infrastructure/adapters/input/rest/GlobalControllerAdvice.java: -------------------------------------------------------------------------------- 1 | package com.services.ms.student.app.infrastructure.adapters.input.rest; 2 | 3 | import com.services.ms.student.app.domain.exception.StudentNotFoundException; 4 | import com.services.ms.student.app.domain.model.ErrorResponse; 5 | import org.springframework.context.support.DefaultMessageSourceResolvable; 6 | import org.springframework.http.HttpStatus; 7 | import org.springframework.validation.BindingResult; 8 | import org.springframework.web.bind.MethodArgumentNotValidException; 9 | import org.springframework.web.bind.annotation.ExceptionHandler; 10 | import org.springframework.web.bind.annotation.ResponseStatus; 11 | import org.springframework.web.bind.annotation.RestControllerAdvice; 12 | 13 | import java.time.LocalDateTime; 14 | import java.util.Collections; 15 | import java.util.stream.Collectors; 16 | 17 | import static com.services.ms.student.app.utils.ErrorCatalog.GENERIC_ERROR; 18 | import static com.services.ms.student.app.utils.ErrorCatalog.INVALID_STUDENT; 19 | import static com.services.ms.student.app.utils.ErrorCatalog.STUDENT_NOT_FOUND; 20 | 21 | @RestControllerAdvice 22 | public class GlobalControllerAdvice { 23 | 24 | @ResponseStatus(HttpStatus.NOT_FOUND) 25 | @ExceptionHandler(StudentNotFoundException.class) 26 | public ErrorResponse handleStudentNotFoundException() { 27 | return ErrorResponse.builder() 28 | .code(STUDENT_NOT_FOUND.getCode()) 29 | .message(STUDENT_NOT_FOUND.getMessage()) 30 | .timestamp(LocalDateTime.now()) 31 | .build(); 32 | } 33 | 34 | @ResponseStatus(HttpStatus.BAD_REQUEST) 35 | @ExceptionHandler(MethodArgumentNotValidException.class) 36 | public ErrorResponse handleMethodArgumentNotValidException( 37 | MethodArgumentNotValidException exception) { 38 | BindingResult result = exception.getBindingResult(); 39 | 40 | return ErrorResponse.builder() 41 | .code(INVALID_STUDENT.getCode()) 42 | .message(INVALID_STUDENT.getMessage()) 43 | .details(result.getFieldErrors() 44 | .stream() 45 | .map(DefaultMessageSourceResolvable::getDefaultMessage) 46 | .collect(Collectors.toList())) 47 | .timestamp(LocalDateTime.now()) 48 | .build(); 49 | } 50 | 51 | @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR) 52 | @ExceptionHandler(Exception.class) 53 | public ErrorResponse handleGenericError(Exception exception) { 54 | return ErrorResponse.builder() 55 | .code(GENERIC_ERROR.getCode()) 56 | .message(GENERIC_ERROR.getMessage()) 57 | .details(Collections.singletonList(exception.getMessage())) 58 | .timestamp(LocalDateTime.now()) 59 | .build(); 60 | } 61 | 62 | } 63 | -------------------------------------------------------------------------------- /pom.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 4.0.0 5 | 6 | org.springframework.boot 7 | spring-boot-starter-parent 8 | 3.2.2 9 | 10 | 11 | 12 | com.services.ms.student 13 | student-service 14 | 0.0.1-SNAPSHOT 15 | student-service 16 | Demo project for Spring Boot 17 | 18 | 19 | 21 20 | 21 | 22 | 23 | 24 | org.springframework.boot 25 | spring-boot-starter-data-jpa 26 | 27 | 28 | 29 | org.springframework.boot 30 | spring-boot-starter-validation 31 | 32 | 33 | 34 | org.springframework.boot 35 | spring-boot-starter-web 36 | 37 | 38 | 39 | org.postgresql 40 | postgresql 41 | runtime 42 | 43 | 44 | 45 | org.projectlombok 46 | lombok 47 | 1.18.30 48 | provided 49 | 50 | 51 | 52 | org.mapstruct 53 | mapstruct 54 | 1.5.5.Final 55 | 56 | 57 | 58 | org.springframework.boot 59 | spring-boot-starter-test 60 | test 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | org.apache.maven.plugins 80 | maven-compiler-plugin 81 | 3.11.0 82 | 83 | 21 84 | 21 85 | 86 | 87 | org.projectlombok 88 | lombok 89 | 1.18.30 90 | 91 | 92 | org.mapstruct 93 | mapstruct-processor 94 | 1.5.5.Final 95 | 96 | 97 | org.projectlombok 98 | lombok-mapstruct-binding 99 | 0.2.0 100 | 101 | 102 | 103 | 104 | 105 | 106 | org.apache.maven.plugins 107 | maven-jar-plugin 108 | 3.2.0 109 | 110 | 111 | 112 | true 113 | com.services.ms.student.app.StudentServiceApplication 114 | 115 | 116 | 117 | 118 | 119 | 120 | org.springframework.boot 121 | spring-boot-maven-plugin 122 | 123 | 124 | 125 | 126 | 127 | -------------------------------------------------------------------------------- /mvnw.cmd: -------------------------------------------------------------------------------- 1 | @REM ---------------------------------------------------------------------------- 2 | @REM Licensed to the Apache Software Foundation (ASF) under one 3 | @REM or more contributor license agreements. See the NOTICE file 4 | @REM distributed with this work for additional information 5 | @REM regarding copyright ownership. The ASF licenses this file 6 | @REM to you under the Apache License, Version 2.0 (the 7 | @REM "License"); you may not use this file except in compliance 8 | @REM with the License. You may obtain a copy of the License at 9 | @REM 10 | @REM https://www.apache.org/licenses/LICENSE-2.0 11 | @REM 12 | @REM Unless required by applicable law or agreed to in writing, 13 | @REM software distributed under the License is distributed on an 14 | @REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | @REM KIND, either express or implied. See the License for the 16 | @REM specific language governing permissions and limitations 17 | @REM under the License. 18 | @REM ---------------------------------------------------------------------------- 19 | 20 | @REM ---------------------------------------------------------------------------- 21 | @REM Apache Maven Wrapper startup batch script, version 3.2.0 22 | @REM 23 | @REM Required ENV vars: 24 | @REM JAVA_HOME - location of a JDK home dir 25 | @REM 26 | @REM Optional ENV vars 27 | @REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands 28 | @REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending 29 | @REM MAVEN_OPTS - parameters passed to the Java VM when running Maven 30 | @REM e.g. to debug Maven itself, use 31 | @REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 32 | @REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files 33 | @REM ---------------------------------------------------------------------------- 34 | 35 | @REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' 36 | @echo off 37 | @REM set title of command window 38 | title %0 39 | @REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' 40 | @if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% 41 | 42 | @REM set %HOME% to equivalent of $HOME 43 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") 44 | 45 | @REM Execute a user defined script before this one 46 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre 47 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending 48 | if exist "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %* 49 | if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\mavenrc_pre.cmd" %* 50 | :skipRcPre 51 | 52 | @setlocal 53 | 54 | set ERROR_CODE=0 55 | 56 | @REM To isolate internal variables from possible post scripts, we use another setlocal 57 | @setlocal 58 | 59 | @REM ==== START VALIDATION ==== 60 | if not "%JAVA_HOME%" == "" goto OkJHome 61 | 62 | echo. 63 | echo Error: JAVA_HOME not found in your environment. >&2 64 | echo Please set the JAVA_HOME variable in your environment to match the >&2 65 | echo location of your Java installation. >&2 66 | echo. 67 | goto error 68 | 69 | :OkJHome 70 | if exist "%JAVA_HOME%\bin\java.exe" goto init 71 | 72 | echo. 73 | echo Error: JAVA_HOME is set to an invalid directory. >&2 74 | echo JAVA_HOME = "%JAVA_HOME%" >&2 75 | echo Please set the JAVA_HOME variable in your environment to match the >&2 76 | echo location of your Java installation. >&2 77 | echo. 78 | goto error 79 | 80 | @REM ==== END VALIDATION ==== 81 | 82 | :init 83 | 84 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn". 85 | @REM Fallback to current working directory if not found. 86 | 87 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% 88 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir 89 | 90 | set EXEC_DIR=%CD% 91 | set WDIR=%EXEC_DIR% 92 | :findBaseDir 93 | IF EXIST "%WDIR%"\.mvn goto baseDirFound 94 | cd .. 95 | IF "%WDIR%"=="%CD%" goto baseDirNotFound 96 | set WDIR=%CD% 97 | goto findBaseDir 98 | 99 | :baseDirFound 100 | set MAVEN_PROJECTBASEDIR=%WDIR% 101 | cd "%EXEC_DIR%" 102 | goto endDetectBaseDir 103 | 104 | :baseDirNotFound 105 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR% 106 | cd "%EXEC_DIR%" 107 | 108 | :endDetectBaseDir 109 | 110 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig 111 | 112 | @setlocal EnableExtensions EnableDelayedExpansion 113 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a 114 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% 115 | 116 | :endReadAdditionalConfig 117 | 118 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" 119 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" 120 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 121 | 122 | set WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" 123 | 124 | FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( 125 | IF "%%A"=="wrapperUrl" SET WRAPPER_URL=%%B 126 | ) 127 | 128 | @REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 129 | @REM This allows using the maven wrapper in projects that prohibit checking in binary data. 130 | if exist %WRAPPER_JAR% ( 131 | if "%MVNW_VERBOSE%" == "true" ( 132 | echo Found %WRAPPER_JAR% 133 | ) 134 | ) else ( 135 | if not "%MVNW_REPOURL%" == "" ( 136 | SET WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" 137 | ) 138 | if "%MVNW_VERBOSE%" == "true" ( 139 | echo Couldn't find %WRAPPER_JAR%, downloading it ... 140 | echo Downloading from: %WRAPPER_URL% 141 | ) 142 | 143 | powershell -Command "&{"^ 144 | "$webclient = new-object System.Net.WebClient;"^ 145 | "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ 146 | "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ 147 | "}"^ 148 | "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%WRAPPER_URL%', '%WRAPPER_JAR%')"^ 149 | "}" 150 | if "%MVNW_VERBOSE%" == "true" ( 151 | echo Finished downloading %WRAPPER_JAR% 152 | ) 153 | ) 154 | @REM End of extension 155 | 156 | @REM If specified, validate the SHA-256 sum of the Maven wrapper jar file 157 | SET WRAPPER_SHA_256_SUM="" 158 | FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( 159 | IF "%%A"=="wrapperSha256Sum" SET WRAPPER_SHA_256_SUM=%%B 160 | ) 161 | IF NOT %WRAPPER_SHA_256_SUM%=="" ( 162 | powershell -Command "&{"^ 163 | "$hash = (Get-FileHash \"%WRAPPER_JAR%\" -Algorithm SHA256).Hash.ToLower();"^ 164 | "If('%WRAPPER_SHA_256_SUM%' -ne $hash){"^ 165 | " Write-Output 'Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised.';"^ 166 | " Write-Output 'Investigate or delete %WRAPPER_JAR% to attempt a clean download.';"^ 167 | " Write-Output 'If you updated your Maven version, you need to update the specified wrapperSha256Sum property.';"^ 168 | " exit 1;"^ 169 | "}"^ 170 | "}" 171 | if ERRORLEVEL 1 goto error 172 | ) 173 | 174 | @REM Provide a "standardized" way to retrieve the CLI args that will 175 | @REM work with both Windows and non-Windows executions. 176 | set MAVEN_CMD_LINE_ARGS=%* 177 | 178 | %MAVEN_JAVA_EXE% ^ 179 | %JVM_CONFIG_MAVEN_PROPS% ^ 180 | %MAVEN_OPTS% ^ 181 | %MAVEN_DEBUG_OPTS% ^ 182 | -classpath %WRAPPER_JAR% ^ 183 | "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" ^ 184 | %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* 185 | if ERRORLEVEL 1 goto error 186 | goto end 187 | 188 | :error 189 | set ERROR_CODE=1 190 | 191 | :end 192 | @endlocal & set ERROR_CODE=%ERROR_CODE% 193 | 194 | if not "%MAVEN_SKIP_RC%"=="" goto skipRcPost 195 | @REM check for post script, once with legacy .bat ending and once with .cmd ending 196 | if exist "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat" 197 | if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\mavenrc_post.cmd" 198 | :skipRcPost 199 | 200 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' 201 | if "%MAVEN_BATCH_PAUSE%"=="on" pause 202 | 203 | if "%MAVEN_TERMINATE_CMD%"=="on" exit %ERROR_CODE% 204 | 205 | cmd /C exit /B %ERROR_CODE% 206 | -------------------------------------------------------------------------------- /mvnw: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | # ---------------------------------------------------------------------------- 3 | # Licensed to the Apache Software Foundation (ASF) under one 4 | # or more contributor license agreements. See the NOTICE file 5 | # distributed with this work for additional information 6 | # regarding copyright ownership. The ASF licenses this file 7 | # to you under the Apache License, Version 2.0 (the 8 | # "License"); you may not use this file except in compliance 9 | # with the License. You may obtain a copy of the License at 10 | # 11 | # https://www.apache.org/licenses/LICENSE-2.0 12 | # 13 | # Unless required by applicable law or agreed to in writing, 14 | # software distributed under the License is distributed on an 15 | # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 | # KIND, either express or implied. See the License for the 17 | # specific language governing permissions and limitations 18 | # under the License. 19 | # ---------------------------------------------------------------------------- 20 | 21 | # ---------------------------------------------------------------------------- 22 | # Apache Maven Wrapper startup batch script, version 3.2.0 23 | # 24 | # Required ENV vars: 25 | # ------------------ 26 | # JAVA_HOME - location of a JDK home dir 27 | # 28 | # Optional ENV vars 29 | # ----------------- 30 | # MAVEN_OPTS - parameters passed to the Java VM when running Maven 31 | # e.g. to debug Maven itself, use 32 | # set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 33 | # MAVEN_SKIP_RC - flag to disable loading of mavenrc files 34 | # ---------------------------------------------------------------------------- 35 | 36 | if [ -z "$MAVEN_SKIP_RC" ] ; then 37 | 38 | if [ -f /usr/local/etc/mavenrc ] ; then 39 | . /usr/local/etc/mavenrc 40 | fi 41 | 42 | if [ -f /etc/mavenrc ] ; then 43 | . /etc/mavenrc 44 | fi 45 | 46 | if [ -f "$HOME/.mavenrc" ] ; then 47 | . "$HOME/.mavenrc" 48 | fi 49 | 50 | fi 51 | 52 | # OS specific support. $var _must_ be set to either true or false. 53 | cygwin=false; 54 | darwin=false; 55 | mingw=false 56 | case "$(uname)" in 57 | CYGWIN*) cygwin=true ;; 58 | MINGW*) mingw=true;; 59 | Darwin*) darwin=true 60 | # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home 61 | # See https://developer.apple.com/library/mac/qa/qa1170/_index.html 62 | if [ -z "$JAVA_HOME" ]; then 63 | if [ -x "/usr/libexec/java_home" ]; then 64 | JAVA_HOME="$(/usr/libexec/java_home)"; export JAVA_HOME 65 | else 66 | JAVA_HOME="/Library/Java/Home"; export JAVA_HOME 67 | fi 68 | fi 69 | ;; 70 | esac 71 | 72 | if [ -z "$JAVA_HOME" ] ; then 73 | if [ -r /etc/gentoo-release ] ; then 74 | JAVA_HOME=$(java-config --jre-home) 75 | fi 76 | fi 77 | 78 | # For Cygwin, ensure paths are in UNIX format before anything is touched 79 | if $cygwin ; then 80 | [ -n "$JAVA_HOME" ] && 81 | JAVA_HOME=$(cygpath --unix "$JAVA_HOME") 82 | [ -n "$CLASSPATH" ] && 83 | CLASSPATH=$(cygpath --path --unix "$CLASSPATH") 84 | fi 85 | 86 | # For Mingw, ensure paths are in UNIX format before anything is touched 87 | if $mingw ; then 88 | [ -n "$JAVA_HOME" ] && [ -d "$JAVA_HOME" ] && 89 | JAVA_HOME="$(cd "$JAVA_HOME" || (echo "cannot cd into $JAVA_HOME."; exit 1); pwd)" 90 | fi 91 | 92 | if [ -z "$JAVA_HOME" ]; then 93 | javaExecutable="$(which javac)" 94 | if [ -n "$javaExecutable" ] && ! [ "$(expr "\"$javaExecutable\"" : '\([^ ]*\)')" = "no" ]; then 95 | # readlink(1) is not available as standard on Solaris 10. 96 | readLink=$(which readlink) 97 | if [ ! "$(expr "$readLink" : '\([^ ]*\)')" = "no" ]; then 98 | if $darwin ; then 99 | javaHome="$(dirname "\"$javaExecutable\"")" 100 | javaExecutable="$(cd "\"$javaHome\"" && pwd -P)/javac" 101 | else 102 | javaExecutable="$(readlink -f "\"$javaExecutable\"")" 103 | fi 104 | javaHome="$(dirname "\"$javaExecutable\"")" 105 | javaHome=$(expr "$javaHome" : '\(.*\)/bin') 106 | JAVA_HOME="$javaHome" 107 | export JAVA_HOME 108 | fi 109 | fi 110 | fi 111 | 112 | if [ -z "$JAVACMD" ] ; then 113 | if [ -n "$JAVA_HOME" ] ; then 114 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 115 | # IBM's JDK on AIX uses strange locations for the executables 116 | JAVACMD="$JAVA_HOME/jre/sh/java" 117 | else 118 | JAVACMD="$JAVA_HOME/bin/java" 119 | fi 120 | else 121 | JAVACMD="$(\unset -f command 2>/dev/null; \command -v java)" 122 | fi 123 | fi 124 | 125 | if [ ! -x "$JAVACMD" ] ; then 126 | echo "Error: JAVA_HOME is not defined correctly." >&2 127 | echo " We cannot execute $JAVACMD" >&2 128 | exit 1 129 | fi 130 | 131 | if [ -z "$JAVA_HOME" ] ; then 132 | echo "Warning: JAVA_HOME environment variable is not set." 133 | fi 134 | 135 | # traverses directory structure from process work directory to filesystem root 136 | # first directory with .mvn subdirectory is considered project base directory 137 | find_maven_basedir() { 138 | if [ -z "$1" ] 139 | then 140 | echo "Path not specified to find_maven_basedir" 141 | return 1 142 | fi 143 | 144 | basedir="$1" 145 | wdir="$1" 146 | while [ "$wdir" != '/' ] ; do 147 | if [ -d "$wdir"/.mvn ] ; then 148 | basedir=$wdir 149 | break 150 | fi 151 | # workaround for JBEAP-8937 (on Solaris 10/Sparc) 152 | if [ -d "${wdir}" ]; then 153 | wdir=$(cd "$wdir/.." || exit 1; pwd) 154 | fi 155 | # end of workaround 156 | done 157 | printf '%s' "$(cd "$basedir" || exit 1; pwd)" 158 | } 159 | 160 | # concatenates all lines of a file 161 | concat_lines() { 162 | if [ -f "$1" ]; then 163 | # Remove \r in case we run on Windows within Git Bash 164 | # and check out the repository with auto CRLF management 165 | # enabled. Otherwise, we may read lines that are delimited with 166 | # \r\n and produce $'-Xarg\r' rather than -Xarg due to word 167 | # splitting rules. 168 | tr -s '\r\n' ' ' < "$1" 169 | fi 170 | } 171 | 172 | log() { 173 | if [ "$MVNW_VERBOSE" = true ]; then 174 | printf '%s\n' "$1" 175 | fi 176 | } 177 | 178 | BASE_DIR=$(find_maven_basedir "$(dirname "$0")") 179 | if [ -z "$BASE_DIR" ]; then 180 | exit 1; 181 | fi 182 | 183 | MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}; export MAVEN_PROJECTBASEDIR 184 | log "$MAVEN_PROJECTBASEDIR" 185 | 186 | ########################################################################################## 187 | # Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 188 | # This allows using the maven wrapper in projects that prohibit checking in binary data. 189 | ########################################################################################## 190 | wrapperJarPath="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" 191 | if [ -r "$wrapperJarPath" ]; then 192 | log "Found $wrapperJarPath" 193 | else 194 | log "Couldn't find $wrapperJarPath, downloading it ..." 195 | 196 | if [ -n "$MVNW_REPOURL" ]; then 197 | wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" 198 | else 199 | wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar" 200 | fi 201 | while IFS="=" read -r key value; do 202 | # Remove '\r' from value to allow usage on windows as IFS does not consider '\r' as a separator ( considers space, tab, new line ('\n'), and custom '=' ) 203 | safeValue=$(echo "$value" | tr -d '\r') 204 | case "$key" in (wrapperUrl) wrapperUrl="$safeValue"; break ;; 205 | esac 206 | done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties" 207 | log "Downloading from: $wrapperUrl" 208 | 209 | if $cygwin; then 210 | wrapperJarPath=$(cygpath --path --windows "$wrapperJarPath") 211 | fi 212 | 213 | if command -v wget > /dev/null; then 214 | log "Found wget ... using wget" 215 | [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--quiet" 216 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 217 | wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" 218 | else 219 | wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath" 220 | fi 221 | elif command -v curl > /dev/null; then 222 | log "Found curl ... using curl" 223 | [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--silent" 224 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 225 | curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath" 226 | else 227 | curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath" 228 | fi 229 | else 230 | log "Falling back to using Java to download" 231 | javaSource="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.java" 232 | javaClass="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.class" 233 | # For Cygwin, switch paths to Windows format before running javac 234 | if $cygwin; then 235 | javaSource=$(cygpath --path --windows "$javaSource") 236 | javaClass=$(cygpath --path --windows "$javaClass") 237 | fi 238 | if [ -e "$javaSource" ]; then 239 | if [ ! -e "$javaClass" ]; then 240 | log " - Compiling MavenWrapperDownloader.java ..." 241 | ("$JAVA_HOME/bin/javac" "$javaSource") 242 | fi 243 | if [ -e "$javaClass" ]; then 244 | log " - Running MavenWrapperDownloader.java ..." 245 | ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$wrapperUrl" "$wrapperJarPath") || rm -f "$wrapperJarPath" 246 | fi 247 | fi 248 | fi 249 | fi 250 | ########################################################################################## 251 | # End of extension 252 | ########################################################################################## 253 | 254 | # If specified, validate the SHA-256 sum of the Maven wrapper jar file 255 | wrapperSha256Sum="" 256 | while IFS="=" read -r key value; do 257 | case "$key" in (wrapperSha256Sum) wrapperSha256Sum=$value; break ;; 258 | esac 259 | done < "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties" 260 | if [ -n "$wrapperSha256Sum" ]; then 261 | wrapperSha256Result=false 262 | if command -v sha256sum > /dev/null; then 263 | if echo "$wrapperSha256Sum $wrapperJarPath" | sha256sum -c > /dev/null 2>&1; then 264 | wrapperSha256Result=true 265 | fi 266 | elif command -v shasum > /dev/null; then 267 | if echo "$wrapperSha256Sum $wrapperJarPath" | shasum -a 256 -c > /dev/null 2>&1; then 268 | wrapperSha256Result=true 269 | fi 270 | else 271 | echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." 272 | echo "Please install either command, or disable validation by removing 'wrapperSha256Sum' from your maven-wrapper.properties." 273 | exit 1 274 | fi 275 | if [ $wrapperSha256Result = false ]; then 276 | echo "Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised." >&2 277 | echo "Investigate or delete $wrapperJarPath to attempt a clean download." >&2 278 | echo "If you updated your Maven version, you need to update the specified wrapperSha256Sum property." >&2 279 | exit 1 280 | fi 281 | fi 282 | 283 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" 284 | 285 | # For Cygwin, switch paths to Windows format before running java 286 | if $cygwin; then 287 | [ -n "$JAVA_HOME" ] && 288 | JAVA_HOME=$(cygpath --path --windows "$JAVA_HOME") 289 | [ -n "$CLASSPATH" ] && 290 | CLASSPATH=$(cygpath --path --windows "$CLASSPATH") 291 | [ -n "$MAVEN_PROJECTBASEDIR" ] && 292 | MAVEN_PROJECTBASEDIR=$(cygpath --path --windows "$MAVEN_PROJECTBASEDIR") 293 | fi 294 | 295 | # Provide a "standardized" way to retrieve the CLI args that will 296 | # work with both Windows and non-Windows executions. 297 | MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $*" 298 | export MAVEN_CMD_LINE_ARGS 299 | 300 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 301 | 302 | # shellcheck disable=SC2086 # safe args 303 | exec "$JAVACMD" \ 304 | $MAVEN_OPTS \ 305 | $MAVEN_DEBUG_OPTS \ 306 | -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ 307 | "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ 308 | ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" 309 | --------------------------------------------------------------------------------