validation

.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

pom.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>2.4.1</version>
+        <relativePath/> <!-- lookup parent from repository -->
+    </parent>
+    <groupId>org.sadtech.example</groupId>
+    <artifactId>swagger</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>swagger</name>
+    <description>Demo project for Swagger</description>
+
+    <properties>
+        <java.version>1.8</java.version>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-annotations</artifactId>
+            <version>2.1.6</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-ui</artifactId>
+            <version>1.5.2</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

src/main/java/org/sadtech/example/swagger/controller/PointController.java

@@ -6,17 +6,21 @@ import io.swagger.v3.oas.annotations.tags.Tag;
 import org.sadtech.example.swagger.dto.TypeOperation;
 import org.sadtech.example.swagger.dto.UserDto;
 import org.springframework.http.HttpStatus;
+import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestPart;
 import org.springframework.web.bind.annotation.RestController;
 
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotBlank;
 import java.util.Map;
 
 /**
  * @author upagge 30.12.2020
  */
+@Validated
 @RestController
 @RequestMapping("api/user/point")
 @Tag(name = "Система лояльности", description = "Управляет балами пользователей")
@@ -31,9 +35,9 @@ public class PointController {
     @PostMapping("{key}")
     @Operation(summary = "Управление баллами", description = "Позволяет удалить или добавить баллы пользователю")
     public HttpStatus changePoints(
-            @PathVariable @Parameter(description = "Идентификатор пользователя") String key,
-            @RequestPart("point") @Parameter(description = "Количество баллов") Long point,
-            @RequestPart("type") @Parameter(description = "Тип операции") TypeOperation type
+            @PathVariable @NotBlank @Parameter(description = "Идентификатор пользователя") String key,
+            @RequestPart("point") @Min(0) @Parameter(description = "Количество баллов", required = true) Long point,
+            @RequestPart("type") @Parameter(description = "Тип операции", required = true) TypeOperation type
     ) {
         final UserDto userDto = repository.get(key);
         userDto.setPoints(

src/main/java/org/sadtech/example/swagger/dto/UserDto.java

@@ -2,6 +2,7 @@ package org.sadtech.example.swagger.dto;
 
 import io.swagger.v3.oas.annotations.media.Schema;
 
+import javax.validation.constraints.NotBlank;
 import java.time.LocalDateTime;
 
 /**
@@ -16,7 +17,7 @@ public class UserDto {
     @Schema(description = "ФИО", example = "Иванов Иван Иванович")
     private String name;
 
-    @Schema(description = "Баллы пользователя")
+    @Schema(description = "Баллы пользователя", accessMode = Schema.AccessMode.READ_ONLY)
     private Long points = 0L;
 
     @Schema(description = "Пол пользователя")