Представьте, что на воскресной ярмарке вы купили несколько картин и хотите повесить их дома. Но вот незадача — для этого нужна дрель, а её у вас нет. Можно, конечно, пойти в магазин и купить, но в такой покупке мало смысла — после того, как вы повесите картины, дрель будет просто пылиться в шкафу. Можно пригласить мастера — но за его услуги тоже нужно заплатить. И тут вы вспоминаете, что видели дрель у друга. Сама собой напрашивается идея — одолжить её.
Большая удача, что у вас оказался друг с дрелью и вы сразу вспомнили про него! Иначе в поисках инструмента пришлось бы писать всем друзьям и знакомым. Или вернуться к первым двум вариантам — покупке дрели или найму мастера.
Насколько было бы удобнее, если бы под рукой был сервис, с помощью которого пользователи делятся вещами!
- вещи (предметы):
- модель данных: название, описание, возможность аренды, владелец, запрос на аренду;
- валидация данных: название, описание, владелец не могут быть пустыми;
- действия: добавление, редактирование, получение информации (название, описание, владелец вещи);
- функционал: просмотр информации о вещи (название, описание, отзывы пользователей, доступность к аренде), поиск вещи по названию или описанию.
- пользователи:
- модель данных: имя, логин, email;
- валидация данных: email не может быть пустым и должна быть уникальным, логин не может быть пустым и содержать пробелы;
- действия: добавление, обновление, хранение, получение и удаление;
- функционал: добавление вещи (владелец), добавление отзыва (комментария) к вещи (арендатор).
- запросы на бронирование вещей:
- модель данных: описание, инициатор запроса на бронирование, дата и время создания запроса на бронирование;
- валидация данных: запрос не может быть создан без информации об инициаторе, дата и время создания запроса не могут быть пустыми;
- функционал: создание запроса на бронирование вещи и получение информации о запросах на бронирования вещи арендатором или владельцем вещи, создание ответа на запрос (описание и дата создания запроса; информация о пользователе, создавшем запрос на аренду).
- бронирования:
- модель данных: дата и время начала и завершения бронирования, информация о вещи и об арендаторе, статус бронирования;
- валидация данных: дата и время начала и завершения бронирования, статус бронирования не могут быть пустыми;
- действия: создание бронирования, подтверждение бронирования владельцем вещи, получение информации о бронировании по id и пользователю, получение арендатором или владельцем вещи информации о бронированиях вещи с сортировкой по дате от более новых к более старым, в том числе с возможностью просмотра владельцем вещи дат последнего и ближайшего следующего бронирования вещи.
- функционал: хранение статус состояния бронирования.
- отзывы (комментарии) пользователей:
- модель данных: содержание, идентификаторы пользователя и вещи, дата и время создания отзыва;
- валидация данных: содержание не может быть пустым;
- действия: создание отзыва (комментария) к вещи после бронирования.
- статусы состояния бронирований:
WAITING- ожидание;APPROVED- подтвержденное бронирование;REJECTED- отклоненное бронирование;CANCELLED- закрытое бронирование.
- ошибки валидации данных - код ответа
400 Bad Request; - ошибки валидации аргументов метода - код ответа
400 Bad Request; - ошибки поиска объекта - код ответа
404 Not Found; - ошибка поиска владельца вещи - код ответа
403 Forbidden; - ошибка сохранения новых данных - код ответа
409 Conflict - внутренние ошибки сервера - код ответа
500 Internal Server Error.
Приложение состоит из двух взаимосвязанных модулей, которые взаимодействуют друг с другом через сетевой порт 9090:
- shareIt-server - содержит основную логику приложения;
- shareIt-gateway - содержит контроллеры, с которыми непосредственно работают пользователи, и всю валидацию входных данных — кроме той, которая требует работы с базой данных.
- Java 21
- фреймворк: Spring Boot
- аннотирование классов приложения: Lombok
- хранение данных (рабочий режим): Postgre SQL
- хранение данных (режим тестирования): H2 Database
- сборка и управление зависимостями: Apache Maven 3.9.9
- Java Development Kit (JDK) - версия 21 или более поздняя;
- Apache Maven - версия 3.9.9 или более поздняя.
Ниже приведены инструкции по установке JDK 21 на различных операционных системах.
Установка на macOS
Установите Homebrew запуском следующей команды в терминале (командной строке) операционной системы:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Установите JDK 21 с помощью Homebrew:
brew install openjdk@21Создайте символическую ссылку, чтобы система могла найти JDK:
sudo ln -sfn /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-21.jdkДобавьте JDK 21 в PATH. Откройте файл .zshrc (или .bash_profile, в зависимости от используемой оболочки) и добавьте следующую строку:
echo 'export PATH="/opt/homebrew/opt/openjdk@21/bin:$PATH"' >> ~/.zshrc
Перезагрузите терминал или примените изменения с помощью команды:
source ~/.zshrcПроверьте установленную версию Java:
java -versionУстановка на Linux
Откройте терминал и выполните команду для обновления списка пакетов:
sudo apt updateУстановите JDK 21:
sudo apt install openjdk-21-jdkУбедитесь, что JDK установлен и настроен корректно:
java -versionУстановка на Windows
-
Скачайте установочный файл JDK 21 с официального сайта Oracle или OpenJDK.
-
Запустите установочный файл и следуйте инструкциям установщика.
-
После установки настройте переменную среды JAVA_HOME:
- откройте
Системные настройки>Переменные среды; - в разделе
Системные переменныенажмитеСоздатьи введите:- имя переменной:
JAVA_HOME - значение переменной: путь к установленной JDK (например,
C:\Program Files\Java\jdk-21).
- имя переменной:
- добавьте
JAVA_HOME\binв переменную Path.
- Проверьте версию Java в командной строке:
java -versionНиже приведены инструкции по установке Maven на различных операционных системах.
Установка на macOS
Установите Homebrew, если он еще не установлен:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Установите Maven с помощью Homebrew:
brew install mavenПроверьте версию Maven, чтобы убедиться в правильной установке:
mvn -versionУстановка на Linux
Откройте терминал и загрузите Apache Maven 3.9.9:
wget https://downloads.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gzРаспакуйте архив:
tar xzvf apache-maven-3.9.9-bin.tar.gzПереместите распакованную папку в директорию /opt/:
sudo mv apache-maven-3.9.9 /opt/mavenДобавьте Maven в PATH. Откройте файл .bashrc или .zshrc и добавьте следующую строку:
export PATH=/opt/maven/bin:$PATH
Примените изменения:
source ~/.bashrcПроверьте версию Maven:
mvn -versionУстановка на Windows
-
Скачайте установочный архив Maven 3.9.9 с официального сайта.
-
Распакуйте архив в удобное место, например
C:\Program Files\Maven. -
Настройте переменные среды:
- откройте
Системные настройки>Переменные среды. - в разделе
Системные переменныенажмитеСоздатьи добавьте:- имя переменной:
MAVEN_HOME - значение переменной: путь к папке Maven, например
C:\Program Files\Maven.
- имя переменной:
- найдите переменную Path, выберите ее и нажмите
Изменить. Добавьте новый путь:%MAVEN_HOME%\bin.
- Перезапустите командную строку и проверьте версию Maven:
mvn -versionВАЖНО! Запуск приложения осуществляется через системный порт 8080. Перед запуском убедитесь, что порт 8080 свободен!
Ниже приведены инструкции по проверке порта на различных операционных системах.
Проверка порта на macOS
Откройте терминал.
Выполните следующую команду, заменив PORT на номер порта, который нужно проверить:
lsof -i :PORT
Если порт занят, команда выведет список процессов, использующих порт. Для завершения процесса используйте команду:
kill -9 PID
где PID — идентификатор процесса из вывода предыдущей команды.
Если порт свободен, команда не вернет никаких данных.
Проверка порта на Linux
Откройте терминал.
Выполните следующую команду, заменив PORT на номер порта:
sudo lsof -i :PORT
Если порт занят, команда выведет список процессов, использующих порт. Для завершения процесса используйте команду:
sudo kill -9 PID
где PID — идентификатор процесса из вывода предыдущей команды.
Если порт свободен, команда не вернет никаких данных.
Проверка порта на Windows
Откройте командную строку (cmd) или PowerShell с правами администратора.
Выполните следующую команду, заменив PORT на номер порта:
netstat -aon | findstr :PORT
Если порт занят, команда выведет информацию о процессе, использующем порт. Обратите внимание на PID (идентификатор процесса).
Чтобы завершить процесс, откройте Диспетчер задач, перейдите на вкладку Подробности, найдите процесс с соответствующим PID и завершите его.
Если порт свободен, команда не вернет никаких данных.
- в терминале (командной строке) операционной системы;
- в программной среде разработки IntelliJ IDEA непосредственно в данном файле нажатием на символ тройной стрелки
>>>, расположенной слева от строки описания соответствующей команды.
- Склонируйте репозиторий с использованием следующей команды:
git clone https://github.com/kirshumir01/java-shareit.git- Перейдите в корневую директорию склонированного проекта и выполните последовательно команды:
cd java-shareit- Запустите приложение, выполнив последовательно следующие команды в двух отдельных окнах терминала:
mvn -pl :shareit-server spring-boot:runmvn -pl :shareit-gateway spring-boot:runДоступ к публичному API будет открыт по ссылке через адресную строку интернет-браузера: http://localhost:8080.