Linkchecker (тестовое задание)

h1. План работы

Работа над тестовым заданием:

* Схематично отразить работу программы, рассмотреть несколько вариантов работы, где должно быть отражено успех программы или неуспех. Это наглядно покажет как должна работать программа.

* Схематично отразить работу программы, рассмотреть несколько вариантов работы, где должны быть отражены успешные и не успешные запросы к сервису. Это наглядно покажет как должна работать программа.

* Создание основной бизнес логики.

* Создать структуру веб-приложения работающего как REST-сервис.

* Покрытие тестами.

----

h1. Структура данных.

h2. Входные данные

h3. Граф

Входными данными будет граф G(V,E), где V - множество вершин графа (ноды), E - множество рёбер, соединяющих вершины. Граф не ориентированный. Сама вершина (нода) представляет собой объект, состоящий из уникального имени. Ребро представляет собой объект состоящий из двух ссылок на вершины, которые это ребро соединяет, в данном случае под ссылками подразумевается уникальное имя ноды. В формате JSON это будет выглядеть так:   

<pre>

{"nodes": [{"name":"unique_node_name"}, ...], "edges": [{"nodeOne":"unique_node_one_name", "nodeTwo":"unique_node_one_name"}, ...]}

</pre>

, где

_{"name":”unique_node_name"}_ - объект описывающий вершину графа (ноду)

_{"nodeOne":"unique_node_one_name", "nodeTwo":"unique_node_one_name"}_ - объект описывающий ребро, соединяющее две вершины графа.

*Графическое представление входных графов*

{{dmsf_image(134)}}

Циклический граф

{{dmsf_image(131)}}

Ациклический граф

Входные графы могут содержать циклы, которые нужно исключить по условию задачи.

*В качестве дополнения (это не входило в основную задачу)*

Возможность работы с нодами отдельно, т.е. в граф можно добавить ноду или набор нод отдельным запросом

Входной одиночный объект, описывающий ноду

<pre>

{"name":"unique_node_name"}

</pre>

Входной набор нод

<pre>

[{"name":"unique_node_name"}, {"name":"unique_node_name"}, ...]

</pre>

Возможность работы с рёбрами графа отдельно, т.е. в граф можно добавить ребро или набор рёбер отдельным запросом

Входной, одиночный объект описывающий ребро графа

<pre>

{"nodeOne":"unique_node_one_name", "nodeTwo":"unique_node_one_name"}

</pre>

Входной набор рёбер

<pre>

[{"nodeOne":"unique_node_one_name", "nodeTwo":"unique_node_one_name"}, {"nodeOne":"unique_node_one_name", "nodeTwo":"unique_node_one_name"}, ...]

</pre>

h3. Вершины графа (Ноды)

Так же на вход будут подаваться списки вершин графа для проверки связности вершин. Представляет собой простой перечень уникальных имён вершин.

В представлении JSON будет выглядеть так:

<pre>

["unique_node_name", "unique_node_name", ...]

</pre>

, где unique_node_name - уникальное имя вершины.

h2. Структура выходных данных

При запросе к сервису можно получить следующие данные:

*Граф целиком*

<pre>

{"nodes":[{"id":1, "name":"unique_name", "counter":0}, ...], "edges":[{"id":1, "nodeOne":"unique_node_name_one", "nodeOne":"unique_node_name_one"}, ...]}

</pre>

*Список вершин графа*

<pre>

[{"id":1, "name":"unique_name", "counter":0}, ...]

</pre>

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

<pre>

{"id":1, "name":"unique_name", "counter":0}

</pre>

,где: id - уникальный идентификатор вершины, name - уникальное имя вершины, counter - счётчик посещения вершины.

Так же есть возможность получить информацию по рёбрам графа в следующем формате

Списком

<pre>

[{"id":1, "nodeOne":"unique_node_name_one", "nodeOne":"unique_node_name_one"}, ...]

</pre>

Отдельным объектом

{"id":1, "nodeOne":"unique_node_name_one", "nodeOne":"unique_node_name_one"}

,где: id - уникальный идентификатор ребра графа, nodeOne, nodeTwo - уникальное имя узла графа. Запись ребра графа хранит информацию о одной паре узлов.

h2. Модель хранения данных

Класс *Node* - описывающий модель вершины графа (ноды). Класс состоит из следующих полей:

*id* - уникальный идентификатор (нужен для хранения в БД). Присваивается автоматически при  записи в БД, его нельзя изменить из вне, данный параметр только на отдачу из базы.

*name* - уникальное имя узла (получаем из json).

*counter* - при каждом удачном проходе маршрута через ноду, счётчик ноды увеличивается автоматически, данный параметр только на отдачу из базы, его нельзя заменить из вне.

Класс *Edge* - описывающий модель ребра графа. Ребро графа способно хранить информацию только о одной паре паре узлов. Класс состоит из следующих полей:

*id* - уникальный идентификатор записи (нужен для хранения в БД). Присваивается автоматически при  записи в БД, его нельзя изменить из вне, данный параметр только на отдачу из базы.

*nodeOne* - ссылка на первую ноду

*nodeTwo* - ссылка на вторую ноду

h2. Модель хранения данных в БД

{{dmsf_image(135)}}

Связь один-к-одному Одна запись ребра графа хранит две ссылки на разные ноды

SQL Schema (PostgreSQL notation)

<pre><code class="sql">

DROP TABLE IF EXISTS nodes CASCADE;

DROP TABLE IF EXISTS edges;

DROP SEQUENCE IF EXISTS global_seq CASCADE;

CREATE SEQUENCE global_seq START 5000;

CREATE TABLE nodes (

    id INTEGER PRIMARY KEY DEFAULT nextval('global_seq'),

    name VARCHAR NOT NULL,

    counter INTEGER DEFAULT 0 NOT NULL

);

CREATE UNIQUE INDEX nodes_unique_name_idx ON nodes(name);

CREATE TABLE edges (

    id INTEGER PRIMARY KEY DEFAULT nextval('global_seq'),

    nodeone INT NOT NULL,

    nodetwo INT NOT NULL,

    FOREIGN KEY (nodeone) REFERENCES nodes(id) ON DELETE CASCADE,

    FOREIGN KEY (nodetwo) REFERENCES nodes(id) ON DELETE CASCADE,

    CHECK (nodeone <> nodetwo),

    CONSTRAINT unique_edge UNIQUE (nodeone, nodetwo)

);

</code></pre>