Документируем API как профессионалы OpenAPI и Spring в действии (Habr)

Прагматичный OpenClaw: реальная польза без хайпа

https://opencode.ai
Документация

Сам инструмент OpenCode — бесплатный, с открытым исходным кодом. Его можно установить и начать использовать без каких-либо платежей. Плата возникает не за сам агент, а за доступ к языковым моделям (провайдерам), которые OpenCode использует для работы.

Установка

curl -fsSL https://opencode.ai/install | bash

https://github.com/cherepakhin/registration-login-springboot-security-thymeleaf

Разработчик - Yandex

Сайт https://sourcecraft.dev

Цены https://sourcecraft.dev/portal/docs/ru/sourcecraft/pricing

(тарифный план SourceCraft Free бесплатен при 1 000 минут (16ч.) в месяц)

Попробовал в Visual Studio Code на проекте hr_admin.

SpringBoot + Camel REST API

Репозиторий на GitHub: https://github.com/cherepakhin/simple_boot_camel

echo $JAVA_HOME
/usr/lib/jvm/java-1.8.0-openjdk-amd64

Запуск:

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-amd64
./mvnw spring-boot:run

Spring Boot, H2, JSP

Проект из https://github.com/mmafrar/spring-mvc-crud-example.git

ЭТО JSP!!!

Java 21

export JAVA_HOME=/usr/lib/jvm/java-1.21.0-openjdk-amd64

Тестов нет.

GitHub проекта: https://github.com/cherepakhin/springboot-thymeleaf-security-demo
Демонстрация SpringBoot WEB приложения с авторизацией Spring Security.
Использованы следующие технологии:

• Spring Boot
• Spring MVC
• Thymeleaf
• Spring Security
• Spring Data JPA
• MySQL

hr-admin

https://github.com/cherepakhin/hr_admin

Заготовка для UI проектов со Spring Boot Web
Java 17
Основная цель ТОЛЬКО FRONTEND.

• В качестве template использован Freemarker с помощью библиотеки spring-boot-starter-freemarker
• Простой CRUD. База данных H2.
• Использован Tailwind CSS Framework(TailwindCSS) - CSS-фреймворк для оформления интерфейсов.
• При тестировании использован AssertJ
• Тесты в BDD стиле с Mockito (смотри файл EmployeeControllerTest.java)
• DataJpaTest в (смотри файл EmployeeRepositoryDataJpaTest.java)
• Использован GigaChat

Развернуто тут: https://v.perm.ru/hr_admin/ (запустить ~/temp/hr_admin.sh)

spring-boot-mdl

• Spring Boot, MVC, Security, Thymeleaf, H2, JSP
• springboot-thymeleaf-security-demo

Скрытие элементов в мобильной версии

Класс md:hidden (md от middle device (?) ) используется в Tailwind CSS для скрытия элемента на экранах среднего размера (и шире — на больших экранах). Пример:

<div class="md:hidden ">
    <!-- остальной html content -->

• CSS (Tailwind)
• Spring Mobile
• Spring Device
• Сторонние библиотеки

Оглавление:

• Spring Boot MVC
• Spring Boot Admin
• GWT
• Wicket
• KWeb (Kotlin!)
• Vaadin
• Eclipse projects
• ControlsFX (Java FX)

Tutorial "Components and Layouts": https://vaadin.com/docs/v14/flow/tutorial/components-and-layouts
Для разработки Vaadin приложений, кроме java, нужен настроенный node:

$ node -v
v20.0.0

Описание Vaadin 8 https://vaadin.com/framework
Генерация Spring Boot в Spring Initializr https://start.spring.io/

Vacancy Backend RestAssured

https://github.com/cherepakhin/vacancy_backend_restassured

Rest тесты для проекта vacancy_backend

• vacancy_backend

"Wicket относится к категории программных каркасов (application framework). Являясь надстройкой над Servlet API, Wicket предоставляет всю необходимую инфраструктуру для функционирования приложений, включая средства для управления жизненным циклом объектов, разграничения прав доступа, локализации, обработки исключительных ситуаций, поддержки сессий пользователей и т.п." ( Разработка Web-приложений с использованием Wicket)

(что-то типа React? Vue? Очень примитивно работа React выглядит так. Есть View, Action, State. View вызывает Acton, который меняет State, а View отслеживает изменения в State. В Wicket примерно также: View отслеживает изменения в Model).
Template Engines for Spring
Примеры из книги "Wicket in action": Wicket test examples на моем github. Не все примеры, только несколько, для того, чтобы понять работу Wicket. Все примеры в https://github.com/perty/wicket-test-examples

Склонировал https://github.com/wildfly/wildfly JAVA 17

Оглавление:

• Clone
• Установка
• Документация
• Добавляем администратора Wildfly
• Запуск сервера с доступом из сети
• Консоль управления
• Проверка
• Hello world
• База данных как ресурс
• Apache CXF
• Генерация клиентских классов по WSDL

Давно прочитал в журнале Компьютерра статью "Автоматизация хаоса". 1999 год!!! В google полно документов на эту тему. Пару слов хочется черкнуть от себя. В большинстве проектов, на которых приходилось работать, так или иначе возникает эта тема.
Хотя и не очень явно.

Попытка как то структурировать тесты.
Виды тестирования:
1. Unit tests

• Unit тестирование
• SpringBootTest + MockMVC для контроллеров (REST и WEB)
• MockMVC test (пример)

Здесь же может использоваться полезный инструмент как "Покрытие тестами":

• Статья "Покрытие тестами 100%"
• Пример использования на Kotlin

2. Интеграционное

• REST
  • behave-restfull - интересный способ описания тестов с помощью специального языка Gerkin (Behave тестирование с помощью RestAssured проекта shop_kotlin)
  • REST tests (RestAssured)
• База данных (DataJpaTest)
• Given-When-Then tests
• Эффективный подход к тестированию WEB-КОНТРОЛЛЕРОВ в Spring Boot приложениях(habr)

3. Нагрузочное
Yandex tank test

Еще тесты:
Интеграционное тестирование на Kotlin проекта ktor_shop (https://ktor.io)

Ссылки

• Раздел "Тестирование" на этом сайте

По мотивам статьи Изучаем ResponseEntity<?> и избавляемся от него в контроллерах Spring Boot
В заметке рассмотрено 2 способа:

1. Способ с возвратом ResponseEntity<?>
2. Способ с возвратом объекта