Skip to content

Latest commit

 

History

History
263 lines (206 loc) · 19.6 KB

README.md

File metadata and controls

263 lines (206 loc) · 19.6 KB
Raw

Delivery

Интеграция Яндекс карт

Интегрированная Яндекс-карта позволяет:

Добавление офиса

Для добавления нового офиса на карту, необходимо щелкнуть по карте в месте расположения офиса. Офис будет добавлен. После добавления офиса его можно сохранить в базу данных, однако рекомендуется добавить описание офиса.

Добавление офиса

Добавление описания офиса

После добавления офиса на карту, можно добавить описание данному офису. Для этого в форме, расположенной ниже карты в строке "Описание офиса" задать необходимо описание офиса. Добавив описание офиса, необходимо нажать но кнопку Сохранить, при этом метка на карте изменит свою подпись с адреса офиса на его описание. Адрес офиса будет доступен по щелчку по метке.

Добавление офиса

Удаление офиса

Для удаления офиса с карты необходимо кликнуть по удаляемому офису и во всплывающей подсказке нажать кнопку Удалить. Офис будет удален с карты, а также с базы данных.

Добавление офиса

Customer feature

Данный функционал призван обеспечить управление (создание, получение, изменение, удаление) сущностью заказчика в базе данных.

Реализован на уровнях:

Entity

Реализацией Entity является Customer.java. Данный класс описывает сущность заказчика, помечен аннотацией @Entity, имеет приватные поля, являющиеся колонками таблицы customers, доступ к которым организован с помощью гетторв и сеттеров.

Класс Customer.java содержит следующие поля:
  1. id - (доступ private, тип long) характеризует уникальный идентификационный номер заказчика. Является первичным ключом таблицы customers. Не может иметь нулевого значения. Автоинкрементируемо на стороне хибернейта. Имеет кастомизированное имя колонки "customer_id" в таблице customers.
  2. name - (доступ private, тип String) содержит наименование заказчика.
  3. address - (доступ private, тип String) содержит адрес заказчика. Не может иметь нулевого значения.
  4. phoneNumber - (доступ private, тип String) содержит номер телефона заказчика. Не может иметь нулевого значения. Имеет кастомизированное имя колонки "phone_number" в таблице customers. Содержит только уникальные данные.
  5. eMail - (доступ private, тип String) содержит адрес электронной почты заказчика. Не может иметь нулевого значения. Имеет кастомизированное имя колонки "e_mail" в таблице customers. Содержит только уникальные данные.
Класс Customer.java имеет методы:
Сеттеры:
  • public void setId(Long id) - сеттер для поля id.
  • public void setName(String name) - сеттер для поля name.
  • public void setAddress(String address) - сеттер для поля address.
  • public void setPhoneNumber(String phoneNumber) - сеттер для поля phoneNumber.
  • public void seteMail(String eMail) - сеттер для поля eMail.

Сеттеры задают значение соответствующего поля класса равным переданному в них значению аргумента.

Геттеры:
  • public long getId() - геттер для поля id.
  • public String getName() - геттер для поля Name.
  • public String getAddress() - геттер для поля Address.
  • public String getPhoneNumber() - геттер для поля PhoneNumber.
  • public String geteMail() - геттер для поля eMail.

Геттеры возвращают значение соответствующего поля класса.

DAO

DAO слой создан для непосредственного взаимодействует с базой данных.

Включает в себя интерфейсы:
И реализующий их класс CustomerDaoImpl.java
BasicDao interface

Является дженерик интерфейсом, описывающим базовые CRUD-операции.
Реализацией интерфейса является CustomerDaoImpl.java

Интерфейс BasicDao содержит методы:
  • Session getCurrentSession() - возвращает текущую сессию Хибернейта.
  • List getList() - возвращает список сущностей из базы данных.
  • T create(T entity) - создает сущность в базе данных, переданную в метод в качестве параметра.
  • T update(T entity) - изменяет сущность в базе данных, переданную в метод в качестве параметра.
  • T findById(long id) - возвращает сущность из базы данных по параметру id.
  • T delete(T entity) - удаляет сущность в базе данных, переданную в метод в качестве параметра.*
CustomerDao interface

Является интерфейсом, унаследованным от BasicDao и расширяющим его функционал дополнительными методами взаимодействия сущности заказчика с базой данных.
Реализацией интерфейса является CustomerDaoImpl.java

Интерфейс CustomerDao содержит методы:
  • List<Customer> findCustomerByName(String name) - возвращает список заказчиков, имя которых соответстует переданному в метод параметру.
  • List<Customer> findCustomerByAddress(String address) - возвращает список заказчиков, адрес которых соответстует переданному в метод параметру.
  • Customer findCustomerByPhoneNumber(String phoneNumber) - возвращает уникального заказчика, номер телефона которого соответстует переданному в метод параметру.
  • Customer findCustomerByEmail(String eMail) - возвращает уникального заказчика, адрес электронной почты которого соответстует переданному в метод параметру.
CusomerDaoImpl.java

Класс, реализующий интерфейсы BasicDao и CustomerDao. Работает с Entity Customer.java.

Service

Service слой обеспечивает взаимосвязь между controller и dao слоем.

Включает в себя интерфейсы:
Включает в себя классы:
  • CustomerServiceImpl который имплементирует интерфейс CustomerService
CustomerService interface

Является дженерик интерфейсом, описывающим основные операции по получении имени, адреса, почты, телефона заказчика а также id заказчика, получение списка всех заказчиков, создание, обновление и удаление заказчика.
Реализацией интерфейса является CustomerServiceImpl.java

