students_lab4_s0195941 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.yardopts +7 -0
- data/{src → controller}/create_student_controller.rb +1 -0
- data/{src → controller}/student_form_controller.rb +56 -48
- data/{src → controller}/student_list_controller.rb +98 -89
- data/{src → controller}/update_student_controller.rb +1 -0
- data/lib/students_lab4_s0195941.rb +1 -1
- data/{src → model}/data_list.rb +64 -57
- data/{src → model}/data_list_student_short.rb +9 -0
- data/{src → model}/data_table.rb +34 -30
- data/model/db.rb +19 -0
- data/{src → model}/student.rb +135 -126
- data/{src → model}/student_base.rb +35 -33
- data/{src → model}/student_short.rb +33 -29
- data/{src → model}/students_list.rb +200 -172
- data/{src → model}/validated_attr_writer.rb +27 -24
- data/student_list_app.rb +23 -0
- data/uml/class_diagram.md +247 -0
- data/uml/create_student_sequence.md +109 -0
- data/uml/delete_student_sequence.md +81 -0
- data/uml/startup_sequence.md +361 -0
- data/uml/update_student_sequence.md +144 -0
- data/{src → view}/student_form_view.rb +89 -71
- data/{src → view}/student_list_view.rb +119 -100
- metadata +24 -18
- data/README.md +0 -15
- data/src/db.rb +0 -14
- data/src/student_list_app.rb +0 -18
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 0ec74855088d24716dbc0df653f9f263395137d922815d58ee985ec0d158c6f1
|
|
4
|
+
data.tar.gz: 026ecb37a7dc3bab60fa7844418b5c37a0c608697785a6b52ccba4ea484157b8
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: e7795f2f1e1fa1a814cfd6ddade51d93dd4c4815db6181590034af318c7a3a18ed61208cb3f509b978e2bda31f68b7e873a1ee5fcfce0d629d871520ed556a08
|
|
7
|
+
data.tar.gz: 782ce859db2f666bce04b2bf41d389618246b34e607ac5952596e4dfed69df14211c5947937eab4e3a9c247c61a75336a153e95ebee0a0c9dce5c2351393b53f
|
data/.yardopts
ADDED
|
@@ -1,48 +1,56 @@
|
|
|
1
|
-
require_relative '
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
class StudentFormController
|
|
5
|
-
def initialize(view, students)
|
|
6
|
-
@view = view
|
|
7
|
-
@students = students
|
|
8
|
-
end
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
def
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
1
|
+
require_relative '../model/students_list'
|
|
2
|
+
|
|
3
|
+
# Проверяет поля и задаёт общий порядок сохранения для контроллеров формы.
|
|
4
|
+
class StudentFormController
|
|
5
|
+
def initialize(view, students)
|
|
6
|
+
@view = view
|
|
7
|
+
@students = students
|
|
8
|
+
end
|
|
9
|
+
|
|
10
|
+
# Открывает модальную форму со значениями, выбранными текущей стратегией.
|
|
11
|
+
def open
|
|
12
|
+
@view.open(self, initial_attributes)
|
|
13
|
+
end
|
|
14
|
+
|
|
15
|
+
# Проверяет текущий ввод по правилам Student и обновляет доступность ОК.
|
|
16
|
+
def changed(attributes)
|
|
17
|
+
@view.set_submit_enabled(!build_student(attributes).nil?)
|
|
18
|
+
end
|
|
19
|
+
|
|
20
|
+
# Сохраняет корректные данные и закрывает форму при успехе.
|
|
21
|
+
# @param attributes [Hash{Symbol => String}] значения полей формы
|
|
22
|
+
def submit(attributes)
|
|
23
|
+
student = build_student(attributes)
|
|
24
|
+
return unless student
|
|
25
|
+
|
|
26
|
+
if persist(student)
|
|
27
|
+
@view.accept
|
|
28
|
+
else
|
|
29
|
+
@view.show_missing_student
|
|
30
|
+
end
|
|
31
|
+
rescue Students_list::DuplicateContact => error
|
|
32
|
+
@view.show_duplicate_contact(error.field)
|
|
33
|
+
rescue Students_list::ConnectionLost
|
|
34
|
+
@view.show_connection_error
|
|
35
|
+
end
|
|
36
|
+
|
|
37
|
+
private
|
|
38
|
+
|
|
39
|
+
def initial_attributes
|
|
40
|
+
{}
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def persist(student)
|
|
44
|
+
raise NotImplementedError
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
def build_student(attributes)
|
|
48
|
+
normalized = attributes.transform_values do |value|
|
|
49
|
+
text = value.strip
|
|
50
|
+
text.empty? ? nil : text
|
|
51
|
+
end
|
|
52
|
+
Student.new(**normalized)
|
|
53
|
+
rescue ArgumentError
|
|
54
|
+
nil
|
|
55
|
+
end
|
|
56
|
+
end
|
|
@@ -1,89 +1,98 @@
|
|
|
1
|
-
require_relative 'students_list'
|
|
2
|
-
require_relative 'create_student_controller'
|
|
3
|
-
require_relative 'update_student_controller'
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
@
|
|
13
|
-
@
|
|
14
|
-
@
|
|
15
|
-
@
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
def
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
@
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
end
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
1
|
+
require_relative '../model/students_list'
|
|
2
|
+
require_relative 'create_student_controller'
|
|
3
|
+
require_relative 'update_student_controller'
|
|
4
|
+
|
|
5
|
+
# Управляет списком, фильтром и действиями над выбранными студентами.
|
|
6
|
+
class StudentListController
|
|
7
|
+
# Число студентов на странице.
|
|
8
|
+
PAGE_SIZE = 2
|
|
9
|
+
attr_reader :page
|
|
10
|
+
|
|
11
|
+
def initialize(view, connection)
|
|
12
|
+
@view = view
|
|
13
|
+
@students = Students_list.new(connection)
|
|
14
|
+
@page = 1
|
|
15
|
+
@incomplete_only = false
|
|
16
|
+
@data_list = Data_list_student_short.new([])
|
|
17
|
+
@data_list.add_observer(@view)
|
|
18
|
+
end
|
|
19
|
+
|
|
20
|
+
# Загружает страницу в существующий список и уведомляет представление.
|
|
21
|
+
def refresh_data
|
|
22
|
+
load_page
|
|
23
|
+
last_page = [total_pages, 1].max
|
|
24
|
+
if @page > last_page
|
|
25
|
+
@page = last_page
|
|
26
|
+
load_page
|
|
27
|
+
end
|
|
28
|
+
@data_list.notify
|
|
29
|
+
rescue Students_list::ConnectionLost
|
|
30
|
+
@view.show_connection_error('Не удалось загрузить список. Когда база заработает, нажмите «Обновить».')
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
# Переключает фильтр и возвращает список на первую страницу.
|
|
34
|
+
def show_incomplete_students(incomplete_only)
|
|
35
|
+
@incomplete_only = incomplete_only
|
|
36
|
+
@page = 1
|
|
37
|
+
refresh_data
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
# Преобразует индексы выделенных строк в ID и удаляет записи одной транзакцией.
|
|
41
|
+
def delete_selected(row_numbers)
|
|
42
|
+
ids = selected_student_ids(row_numbers)
|
|
43
|
+
return if ids.empty?
|
|
44
|
+
|
|
45
|
+
@students.delete_many(ids)
|
|
46
|
+
refresh_data
|
|
47
|
+
rescue Students_list::ConnectionLost
|
|
48
|
+
@view.show_connection_error('Связь прервалась при удалении. Обновите список, чтобы проверить результат.')
|
|
49
|
+
end
|
|
50
|
+
|
|
51
|
+
# Открывает пустую форму и перечитывает список после её закрытия.
|
|
52
|
+
def open_create_form
|
|
53
|
+
form = @view.build_student_form
|
|
54
|
+
CreateStudentController.new(form, @students).open
|
|
55
|
+
refresh_data
|
|
56
|
+
end
|
|
57
|
+
|
|
58
|
+
# Загружает выбранного студента по ID и открывает заполненную форму.
|
|
59
|
+
def open_update_form(row_numbers)
|
|
60
|
+
ids = selected_student_ids(row_numbers)
|
|
61
|
+
return unless ids.one?
|
|
62
|
+
|
|
63
|
+
student = @students.get_by_id(ids.first)
|
|
64
|
+
if student
|
|
65
|
+
form = @view.build_student_form('Изменить студента')
|
|
66
|
+
UpdateStudentController.new(form, @students, student).open
|
|
67
|
+
end
|
|
68
|
+
refresh_data
|
|
69
|
+
rescue Students_list::ConnectionLost
|
|
70
|
+
@view.show_connection_error('Не удалось загрузить студента. Когда база заработает, нажмите «Обновить».')
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
# @return [Integer] число страниц текущей выборки, для пустой выборки — ноль
|
|
74
|
+
def total_pages
|
|
75
|
+
(@data_list.whole_entities_count + PAGE_SIZE - 1) / PAGE_SIZE
|
|
76
|
+
end
|
|
77
|
+
|
|
78
|
+
# Загружает соседнюю страницу, если номер входит в границы выборки.
|
|
79
|
+
def change_page(step)
|
|
80
|
+
next_page = @page + step
|
|
81
|
+
return unless next_page.between?(1, total_pages)
|
|
82
|
+
|
|
83
|
+
@page = next_page
|
|
84
|
+
refresh_data
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
private
|
|
88
|
+
|
|
89
|
+
def load_page
|
|
90
|
+
@students.get_k_n_student_short_list(@page, PAGE_SIZE, @data_list, incomplete_only: @incomplete_only)
|
|
91
|
+
end
|
|
92
|
+
|
|
93
|
+
def selected_student_ids(row_numbers)
|
|
94
|
+
@data_list.clear_selected
|
|
95
|
+
row_numbers.each { |row| @data_list.select(row) }
|
|
96
|
+
@data_list.get_selected
|
|
97
|
+
end
|
|
98
|
+
end
|
|
@@ -1 +1 @@
|
|
|
1
|
-
require_relative '../
|
|
1
|
+
require_relative '../student_list_app'
|
data/{src → model}/data_list.rb
RENAMED
|
@@ -1,57 +1,64 @@
|
|
|
1
|
-
require_relative 'data_table'
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
@
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
def
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
def
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
1
|
+
require_relative 'data_table'
|
|
2
|
+
|
|
3
|
+
# Общая модель таблицы с заголовками и выделением строк.
|
|
4
|
+
class Data_list
|
|
5
|
+
def initialize(list)
|
|
6
|
+
@selected = []
|
|
7
|
+
@names = get_names.map { |name| name.dup.freeze }.freeze
|
|
8
|
+
self.list = list
|
|
9
|
+
end
|
|
10
|
+
|
|
11
|
+
# Заменяет содержимое страницы и сбрасывает выделение.
|
|
12
|
+
def list=(list)
|
|
13
|
+
@list = list.map { |element| element.dup.freeze }.freeze
|
|
14
|
+
clear_selected
|
|
15
|
+
nil
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
# Добавляет строку по индексу с нуля, сохраняя предыдущие выделения.
|
|
19
|
+
def select(number)
|
|
20
|
+
unless number.is_a?(Integer) && number >= 0 && number < @list.length
|
|
21
|
+
raise IndexError, 'Номер элемента находится за пределами списка'
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
@selected << number unless @selected.include?(number)
|
|
25
|
+
nil
|
|
26
|
+
end
|
|
27
|
+
|
|
28
|
+
# @return [Array] ID выделенных объектов
|
|
29
|
+
def get_selected
|
|
30
|
+
@selected.map { |number| @list[number].id }
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
# @return [Array<String>] заголовки в порядке отображения столбцов
|
|
34
|
+
def get_names
|
|
35
|
+
return @names.dup unless @names.nil?
|
|
36
|
+
|
|
37
|
+
['№ по порядку'] + get_attribute_names
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
# @return [Data_table] снимок текущей страницы с порядковыми номерами
|
|
41
|
+
def get_data
|
|
42
|
+
rows = @list.each_with_index.map do |element, index|
|
|
43
|
+
[index + 1] + get_object_data(element)
|
|
44
|
+
end
|
|
45
|
+
|
|
46
|
+
Data_table.new(rows)
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
# Снимает выделение со всех строк.
|
|
50
|
+
def clear_selected
|
|
51
|
+
@selected.clear
|
|
52
|
+
nil
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
private
|
|
56
|
+
|
|
57
|
+
def get_attribute_names
|
|
58
|
+
raise NotImplementedError, 'Наследник должен реализовать get_attribute_names'
|
|
59
|
+
end
|
|
60
|
+
|
|
61
|
+
def get_object_data(element)
|
|
62
|
+
raise NotImplementedError, 'Наследник должен реализовать get_object_data'
|
|
63
|
+
end
|
|
64
|
+
end
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
require_relative 'data_list'
|
|
2
2
|
|
|
3
|
+
# Наблюдаемая страница кратких данных студентов.
|
|
3
4
|
class Data_list_student_short < Data_list
|
|
4
5
|
attr_reader :whole_entities_count
|
|
5
6
|
|
|
@@ -9,10 +10,14 @@ class Data_list_student_short < Data_list
|
|
|
9
10
|
@observers = []
|
|
10
11
|
end
|
|
11
12
|
|
|
13
|
+
# Подписывает объект, который отвечает на set_table_params и set_table_data.
|
|
14
|
+
# @param observer [Object] получатель уведомлений
|
|
12
15
|
def add_observer(observer)
|
|
13
16
|
@observers << observer unless @observers.include?(observer)
|
|
14
17
|
end
|
|
15
18
|
|
|
19
|
+
# Передаёт подписчикам заголовки, число записей и строки текущей страницы.
|
|
20
|
+
# @return [nil]
|
|
16
21
|
def notify
|
|
17
22
|
column_names = get_names
|
|
18
23
|
table = get_data
|
|
@@ -23,6 +28,10 @@ class Data_list_student_short < Data_list
|
|
|
23
28
|
nil
|
|
24
29
|
end
|
|
25
30
|
|
|
31
|
+
# Обновляет данные в том же объекте и очищает выделение строк.
|
|
32
|
+
# @param students [Array<StudentShort>] записи текущей страницы
|
|
33
|
+
# @param count [Integer] число записей во всей выборке
|
|
34
|
+
# @return [nil]
|
|
26
35
|
def replace_page(students, count)
|
|
27
36
|
self.list = students
|
|
28
37
|
@whole_entities_count = count
|
data/{src → model}/data_table.rb
RENAMED
|
@@ -1,30 +1,34 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
1
|
+
# Двумерное представление строк и ячеек таблицы.
|
|
2
|
+
class Data_table
|
|
3
|
+
def initialize(table)
|
|
4
|
+
unless table.is_a?(Array) && table.all? { |row| row.is_a?(Array) }
|
|
5
|
+
raise ArgumentError, 'Таблица должна быть двумерным массивом'
|
|
6
|
+
end
|
|
7
|
+
|
|
8
|
+
columns = table.empty? ? 0 : table.first.length
|
|
9
|
+
|
|
10
|
+
unless table.all? { |row| row.length == columns }
|
|
11
|
+
raise ArgumentError, 'Строки таблицы должны иметь одинаковую длину'
|
|
12
|
+
end
|
|
13
|
+
|
|
14
|
+
@table = table.map do |row|
|
|
15
|
+
row.map { |element| element.dup.freeze }.freeze
|
|
16
|
+
end.freeze
|
|
17
|
+
end
|
|
18
|
+
|
|
19
|
+
# Возвращает значение ячейки по индексам строки и столбца.
|
|
20
|
+
def get_element(row, column)
|
|
21
|
+
@table.fetch(row).fetch(column)
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
# @return [Integer] ширина таблицы, для пустой таблицы — ноль
|
|
25
|
+
def get_columns
|
|
26
|
+
@table.empty? ? 0 : @table.first.length
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
# @return [Integer] число строк в таблице
|
|
30
|
+
def get_rows
|
|
31
|
+
@table.length
|
|
32
|
+
end
|
|
33
|
+
|
|
34
|
+
end
|
data/model/db.rb
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
require 'pg'
|
|
2
|
+
|
|
3
|
+
# Подключение приложения к PostgreSQL.
|
|
4
|
+
module DB
|
|
5
|
+
# Открывает соединение с настройками из переменных окружения PG*.
|
|
6
|
+
# При вызове с блоком драйвер закрывает соединение после его выполнения.
|
|
7
|
+
# @yieldparam connection [PG::Connection] открытое соединение
|
|
8
|
+
# @return [PG::Connection, Object] соединение или результат блока
|
|
9
|
+
def self.connect(&block)
|
|
10
|
+
PG.connect(
|
|
11
|
+
host: ENV.fetch('PGHOST', '127.0.0.1'),
|
|
12
|
+
port: ENV.fetch('PGPORT', '5432'),
|
|
13
|
+
dbname: ENV.fetch('PGDATABASE', 'students_lab4'),
|
|
14
|
+
user: ENV.fetch('PGUSER', 'postgres'),
|
|
15
|
+
connect_timeout: 5,
|
|
16
|
+
&block
|
|
17
|
+
)
|
|
18
|
+
end
|
|
19
|
+
end
|