init commit

This commit is contained in:
2026-10-22 20:59:59 +03:00
parent ec540a1a72
commit 1fddc0e76c
95 changed files with 5668 additions and 27 deletions
@@ -0,0 +1,119 @@
/**
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech) (7.10.0).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package ru.mtusi.messenger.controller;
import jakarta.servlet.http.HttpServletRequest;
import ru.mtusi.messenger.dto.SessionDTO;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import jakarta.annotation.Generated;
@Generated(value = "org.openapitools.codegen.languages.SpringCodegen", comments = "Generator version: 7.10.0")
@Validated
@Tag(name = "Auth", description = "Аутентификация: вход по Basic и выдача/отзыв сессионного Bearer-токена.")
@RequestMapping("${openapi.mTUSIMessenger2.base-path:}")
public interface AuthApi {
/**
* POST /api/v1/auth/sessions : Вход: Basic username:password; выдаёт сессию
*
* @return Успех (status code 201)
* or Неверный запрос (status code 400)
* or Нет действительной аутентификации (status code 401)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "createSession",
summary = "Вход: Basic username:password; выдаёт сессию",
tags = { "Auth" },
responses = {
@ApiResponse(responseCode = "201", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = SessionDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
})
},
security = {
@SecurityRequirement(name = "basicAuth")
}
)
@RequestMapping(
method = RequestMethod.POST,
value = "/api/v1/auth/sessions",
produces = { "application/json" }
)
ResponseEntity<SessionDTO> createSession(
HttpServletRequest request
);
/**
* DELETE /api/v1/auth/sessions/current : Отозвать текущую сессию
*
* @return Успех (status code 204)
* or Нет действительной аутентификации (status code 401)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "revokeSession",
summary = "Отозвать текущую сессию",
tags = { "Auth" },
responses = {
@ApiResponse(responseCode = "204", description = "Успех"),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.DELETE,
value = "/api/v1/auth/sessions/current",
produces = { "application/json" }
)
ResponseEntity<Void> revokeSession(
);
}
@@ -0,0 +1,27 @@
package ru.mtusi.messenger.controller;
import jakarta.servlet.http.HttpServletRequest;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.RestController;
import ru.mtusi.messenger.dto.SessionDTO;
import ru.mtusi.messenger.service.AuthService;
@RestController
@RequiredArgsConstructor
public class AuthController implements AuthApi {
private final AuthService authService;
@Override
public ResponseEntity<SessionDTO> createSession(HttpServletRequest request) {
return ResponseEntity.status(HttpStatus.CREATED).body(authService.login(request.getHeader(HttpHeaders.AUTHORIZATION), request.getContentLengthLong()));
}
@Override
public ResponseEntity<Void> revokeSession() {
authService.logout();
return ResponseEntity.noContent().build();
}
}
@@ -0,0 +1,36 @@
package ru.mtusi.messenger.controller;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.web.bind.annotation.RestController;
import ru.mtusi.messenger.dto.ChatDTO;
import ru.mtusi.messenger.dto.ChatPageDTO;
import ru.mtusi.messenger.dto.CreateChatDTO;
import ru.mtusi.messenger.security.SessionPrincipal;
import ru.mtusi.messenger.service.ChatService;
import java.util.UUID;
@RestController
@RequiredArgsConstructor
public class ChatController implements ChatsApi {
private final ChatService chatService;
@Override
public ResponseEntity<ChatDTO> createChat(CreateChatDTO createChatDTO, @AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.status(HttpStatus.CREATED)
.body(chatService.createChat(principal.userId(), createChatDTO));
}
@Override
public ResponseEntity<ChatDTO> getChat(UUID chatId , @AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.ok(chatService.getChatDTO(principal.userId(), chatId));
}
@Override
public ResponseEntity<ChatPageDTO> listChats(Integer limit, String cursor , @AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.ok(chatService.listChats(principal.userId(), limit, cursor));
}
}
@@ -0,0 +1,216 @@
/**
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech) (7.10.0).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package ru.mtusi.messenger.controller;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import ru.mtusi.messenger.dto.ChatDTO;
import ru.mtusi.messenger.dto.ChatPageDTO;
import ru.mtusi.messenger.dto.CreateChatDTO;
import ru.mtusi.messenger.dto.ErrorDTO;
import java.util.UUID;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import jakarta.annotation.Generated;
import ru.mtusi.messenger.security.SessionPrincipal;
@Generated(value = "org.openapitools.codegen.languages.SpringCodegen", comments = "Generator version: 7.10.0")
@Validated
@Tag(name = "Chats", description = "Управление чатами и доступ к чатам текущего пользователя.")
@RequestMapping("${openapi.mTUSIMessenger2.base-path:}")
public interface ChatsApi {
/**
* POST /api/v1/chats : Создать чат; вызывающий должен входить в member_ids
*
* @param createChatDTO (required)
* @return Успех (status code 201)
* or Неверный запрос (status code 400)
* or Нет действительной аутентификации (status code 401)
* or Объект отсутствует или недоступен (status code 404)
* or Конфликт (status code 409)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "createChat",
summary = "Создать чат; вызывающий должен входить в member_ids",
tags = { "Chats" },
responses = {
@ApiResponse(responseCode = "201", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ChatDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.POST,
value = "/api/v1/chats",
produces = { "application/json" },
consumes = { "application/json" }
)
ResponseEntity<ChatDTO> createChat(
@Parameter(name = "CreateChatDTO", description = "", required = true) @Valid @RequestBody CreateChatDTO createChatDTO, @AuthenticationPrincipal SessionPrincipal principal
);
/**
* GET /api/v1/chats/{chat_id} : Получить доступный чат
*
* @param chatId (required)
* @return Успех (status code 200)
* or Неверный запрос (status code 400)
* or Нет действительной аутентификации (status code 401)
* or Объект отсутствует или недоступен (status code 404)
* or Конфликт (status code 409)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "getChatDTO",
summary = "Получить доступный чат",
tags = { "Chats" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ChatDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/api/v1/chats/{chat_id}",
produces = { "application/json" }
)
ResponseEntity<ChatDTO> getChat(
@Parameter(name = "chat_id", description = "", required = true, in = ParameterIn.PATH) @PathVariable("chat_id") UUID chatId,
@AuthenticationPrincipal SessionPrincipal principal
);
/**
* GET /api/v1/chats : Чаты текущего пользователя
*
* @param limit (optional, default to 50)
* @param cursor (optional)
* @return Успех (status code 200)
* or Неверный запрос (status code 400)
* or Нет действительной аутентификации (status code 401)
* or Объект отсутствует или недоступен (status code 404)
* or Конфликт (status code 409)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "listChats",
summary = "Чаты текущего пользователя",
tags = { "Chats" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ChatPageDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/api/v1/chats",
produces = { "application/json" }
)
ResponseEntity<ChatPageDTO> listChats(
@Min(1) @Max(100) @Parameter(name = "limit", description = "", in = ParameterIn.QUERY) @Valid @RequestParam(value = "limit", required = false, defaultValue = "50") Integer limit,
@Size(min = 1) @Parameter(name = "cursor", description = "", in = ParameterIn.QUERY) @Valid @RequestParam(value = "cursor", required = false) String cursor,
@AuthenticationPrincipal SessionPrincipal principal
);
}
@@ -0,0 +1,89 @@
/**
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech) (7.10.0).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package ru.mtusi.messenger.controller;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import jakarta.annotation.Generated;
import ru.mtusi.messenger.dto.HealthDTO;
@Generated(value = "org.openapitools.codegen.languages.SpringCodegen", comments = "Generator version: 7.10.0")
@Validated
@Tag(name = "Health", description = "Проверки живости и готовности процесса. Публичные, без аутентификации.")
@RequestMapping("${openapi.mTUSIMessenger2.base-path:}")
public interface HealthApi {
/**
* GET /health/live : Процесс жив
*
* @return Успех (status code 200)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "liveness",
summary = "Процесс жив",
tags = { "Health" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = HealthDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
})
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/health/live",
produces = { "application/json" }
)
ResponseEntity<HealthDTO> liveness(
);
/**
* GET /health/ready : Готов принимать трафик
*
* @return Успех (status code 200)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "readiness",
summary = "Готов принимать трафик",
tags = { "Health" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = HealthDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = Error.class))
})
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/health/ready",
produces = { "application/json" }
)
ResponseEntity<HealthDTO> readiness(
);
}
@@ -0,0 +1,23 @@
package ru.mtusi.messenger.controller;
import lombok.RequiredArgsConstructor;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.RestController;
import ru.mtusi.messenger.dto.HealthDTO;
import ru.mtusi.messenger.service.HealthService;
@RestController
@RequiredArgsConstructor
public class HealthController implements HealthApi {
private final HealthService healthService;
@Override
public ResponseEntity<HealthDTO> liveness() {
return ResponseEntity.ok(healthService.liveness());
}
@Override
public ResponseEntity<HealthDTO> readiness() {
return ResponseEntity.ok(healthService.readiness());
}
}
@@ -0,0 +1,30 @@
package ru.mtusi.messenger.controller;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.web.bind.annotation.RestController;
import ru.mtusi.messenger.dto.CreateMessageDTO;
import ru.mtusi.messenger.dto.MessageDTO;
import ru.mtusi.messenger.dto.MessagePageDTO;
import ru.mtusi.messenger.security.SessionPrincipal;
import ru.mtusi.messenger.service.MessageService;
import java.util.UUID;
@RestController
@RequiredArgsConstructor
public class MessageController implements MessagesApi {
private final MessageService messageService;
@Override
public ResponseEntity<MessageDTO> createMessage(UUID chatId, String idempotencyKey, CreateMessageDTO createMessageDTO, @AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.status(HttpStatus.CREATED).body(messageService.createMessage(principal.userId(), chatId, createMessageDTO, idempotencyKey));
}
@Override
public ResponseEntity<MessagePageDTO> listMessages(UUID chatId, Integer limit, String cursor, @AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.ok(messageService.listMessages(principal.userId(), chatId, limit, cursor));
}
}
@@ -0,0 +1,138 @@
/**
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech) (7.10.0).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package ru.mtusi.messenger.controller;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import ru.mtusi.messenger.dto.CreateMessageDTO;
import ru.mtusi.messenger.dto.MessageDTO;
import ru.mtusi.messenger.dto.ErrorDTO;
import ru.mtusi.messenger.dto.MessagePageDTO;
import ru.mtusi.messenger.security.SessionPrincipal;
import java.util.UUID;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import jakarta.annotation.Generated;
@Generated(value = "org.openapitools.codegen.languages.SpringCodegen", comments = "Generator version: 7.10.0")
@Validated
@Tag(name = "Messages", description = "Отправка и чтение сообщений внутри доступного чата.")
@RequestMapping("${openapi.mTUSIMessenger2.base-path:}")
public interface MessagesApi {
@Operation(
operationId = "createMessage",
summary = "Отправить сообщение",
tags = { "Messages" },
responses = {
@ApiResponse(responseCode = "201", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = MessageDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.POST,
value = "/api/v1/chats/{chat_id}/messages",
produces = { "application/json" },
consumes = { "application/json" }
)
ResponseEntity<MessageDTO> createMessage(
@Parameter(name = "chat_id", description = "", required = true, in = ParameterIn.PATH)
@PathVariable("chat_id") UUID chatId,
@Parameter(name = "Idempotency-Key", required = true, in = ParameterIn.HEADER)
@RequestHeader(value = "Idempotency-Key", required = true) String idempotencyKey,
@Parameter(name = "CreateMessageDTO", description = "", required = true)
@Valid @RequestBody CreateMessageDTO createMessageDTO,
@AuthenticationPrincipal SessionPrincipal principal
);
@Operation(
operationId = "listMessages",
summary = "Сообщения по (created_at, id) по возрастанию",
tags = { "Messages" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = MessagePageDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/api/v1/chats/{chat_id}/messages",
produces = { "application/json" }
)
ResponseEntity<MessagePageDTO> listMessages(
@Parameter(name = "chat_id", description = "", required = true, in = ParameterIn.PATH)
@PathVariable("chat_id") UUID chatId,
@Min(1) @Max(100)
@Parameter(name = "limit", description = "", in = ParameterIn.QUERY)
@Valid @RequestParam(value = "limit", required = false, defaultValue = "50") Integer limit,
@Size(min = 1)
@Parameter(name = "cursor", description = "", in = ParameterIn.QUERY)
@Valid @RequestParam(value = "cursor", required = false) String cursor,
@AuthenticationPrincipal SessionPrincipal principal
);
}
@@ -0,0 +1,27 @@
package ru.mtusi.messenger.controller;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.web.bind.annotation.RestController;
import ru.mtusi.messenger.dto.CreateUserDTO;
import ru.mtusi.messenger.dto.UserDTO;
import ru.mtusi.messenger.security.SessionPrincipal;
import ru.mtusi.messenger.service.UserService;
@RestController
@RequiredArgsConstructor
public class UserController implements UsersApi {
private final UserService userService;
@Override
public ResponseEntity<UserDTO> currentUser(@AuthenticationPrincipal SessionPrincipal principal) {
return ResponseEntity.ok(userService.currentUser(principal.userId()));
}
@Override
public ResponseEntity<UserDTO> registerUser(CreateUserDTO createUserDTO) {
return ResponseEntity.status(HttpStatus.CREATED).body(userService.registerUser(createUserDTO));
}
}
@@ -0,0 +1,137 @@
/**
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech) (7.10.0).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package ru.mtusi.messenger.controller;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import ru.mtusi.messenger.dto.CreateUserDTO;
import ru.mtusi.messenger.dto.ErrorDTO;
import ru.mtusi.messenger.dto.UserDTO;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.security.SecurityRequirement;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import jakarta.validation.Valid;
import jakarta.annotation.Generated;
import ru.mtusi.messenger.security.SessionPrincipal;
@Generated(value = "org.openapitools.codegen.languages.SpringCodegen", comments = "Generator version: 7.10.0")
@Validated
@Tag(name = "Users", description = "Регистрация пользователей и доступ к профилю текущего пользователя.")
@RequestMapping("${openapi.mTUSIMessenger2.base-path:}")
public interface UsersApi {
/**
* GET /api/v1/users/me : Текущий пользователь
*
* @return Успех (status code 200)
* or Неверный запрос (status code 400)
* or Нет действительной аутентификации (status code 401)
* or Объект отсутствует или недоступен (status code 404)
* or Конфликт (status code 409)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "currentUser",
summary = "Текущий пользователь",
tags = { "Users" },
responses = {
@ApiResponse(responseCode = "200", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = UserDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "401", description = "Нет действительной аутентификации", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "404", description = "Объект отсутствует или недоступен", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
},
security = {
@SecurityRequirement(name = "bearerAuth")
}
)
@RequestMapping(
method = RequestMethod.GET,
value = "/api/v1/users/me",
produces = { "application/json" }
)
ResponseEntity<UserDTO> currentUser(
@AuthenticationPrincipal SessionPrincipal principal
);
/**
* POST /api/v1/users : Создать пользователя
*
* @param createUserDTO (required)
* @return Успех (status code 201)
* or Неверный запрос (status code 400)
* or Конфликт (status code 409)
* or Ограничение частоты запросов (status code 429)
* or Зависимость недоступна (status code 503)
* or Неожиданная ошибка без внутренних деталей (status code 500)
*/
@Operation(
operationId = "registerUser",
summary = "Создать пользователя",
tags = { "Users" },
responses = {
@ApiResponse(responseCode = "201", description = "Успех", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = UserDTO.class))
}),
@ApiResponse(responseCode = "400", description = "Неверный запрос", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "409", description = "Конфликт", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "429", description = "Ограничение частоты запросов", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "503", description = "Зависимость недоступна", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
}),
@ApiResponse(responseCode = "500", description = "Неожиданная ошибка без внутренних деталей", content = {
@Content(mediaType = "application/json", schema = @Schema(implementation = ErrorDTO.class))
})
}
)
@RequestMapping(
method = RequestMethod.POST,
value = "/api/v1/users",
produces = { "application/json" },
consumes = { "application/json" }
)
ResponseEntity<UserDTO> registerUser(
@Parameter(name = "CreateUserDTO", description = "", required = true) @Valid @RequestBody CreateUserDTO createUserDTO
);
}
@@ -0,0 +1,156 @@
package ru.mtusi.messenger.controller.controllerAdvice;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.validation.ConstraintViolationException;
import lombok.RequiredArgsConstructor;
import org.springframework.dao.DataAccessException;
import org.springframework.dao.DataAccessResourceFailureException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.transaction.CannotCreateTransactionException;
import org.springframework.web.HttpMediaTypeNotSupportedException;
import org.springframework.web.HttpRequestMethodNotSupportedException;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.MissingRequestHeaderException;
import org.springframework.web.bind.MissingServletRequestParameterException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.method.annotation.HandlerMethodValidationException;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import ru.mtusi.messenger.config.properties.RateLimitProperties;
import ru.mtusi.messenger.dto.ErrorDTO;
import ru.mtusi.messenger.dto.ErrorErrorDTO;
import ru.mtusi.messenger.exception.*;
@RestControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {
private final RateLimitProperties limitProperties;
private final ApiErrorFactory errors;
@ExceptionHandler(InvalidRequestException.class)
public ResponseEntity<ErrorDTO> invalidRequest(InvalidRequestException e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST, e.getMessage(), req);
}
@ExceptionHandler(UnauthorizedException.class)
public ResponseEntity<ErrorDTO> unauthorized(UnauthorizedException e, HttpServletRequest req) {
boolean isLogin = "/api/v1/auth/sessions".equals(req.getRequestURI());
String challenge = isLogin
? "Basic realm=\"messenger\", charset=\"UTF-8\""
: "Bearer realm=\"messenger\"";
return ResponseEntity.status(HttpStatus.UNAUTHORIZED)
.header("WWW-Authenticate", challenge)
.body(errors.error(ErrorErrorDTO.CodeEnum.UNAUTHORIZED, e.getMessage(), req));
}
@ExceptionHandler(NotFoundException.class)
public ResponseEntity<ErrorDTO> notFound(NotFoundException e, HttpServletRequest req) {
return respond(HttpStatus.NOT_FOUND, ErrorErrorDTO.CodeEnum.NOT_FOUND, e.getMessage(), req);
}
@ExceptionHandler(ConflictException.class)
public ResponseEntity<ErrorDTO> conflict(ConflictException e, HttpServletRequest req) {
return respond(HttpStatus.CONFLICT, ErrorErrorDTO.CodeEnum.CONFLICT, e.getMessage(), req);
}
@ExceptionHandler(PayloadTooLargeException.class)
public ResponseEntity<ErrorDTO> payloadTooLarge(PayloadTooLargeException e, HttpServletRequest req) {
return respond(HttpStatus.PAYLOAD_TOO_LARGE, ErrorErrorDTO.CodeEnum.PAYLOAD_TOO_LARGE, e.getMessage(), req);
}
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<ErrorDTO> validation(MethodArgumentNotValidException e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST, "Validation failed", req);
}
@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity<ErrorDTO> unreadable(Exception e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST, "Malformed request body", req);
}
@ExceptionHandler(MissingServletRequestParameterException.class)
public ResponseEntity<ErrorDTO> missingParam(Exception e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST, "Missing parameter", req);
}
@ExceptionHandler(MethodArgumentTypeMismatchException.class)
public ResponseEntity<ErrorDTO> typeMismatch(Exception e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST, "Invalid parameter type", req);
}
@ExceptionHandler(HttpMediaTypeNotSupportedException.class)
public ResponseEntity<ErrorDTO> mediaType(Exception e, HttpServletRequest req) {
return respond(HttpStatus.UNSUPPORTED_MEDIA_TYPE, ErrorErrorDTO.CodeEnum.UNSUPPORTED_MEDIA_TYPE,
"Unsupported media type", req);
}
@ExceptionHandler(HandlerMethodValidationException.class)
public ResponseEntity<ErrorDTO> methodValidation(Exception e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST,
"Validation failed", req);
}
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
public ResponseEntity<ErrorDTO> methodNotAllowed(Exception e, HttpServletRequest req) {
return respond(HttpStatus.METHOD_NOT_ALLOWED, ErrorErrorDTO.CodeEnum.INVALID_REQUEST,
"Method not allowed", req);
}
@ExceptionHandler(RateLimitedException.class)
public ResponseEntity<ErrorDTO> rateLimited(RateLimitedException e, HttpServletRequest req) {
return ResponseEntity.status(HttpStatus.TOO_MANY_REQUESTS)
.header("Retry-After", String.valueOf(limitProperties.retryAfterSeconds()))
.body(errors.error(ErrorErrorDTO.CodeEnum.RATE_LIMITED, e.getMessage(), req));
}
@ExceptionHandler(ConstraintViolationException.class)
public ResponseEntity<ErrorDTO> constraint(ConstraintViolationException e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST,
"Validation failed", req);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<ErrorDTO> fallback(Exception e, HttpServletRequest req) {
return respond(HttpStatus.INTERNAL_SERVER_ERROR, ErrorErrorDTO.CodeEnum.INTERNAL_ERROR,
"Internal error", req);
}
@ExceptionHandler(ServiceUnavailableException.class)
public ResponseEntity<ErrorDTO> serviceUnavailable(ServiceUnavailableException e, HttpServletRequest req) {
return respond(HttpStatus.SERVICE_UNAVAILABLE,
ErrorErrorDTO.CodeEnum.UNAVAILABLE,
e.getMessage(), req);
}
@ExceptionHandler({
CannotCreateTransactionException.class,
DataAccessResourceFailureException.class
})
public ResponseEntity<ErrorDTO> dependencyUnavailable(Exception e, HttpServletRequest req) {
return respond(HttpStatus.SERVICE_UNAVAILABLE,
ErrorErrorDTO.CodeEnum.UNAVAILABLE,
"Dependency unavailable", req);
}
@ExceptionHandler(DataAccessException.class)
public ResponseEntity<ErrorDTO> dataAccess(DataAccessException e, HttpServletRequest req) {
return respond(HttpStatus.INTERNAL_SERVER_ERROR,
ErrorErrorDTO.CodeEnum.INTERNAL_ERROR,
"Database error", req);
}
@ExceptionHandler(MissingRequestHeaderException.class)
public ResponseEntity<ErrorDTO> missingHeader(MissingRequestHeaderException e, HttpServletRequest req) {
return respond(HttpStatus.BAD_REQUEST, ErrorErrorDTO.CodeEnum.INVALID_REQUEST,
"Missing header: " + e.getHeaderName(), req);
}
private ResponseEntity<ErrorDTO> respond(HttpStatus status,
ErrorErrorDTO.CodeEnum code,
String message,
HttpServletRequest req) {
return ResponseEntity.status(status).body(errors.error(code, message, req));
}
}