Интерфейс CustomerService содержит методы:
  • List<Customer> getCustomerByName() - получение списка по имени заказчика
  • List<Customer> getCustomerByAddress - получение списка по адресу заказчика
  • getCustomerByPhoneNumber() - получение номера телефона заказчика
  • getCustomerByEmail() - получение почты заказчика
  • getCustomerById() - получение заказчика по id
  • List<Customer> getAllCustomers() - получение списка всех заказчиков
  • Customer createCustomer() - создание заказчика
  • Customer updateCustomer() - изменение заказчика
  • Customer deleteCustomer() - удаление заказчика по его id
CustomerServiceImpl.java

Класс описывает методы заказчика, такие как: поиск заказчика по имени, телефону, почте, адресу, по id, выводит список всех заказчиков, а также создание, обновление и удаление заказчика по его id. Класс помечен аннотацией @Service, имеет автосвязку с интерфейсом CustomerDao и работает через него.

Класс CustomerServiceImpl содержит методы:
  • List<Customer> findCustomerByName(String name) - возвращает список заказчиков, имя которых соответстует переданному в метод параметру.
  • List<Customer> findCustomerByAddress(String address) - возвращает список заказчиков, адрес которых соответстует переданному в метод параметру.
  • Customer findCustomerByPhoneNumber(String phoneNumber) - возвращает уникального заказчика, номер телефона которого соответстует переданному в метод параметру.
  • Customer findCustomerByEmail(String eMail) - возвращает уникального заказчика, адрес электронной почты которого соответстует переданному в метод параметру.
  • getCustomerById() - получение заказчика по id
  • getAllCustomers() - получение списка всех заказчиков
  • Customer createCustomer() - создание заказчика
  • Customer updateCustomer() - изменение заказчика
  • Customer deleteCustomer() - удаление заказчика по его id

To be continued...

Order feature

Заказ

Реализованы сущности Заказ и связанная с ним сущность Элемент корзины

Заказ реализован классом Order.java и таблицей orders в базе

Структура полей класса Order:

Назначение Тип Имя в классе Имя в таблице
Ид заказа Long id id
Дата доставки Date deliveryDate delivery_date
Время доставки Time deliveryTime delivery_time
Ид клиента Long userId user_id
Адрес доставки String deliveryAddress delivery_address
Ид исполнителя Long executorId executor_id
Комментарий String comment comment
Корзина List basketUnitList
Доступные публичные методы класса Order:
Сеттеры:
  • void setDeliveryDate(Date deliveryDate) - установить дату доставки
  • void setDeliveryTime(Time deliveryTime) - установить время доставки
  • void setUserId(Long userId) - уставновить ID пользователя
  • void setDeliveryAddress(String deliveryAdress) - установить адрес доставки
  • void setExecutorId(Long executorId) - установить ID исполнителя доставки
  • void setComment(String comment) - установить комментарий
  • void setBasketUnitList(List basketUnitList) - задать список юнитов/элементов*
Геттеры:
  • Long getId() - получить ID заказа
  • Date getDeliveryDate() - получить дату доставки
  • Time getDeliveryTime() - получить время доставки
  • Long getUserId() - получить ID пользователя
  • String getDeliveryAddress() - получить адрес доставки
  • Long getExecutorId() - получить ID исполнителя
  • String getComment() - получить комментарий к заказу
  • List getBasketUnitList() - получить список юнитов/элементов* в заказе
Другие:
  • void addBasketUnit(BasketUnit basketUnit) - добавить юнит/элемент* в корзину заказа
  • void removeBasketUnit(BasketUnit basketUnit) - удалить юнит/элемент* из корзины заказа

Элемент корзины реализован классом BasketUnit.java, хранение элементов заказа в таблице basket в базе *Юнит - элемент корзины, содержащий в себе ID товара, его количество и ID заказа

Структура полей класса BasketUnit:

Назначение Тип Имя в классе Имя в таблице
Ид заказа Long Order order_id
Ид единицы корзины Long id id
Ид товара Long itemId item_id
Количество quantity quantity

Таблицы связаны двусторонней связью ОдинКоМногим по ключу order_id

Доступные публичные методы класса BasketUnit:
Конструкторы:
  • BasketUnit() - создать юнит
  • BasketUnit(Long itemId) - создать юнит с ID товара
Сеттеры:
  • void setQuantity(int quantity) - указать количество единиц товара
  • void setOrder(Order order) - указать заказ
Геттеры:
  • Long getId() - получить ID юнита
  • Order getOrder() - получить заказ
  • Long getItemId() - получить ID товара
  • int getQuantity() - получить количество единиц товара

Доступные публичные методы интерфейса сервиса OrderService:

  • Order create(Order order) - создать заказ
  • Order findById(long id) - получить заказ по ID
  • Order deleteOrder(long id) - удалить заказ по ID
  • Order updateOrder(Order order) - обновить заказ
  • List getOrderList() - получить список заказов
  • List findByUserId(long uid) - получить список заказов по ID пользователя
  • BasketUnit findBasketUnitById(long id) - получить юнит из корзины по ID
  • BasketUnit deleteBasketUnitById(long id) - удалить юнит из корзины по ID

REST запросы

  • /order/add - добавить заказ http://localhost.com/order/add

  • /order/get/id/ - получить заказ по ID http://localhost.com/order/get/id/35

  • /order/get/uid/ - получить заказ по ID пользователя http://localhost.com/order/order/get/uid/100

  • /order/update - обновить заказ http://localhost.com/order/update

  • /order/delete/ - удалить заказ по ID http://localhost.com/order/delete/35

  • /order/basket/delete/id/ - удалить единицу корзины по ID http://localhost.com/order/basket/delete/id/35

  • /order/basket/get/id/ - получить единицу корзины по ID http://localhost.com/order/basket/get/id/72