62 lines
6.2 KiB
Markdown
62 lines
6.2 KiB
Markdown
# Linkchecker
|
||
|
||
## Оригинальный текст задания
|
||
|
||
Разработать REST-сервис, проверяющий работоспособность любой последовательности узлов.
|
||
Каждый узел имеет уникальное имя, вероятность, с которой откажет при обращении к нему, и счетчик успешно выполненных запросов.
|
||
|
||
Сервис должен реализовывать два POST-метода:
|
||
|
||
1. setNodes устанавливает граф из узлов, описанных выше. Формат входных данных - JSON.
|
||
Программа должна исключать циклические связи узлов.
|
||
2. checkRoute принимает набор вершин (или их идентификаторов) в формате JSON
|
||
и проходит по этим вершинам, проверяя на каждом пройденном узле, не отказал ли он.
|
||
Если путь существует в графе и ни один из узлов пути не отказал, следует увеличить счетчик
|
||
в каждом из узлов пути. В противном случае отображать ошибку в ответе POST-метода (произвольный формат).
|
||
3. Узлы и связи должны храниться в базе данных.
|
||
|
||
## Изменённый вариант задания
|
||
|
||
После введённых корректировок, итоговый вид тестового задания выглядит следующим образом:
|
||
|
||
Разработать REST-сервис, проверяющий работоспособность любой последовательности узлов.
|
||
|
||
1. Каждый узел имеет уникальное имя и счетчик успешно выполненных запросов,
|
||
так же для хранения в базе данных есть уникальный идентификатор, который
|
||
присваивается автоматически при записи в БД. Был исключен элемент вероятность отказа узла.
|
||
Этот параметр перестал быть нужным, так как вероятность отказа узла стала случайным фактором,
|
||
возникающая автоматически, во время проверки последовательности узлов.
|
||
1. Граф в программе неориентированный, т.е. вершины графа связаны друг с другом рёбрами,
|
||
не имеющими направления. В базе данных, хранение графа осуществляется в двух таблицах.
|
||
В одной таблице осуществляется хранение набора узлов графа, в другой набор рёбер графа.
|
||
Более подробно смотрите запись в wiki [Описание данных](./../wikis/Описание%20данных)
|
||
1. Программа позволяет делать следующее:
|
||
1. Работать с графом обобщённо:
|
||
1. Создавать новый граф (при этом информация о прежнем графе будет удалена с БД)
|
||
1. Извлекать информацию о графе в заданном формате
|
||
1. Удалять целиком весь граф
|
||
1. Проверять работоспособность заданной последовательности узлов
|
||
(по условию задачи) выполнив соответствующий запрос.
|
||
1. Работать с узлами и ребрами по отдельности, т.е. добавлять, удалять,
|
||
искать информацию по заданным параметрам. Ручное изменение какой-либо информации о узле и ребре не предусмотрена,
|
||
т.е. возможно либо добавления узла или ребра в БД или удаление из БД)
|
||
|
||
Так как по условию задания, граф должен исключить все виды циклов
|
||
(т.е. граф должен быть ациклическим), то при любом запросе информации о графе целиком
|
||
или при проверки набора заданных узлов будет, происходить автоматический поиск
|
||
и удаление циклов из графа. Удаление циклов происходит при помощи удаления набора рёбер,
|
||
создающие циклы, поэтому в случае обнаружения циклов в графе, набор рёбер графа будет
|
||
изменён и данные изменения попадут в БД.
|
||
|
||
Автоматический поиск и удаление циклов не срабатывает, если происходит работа только
|
||
с набором данных рёбер графа в отдельности, т.е. можно добавлять в базу рёбра,
|
||
образующие циклы.
|
||
|
||
**Используемый стек** : **Spring Boot**, **Spring Data**, **ORM (Hibernate)**,
|
||
[**JGraphT**](https://jgrapht.org/) (для работы с графом),
|
||
**GSON** (используется вместо используемого по умолчанию Jackson для работы с json),
|
||
**Thymeleaf** и **Bootstrap** (используется для формирования стартовой информационной страницы),
|
||
**Mockito** (идёт вместе с Spring Boot),
|
||
**Powermock** (подключается отдельной библиотекой, используется в дополнении к mockito для тестов)
|
||
|
||
**Хранилище данных** : PostgeSQL (для production), H2 (для тестов) |