iscatel_student_list 0.1.0
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 +7 -0
- data/.yardopts +11 -0
- data/README.md +24 -0
- data/diagrams/controller.md +102 -0
- data/diagrams/domain.md +89 -0
- data/diagrams/model.md +83 -0
- data/diagrams/sequence_create.md +57 -0
- data/diagrams/sequence_delete.md +49 -0
- data/diagrams/sequence_init.md +57 -0
- data/diagrams/sequence_read.md +53 -0
- data/diagrams/sequence_update.md +57 -0
- data/diagrams/structure.md +44 -0
- data/diagrams/view.md +123 -0
- data/exe/student_list +5 -0
- data/lib/student_list/controller/student_list_controller.rb +326 -0
- data/lib/student_list/domain/ValidAttrAccessor.rb +21 -0
- data/lib/student_list/domain/basic_student.rb +69 -0
- data/lib/student_list/domain/student.rb +191 -0
- data/lib/student_list/domain/student_short.rb +42 -0
- data/lib/student_list/model/data_list.rb +109 -0
- data/lib/student_list/model/data_list_student_short.rb +58 -0
- data/lib/student_list/model/data_table.rb +32 -0
- data/lib/student_list/model/student_list.rb +138 -0
- data/lib/student_list/view/student_list_view.rb +595 -0
- data/lib/student_list.rb +23 -0
- data/sql/PostgreSQL/init +24 -0
- data/sql/PostgreSQL/insertion +51 -0
- metadata +107 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
require_relative 'basic_student'
|
|
2
|
+
require_relative 'ValidAttrAccessor'
|
|
3
|
+
|
|
4
|
+
# Модель сущности «Студент» с полной информацией и валидацией полей.
|
|
5
|
+
#
|
|
6
|
+
# @example Создание объекта студента из хэша
|
|
7
|
+
# student = Student.from_hash(
|
|
8
|
+
# first_name: 'Иван',
|
|
9
|
+
# last_name: 'Иванов',
|
|
10
|
+
# telegram: '@ivan_ivanov'
|
|
11
|
+
# )
|
|
12
|
+
class Student < BasicStudent
|
|
13
|
+
# Универсальный метод проверки строкового значения по регулярному выражению.
|
|
14
|
+
#
|
|
15
|
+
# @param value [String, nil] проверяемое значение
|
|
16
|
+
# @param regex [Regexp] регулярное выражение для проверки формата
|
|
17
|
+
# @param null_value [Boolean] допускается ли значение +nil+
|
|
18
|
+
# @return [Boolean] +true+, если значение корректно
|
|
19
|
+
def self.valid?(value, regex, null_value = false)
|
|
20
|
+
(value =~ regex) == 0 || (null_value && value.nil?)
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
# Проверяет корректность компонента ФИО (кириллица или латиница с заглавной буквы).
|
|
24
|
+
#
|
|
25
|
+
# @param name [String, nil] проверяемое имя, фамилия или отчество
|
|
26
|
+
# @param null_value [Boolean] допускается ли +nil+
|
|
27
|
+
# @return [Boolean] +true+, если строка соответствует формату имени
|
|
28
|
+
def self.valid_name?(name, null_value = false)
|
|
29
|
+
valid?(name, /^(([A-Z][a-z]*)|([А-ЯЁ][а-яё]*))$/, null_value)
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
# Проверяет корректность имени (обязательное поле).
|
|
33
|
+
#
|
|
34
|
+
# @param first_name [String, nil] имя студента
|
|
35
|
+
# @return [Boolean] +true+, если имя корректно
|
|
36
|
+
def self.valid_first_name?(first_name)
|
|
37
|
+
valid_name?(first_name, false)
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
# Проверяет корректность фамилии (обязательное поле).
|
|
41
|
+
#
|
|
42
|
+
# @param last_name [String, nil] фамилия студента
|
|
43
|
+
# @return [Boolean] +true+, если фамилия корректна
|
|
44
|
+
def self.valid_last_name?(last_name)
|
|
45
|
+
valid_name?(last_name, false)
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
# Проверяет корректность отчества (необязательное поле).
|
|
49
|
+
#
|
|
50
|
+
# @param patronymic [String, nil] отчество студента
|
|
51
|
+
# @return [Boolean] +true+, если отчество корректно или равно +nil+
|
|
52
|
+
def self.valid_patronymic?(patronymic)
|
|
53
|
+
valid_name?(patronymic, true)
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
# Проверяет корректность имени пользователя Telegram (формат +@username+, от 5 до 32 символов после +@+).
|
|
57
|
+
#
|
|
58
|
+
# @param telegram [String, nil] никнейм в Telegram
|
|
59
|
+
# @return [Boolean] +true+, если формат корректен или значение +nil+
|
|
60
|
+
def self.valid_telegram?(telegram)
|
|
61
|
+
valid?(telegram, /^(?=.{6,33}$)@[a-zA-Z0-9_]+$/, true)
|
|
62
|
+
end
|
|
63
|
+
|
|
64
|
+
# Проверяет корректность адреса электронной почты.
|
|
65
|
+
#
|
|
66
|
+
# @param email [String, nil] адрес e-mail
|
|
67
|
+
# @return [Boolean] +true+, если адрес корректен или значение +nil+
|
|
68
|
+
def self.valid_email?(email)
|
|
69
|
+
valid?(email, /^[a-z+.-]+@[a-z]+[a-z.]*\.[a-z]+$/, true)
|
|
70
|
+
end
|
|
71
|
+
|
|
72
|
+
# Проверяет корректность номера телефона.
|
|
73
|
+
#
|
|
74
|
+
# @param phone [String, nil] номер телефона
|
|
75
|
+
# @return [Boolean] +true+, если номер соответствует формату или значение +nil+
|
|
76
|
+
def self.valid_phone?(phone)
|
|
77
|
+
valid?(phone, /^[+]?((\d{4})|(\d\(\d{3}\)))-?\d{3}-?\d{2}-?\d{2}$/, true)
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
# Проверяет корректность ссылки на профиль GitHub или GitLab.
|
|
81
|
+
#
|
|
82
|
+
# @param git [String, nil] URL профиля Git
|
|
83
|
+
# @return [Boolean] +true+, если URL корректен или значение +nil+
|
|
84
|
+
def self.valid_git?(git)
|
|
85
|
+
valid?(git, /^(?=.{20,58}$)https:\/\/git(hub|lab).com\/[a-zA-Z0-9_-]+$/, true)
|
|
86
|
+
end
|
|
87
|
+
|
|
88
|
+
private_class_method :valid?, :valid_first_name?, :valid_last_name?, :valid_patronymic?, :attr_accessor
|
|
89
|
+
|
|
90
|
+
include ValidAttrAccessor
|
|
91
|
+
|
|
92
|
+
# @!attribute [rw] first_name
|
|
93
|
+
# @return [String] имя студента
|
|
94
|
+
# @!attribute [rw] last_name
|
|
95
|
+
# @return [String] фамилия студента
|
|
96
|
+
# @!attribute [rw] patronymic
|
|
97
|
+
# @return [String, nil] отчество студента
|
|
98
|
+
# @!attribute [rw] telegram
|
|
99
|
+
# @return [String, nil] аккаунт Telegram
|
|
100
|
+
# @!attribute [rw] email
|
|
101
|
+
# @return [String, nil] адрес электронной почты
|
|
102
|
+
# @!attribute [rw] phone
|
|
103
|
+
# @return [String, nil] номер телефона
|
|
104
|
+
# @!attribute [rw] git
|
|
105
|
+
# @return [String, nil] ссылка на профиль Git
|
|
106
|
+
attr_accessor :first_name, :last_name, :patronymic, :telegram, :email, :phone, :git
|
|
107
|
+
|
|
108
|
+
# Возвращает первый доступный контакт студента по приоритету: Telegram, Email, телефон.
|
|
109
|
+
#
|
|
110
|
+
# @return [String, nil] строка вида +"тип - значение"+ или +nil+, если контакты отсутствуют
|
|
111
|
+
def contact
|
|
112
|
+
return "telegram - #{telegram}" unless telegram.nil?
|
|
113
|
+
return "email - #{email}" unless email.nil?
|
|
114
|
+
return "phone - #{phone}" unless phone.nil?
|
|
115
|
+
|
|
116
|
+
nil
|
|
117
|
+
end
|
|
118
|
+
|
|
119
|
+
# Устанавливает контактные данные студента из хэша.
|
|
120
|
+
#
|
|
121
|
+
# @param contacts [Hash{Symbol => String, nil}] хэш с ключами +:telegram+, +:email+, +:phone+
|
|
122
|
+
# @return [String, nil] установленное значение телефона
|
|
123
|
+
def contact=(contacts)
|
|
124
|
+
self.telegram = contacts[:telegram]
|
|
125
|
+
self.email = contacts[:email]
|
|
126
|
+
self.phone = contacts[:phone]
|
|
127
|
+
end
|
|
128
|
+
|
|
129
|
+
# Создаёт экземпляр {Student} из хэша атрибутов.
|
|
130
|
+
#
|
|
131
|
+
# @param student [Hash{Symbol => Object}] словарь с данными студента
|
|
132
|
+
# @return [Student] новый экземпляр студента
|
|
133
|
+
# @raise [ArgumentError] при некорректных значениях полей
|
|
134
|
+
def self.from_hash(student)
|
|
135
|
+
new(first_name: student[:first_name], last_name: student[:last_name], id: student[:id], patronymic: student[:patronymic], telegram: student[:telegram], email: student[:email], phone: student[:phone], git: student[:git])
|
|
136
|
+
end
|
|
137
|
+
|
|
138
|
+
# Инициализирует новый объект {Student}.
|
|
139
|
+
#
|
|
140
|
+
# @param first_name [String] имя (обязательно)
|
|
141
|
+
# @param last_name [String] фамилия (обязательно)
|
|
142
|
+
# @param id [Integer, nil] идентификатор в БД
|
|
143
|
+
# @param patronymic [String, nil] отчество
|
|
144
|
+
# @param telegram [String, nil] никнейм в Telegram
|
|
145
|
+
# @param email [String, nil] адрес электронной почты
|
|
146
|
+
# @param phone [String, nil] номер телефона
|
|
147
|
+
# @param git [String, nil] ссылка на Git-профиль
|
|
148
|
+
# @raise [ArgumentError] если какое-либо поле не проходит валидацию
|
|
149
|
+
def initialize(first_name:, last_name:, id: nil, patronymic: nil, telegram: nil, email: nil, phone: nil, git: nil)
|
|
150
|
+
@id = id
|
|
151
|
+
self.first_name = first_name
|
|
152
|
+
self.last_name = last_name
|
|
153
|
+
self.patronymic = patronymic
|
|
154
|
+
self.contact = {telegram: telegram, email: email, phone: phone}
|
|
155
|
+
self.git = git
|
|
156
|
+
end
|
|
157
|
+
|
|
158
|
+
include Comparable
|
|
159
|
+
|
|
160
|
+
# Сравнивает двух студентов по фамилии, имени и отчеству.
|
|
161
|
+
#
|
|
162
|
+
# @param other [Object] объект для сравнения
|
|
163
|
+
# @return [Integer, nil] +-1+, +0+, +1+ или +nil+, если объекты несопоставимы
|
|
164
|
+
def <=>(other)
|
|
165
|
+
return nil unless other.is_a? self
|
|
166
|
+
[last_name, first_name, patronymic] <=> [other.last_name, other.first_name, other.patronymic]
|
|
167
|
+
end
|
|
168
|
+
|
|
169
|
+
# Формирует строку с фамилией и инициалами студента (например, +"Иванов И. И."+).
|
|
170
|
+
#
|
|
171
|
+
# @return [String] фамилия и инициалы
|
|
172
|
+
def last_name_initials
|
|
173
|
+
initials = "#{last_name} #{first_name[0]}."
|
|
174
|
+
initials += " #{patronymic[0]}." unless patronymic.nil?
|
|
175
|
+
initials
|
|
176
|
+
end
|
|
177
|
+
|
|
178
|
+
# Возвращает полную информацию о студенте в виде форматированной строки.
|
|
179
|
+
#
|
|
180
|
+
# @return [String] строковое представление всех заполненных полей студента
|
|
181
|
+
def to_s
|
|
182
|
+
info = "#{first_name} #{last_name}"
|
|
183
|
+
info += " #{patronymic}" unless patronymic.nil?
|
|
184
|
+
info += " #{id}" unless id.nil?
|
|
185
|
+
info += " git - #{git}" unless git.nil?
|
|
186
|
+
info += " phone - #{phone}" unless phone.nil?
|
|
187
|
+
info += " email - #{email}" unless email.nil?
|
|
188
|
+
info += " telegram - #{telegram}" unless telegram.nil?
|
|
189
|
+
info
|
|
190
|
+
end
|
|
191
|
+
end
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
require_relative 'basic_student'
|
|
2
|
+
|
|
3
|
+
# Краткое представление студента для отображения в списочных и табличных структурах.
|
|
4
|
+
class StudentShort < BasicStudent
|
|
5
|
+
# @return [String] фамилия и инициалы студента
|
|
6
|
+
attr_reader :last_name_initials
|
|
7
|
+
|
|
8
|
+
# @return [String, nil] основной контакт студента
|
|
9
|
+
attr_reader :contact
|
|
10
|
+
|
|
11
|
+
# Создаёт краткое представление {StudentShort} на основе полного объекта {Student}.
|
|
12
|
+
#
|
|
13
|
+
# @param student [Student] исходный объект студента
|
|
14
|
+
# @return [StudentShort] сокращённый объект студента
|
|
15
|
+
def self.from_student(student)
|
|
16
|
+
new(id: student.id, last_name_initials: student.last_name_initials, contact: student.contact, git: student.git)
|
|
17
|
+
end
|
|
18
|
+
|
|
19
|
+
# Инициализирует краткое представление студента.
|
|
20
|
+
#
|
|
21
|
+
# @param id [Integer, nil] идентификатор студента
|
|
22
|
+
# @param last_name_initials [String] фамилия и инициалы
|
|
23
|
+
# @param contact [String, nil] контактная информация
|
|
24
|
+
# @param git [String, nil] ссылка на Git-профиль
|
|
25
|
+
def initialize(id:, last_name_initials:, contact: nil, git: nil)
|
|
26
|
+
@id = id
|
|
27
|
+
@last_name_initials = last_name_initials
|
|
28
|
+
@contact = contact
|
|
29
|
+
@git = git
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
# Возвращает строковое представление краткой информации о студенте.
|
|
33
|
+
#
|
|
34
|
+
# @return [String] строка с ФИО, ID, Git и контактом
|
|
35
|
+
def to_s
|
|
36
|
+
info = "#{last_name_initials}"
|
|
37
|
+
info += " #{id}"
|
|
38
|
+
info += " git - #{git}" unless git.nil?
|
|
39
|
+
info += " #{contact}" unless contact.nil?
|
|
40
|
+
info
|
|
41
|
+
end
|
|
42
|
+
end
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
require_relative 'data_table'
|
|
2
|
+
|
|
3
|
+
# Абстрактный базовый класс для управления списком объектов, выделением строк
|
|
4
|
+
# и преобразованием элементов в табличную структуру {DataTable} (паттерн Template Method).
|
|
5
|
+
#
|
|
6
|
+
# @abstract Наследники должны реализовать приватные методы {#valid_class_names_list?},
|
|
7
|
+
# {#get_class_names} и {#get_object_data}.
|
|
8
|
+
class DataList
|
|
9
|
+
# Инициализирует список объектов.
|
|
10
|
+
#
|
|
11
|
+
# @param list [Array<Object>] начальный массив элементов
|
|
12
|
+
# @raise [NotImplementedError] при попытке создать экземпляр базового класса {DataList}
|
|
13
|
+
# @raise [ArgumentError] если элементы списка не соответствуют ожидаемому интерфейсу
|
|
14
|
+
def initialize(list)
|
|
15
|
+
raise(NotImplementedError, "#{self.class} не может иметь экземпляров") if self.class.is_a?(DataList)
|
|
16
|
+
self.list = list
|
|
17
|
+
end
|
|
18
|
+
|
|
19
|
+
# Заменяет текущий список элементов и сбрасывает выделение.
|
|
20
|
+
#
|
|
21
|
+
# @param list [Array<Object>] новый массив элементов
|
|
22
|
+
# @return [Array] пустой массив выделенных индексов
|
|
23
|
+
# @raise [ArgumentError] если формат элементов списка некорректен
|
|
24
|
+
def list=(list)
|
|
25
|
+
raise(ArgumentError, "Неверный формат данных в списке") unless valid_list?(list)
|
|
26
|
+
@list = list
|
|
27
|
+
@selected = []
|
|
28
|
+
end
|
|
29
|
+
|
|
30
|
+
# Добавляет индекс строки в список выделенных элементов.
|
|
31
|
+
#
|
|
32
|
+
# @param number [Integer] индекс строки в текущем списке
|
|
33
|
+
# @return [Array<Integer>] отсортированный массив выделенных индексов
|
|
34
|
+
def select(number)
|
|
35
|
+
@selected << number
|
|
36
|
+
@selected.sort
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
# Возвращает идентификаторы (+id+) всех выделенных элементов списка.
|
|
40
|
+
#
|
|
41
|
+
# @return [Array<Integer>] массив ID выделенных объектов
|
|
42
|
+
def get_selected
|
|
43
|
+
selected_id = []
|
|
44
|
+
@selected.each { |number| selected_id << @list[number].id }
|
|
45
|
+
selected_id
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
# Возвращает массив заголовков столбцов таблицы, включая столбец порядкового номера.
|
|
49
|
+
#
|
|
50
|
+
# @return [Array<String>] названия столбцов
|
|
51
|
+
# @raise [NotImplementedError] если в наследнике не реализован {#get_class_names}
|
|
52
|
+
def get_names
|
|
53
|
+
raise(NotImplementedError, "#{self.class}#get_class_names не реализован") unless self.class.private_method_defined?(:get_class_names)
|
|
54
|
+
["№ по порядку"].concat(get_class_names)
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
# Формирует объект {DataTable} из текущего списка элементов.
|
|
58
|
+
#
|
|
59
|
+
# @return [DataTable] таблица с порядковыми номерами и данными элементов
|
|
60
|
+
# @raise [NotImplementedError] если в наследнике не реализован {#get_object_data}
|
|
61
|
+
def get_data
|
|
62
|
+
raise(NotImplementedError, "#{self.class}#get_object_data не реализован") unless self.class.private_method_defined?(:get_object_data)
|
|
63
|
+
table = []
|
|
64
|
+
@list.each_with_index { |object, index| table << [index].concat(get_object_data(object)) }
|
|
65
|
+
DataTable.new(table)
|
|
66
|
+
end
|
|
67
|
+
|
|
68
|
+
# Очищает список выделенных строк.
|
|
69
|
+
#
|
|
70
|
+
# @return [Array] пустой массив
|
|
71
|
+
def clear_selected
|
|
72
|
+
@selected = []
|
|
73
|
+
end
|
|
74
|
+
|
|
75
|
+
private
|
|
76
|
+
|
|
77
|
+
# Проверяет корректность переданного массива объектов.
|
|
78
|
+
#
|
|
79
|
+
# @param list [Array<Object>] проверяемый список
|
|
80
|
+
# @return [Boolean] +true+, если список пуст или его элементы поддерживают требуемый интерфейс
|
|
81
|
+
# @raise [NotImplementedError] если в наследнике не реализован {#valid_class_names_list?}
|
|
82
|
+
def valid_list?(list)
|
|
83
|
+
raise(NotImplementedError, "#{self.class}#valid_class_names_list? не реализован") unless self.class.private_method_defined?(:valid_class_names_list?)
|
|
84
|
+
return list.empty? ? true : list[0].respond_to?(:id) && valid_class_names_list?(list)
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
# Проверяет специфичные для наследника методы у элементов списка.
|
|
88
|
+
#
|
|
89
|
+
# @abstract
|
|
90
|
+
# @param list [Array<Object>] проверяемый список
|
|
91
|
+
# @return [Boolean] результат проверки
|
|
92
|
+
def valid_class_names_list?(list)
|
|
93
|
+
end
|
|
94
|
+
|
|
95
|
+
# Возвращает список заголовков столбцов для конкретного типа сущностей.
|
|
96
|
+
#
|
|
97
|
+
# @abstract
|
|
98
|
+
# @return [Array<String>] названия столбцов без столбца нумерации
|
|
99
|
+
def get_class_names
|
|
100
|
+
end
|
|
101
|
+
|
|
102
|
+
# Извлекает массив значений полей из одного элемента списка для строки таблицы.
|
|
103
|
+
#
|
|
104
|
+
# @abstract
|
|
105
|
+
# @param object [Object] элемент списка
|
|
106
|
+
# @return [Array<Object>] массив значений столбцов
|
|
107
|
+
def get_object_data(object)
|
|
108
|
+
end
|
|
109
|
+
end
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
require_relative 'data_list'
|
|
2
|
+
require_relative 'data_table'
|
|
3
|
+
|
|
4
|
+
# Конкретная реализация {DataList} для работы со списком объектов {StudentShort}.
|
|
5
|
+
# Реализует паттерн Наблюдатель (Observer) для оповещения представления об изменении данных.
|
|
6
|
+
class DataListStudentShort < DataList
|
|
7
|
+
# Инициализирует модель списка студентов и коллекцию наблюдателей.
|
|
8
|
+
#
|
|
9
|
+
# @param list [Array<StudentShort>] начальный список кратких моделей студентов
|
|
10
|
+
def initialize(list)
|
|
11
|
+
super
|
|
12
|
+
@observers = []
|
|
13
|
+
end
|
|
14
|
+
|
|
15
|
+
# Регистрирует объект представления в качестве наблюдателя за изменениями модели.
|
|
16
|
+
#
|
|
17
|
+
# @param view [StudentListView] объект представления, поддерживающий +set_table_params+ и +set_table_data+
|
|
18
|
+
# @return [Array<Object>] обновленный список наблюдателей
|
|
19
|
+
def observe(view)
|
|
20
|
+
@observers << view
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
# Уведомляет всех зарегистрированных наблюдателей об обновлении данных таблицы.
|
|
24
|
+
#
|
|
25
|
+
# @return [Array<Object>] список оповещённых наблюдателей
|
|
26
|
+
def notify
|
|
27
|
+
@observers.each do |observer|
|
|
28
|
+
observer.set_table_params(self.get_names, @list.size)
|
|
29
|
+
observer.set_table_data(self.get_data)
|
|
30
|
+
end
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
private
|
|
34
|
+
|
|
35
|
+
# Возвращает названия столбцов для таблицы студентов.
|
|
36
|
+
#
|
|
37
|
+
# @return [Array<String>] массив заголовков +["ФИО", "Контакты", "Гит"]+
|
|
38
|
+
def get_class_names
|
|
39
|
+
["ФИО", "Контакты", "Гит"]
|
|
40
|
+
end
|
|
41
|
+
|
|
42
|
+
# Извлекает отображаемые поля из объекта {StudentShort}.
|
|
43
|
+
#
|
|
44
|
+
# @param student [StudentShort] объект краткой информации о студенте
|
|
45
|
+
# @return [Array<String, nil>] массив значений +[last_name_initials, contact, git]+
|
|
46
|
+
def get_object_data(student)
|
|
47
|
+
[student.last_name_initials, student.contact, student.git]
|
|
48
|
+
end
|
|
49
|
+
|
|
50
|
+
# Проверяет, поддерживает ли элемент списка интерфейс {StudentShort}.
|
|
51
|
+
#
|
|
52
|
+
# @param list [Array<Object>] проверяемый список
|
|
53
|
+
# @return [Boolean] +true+, если первый элемент отвечает на +:last_name_initials+, +:contact+ и +:git+
|
|
54
|
+
def valid_class_names_list?(list)
|
|
55
|
+
object = list[0]
|
|
56
|
+
object.respond_to?(:last_name_initials) && object.respond_to?(:contact) && object.respond_to?(:git)
|
|
57
|
+
end
|
|
58
|
+
end
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Двумерная табличная структура данных для передачи содержимого ячеек в представление.
|
|
2
|
+
class DataTable
|
|
3
|
+
# Инициализирует таблицу на основе двумерного массива.
|
|
4
|
+
#
|
|
5
|
+
# @param table [Array<Array<Object>>] матрица значений ячеек
|
|
6
|
+
def initialize(table)
|
|
7
|
+
@table = table
|
|
8
|
+
end
|
|
9
|
+
|
|
10
|
+
# Возвращает значение ячейки по индексам строки и столбца.
|
|
11
|
+
#
|
|
12
|
+
# @param row [Integer] индекс строки (начиная с 0)
|
|
13
|
+
# @param column [Integer] индекс столбца (начиная с 0)
|
|
14
|
+
# @return [Object] значение ячейки
|
|
15
|
+
def element(row, column)
|
|
16
|
+
@table[row][column]
|
|
17
|
+
end
|
|
18
|
+
|
|
19
|
+
# Возвращает количество строк в таблице.
|
|
20
|
+
#
|
|
21
|
+
# @return [Integer] число строк
|
|
22
|
+
def rows()
|
|
23
|
+
@table.size
|
|
24
|
+
end
|
|
25
|
+
|
|
26
|
+
# Возвращает количество столбцов в таблице.
|
|
27
|
+
#
|
|
28
|
+
# @return [Integer] число столбцов
|
|
29
|
+
def columns()
|
|
30
|
+
@table[0].size
|
|
31
|
+
end
|
|
32
|
+
end
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
require 'pg'
|
|
2
|
+
require_relative '../domain/student.rb'
|
|
3
|
+
require_relative '../domain/student_short.rb'
|
|
4
|
+
|
|
5
|
+
# Класс доступа к данным (DAO) для выполнения CRUD-операций с таблицей +student+ в PostgreSQL.
|
|
6
|
+
class StudentList
|
|
7
|
+
# Устанавливает подключение к PostgreSQL и вычисляет следующий свободный идентификатор.
|
|
8
|
+
#
|
|
9
|
+
# @raise [RuntimeError] если не удалось подключиться к базе данных
|
|
10
|
+
def initialize
|
|
11
|
+
@conn = PG.connect(
|
|
12
|
+
dbname: 'postgres',
|
|
13
|
+
user: 'postgres',
|
|
14
|
+
password: '1234',
|
|
15
|
+
host: 'localhost',
|
|
16
|
+
port: '5432'
|
|
17
|
+
)
|
|
18
|
+
@next_id = get_next_id
|
|
19
|
+
rescue PG::Error
|
|
20
|
+
raise 'Не удалось подключиться к базе данных'
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
# Возвращает общее количество записей в таблице +student+.
|
|
24
|
+
#
|
|
25
|
+
# @return [Integer] количество студентов в БД
|
|
26
|
+
# @raise [RuntimeError] при ошибке соединения или выполнения SQL-запроса
|
|
27
|
+
def get_size
|
|
28
|
+
query = 'SELECT COUNT(*) FROM student'
|
|
29
|
+
result = execute_query(query)
|
|
30
|
+
result.getvalue(0, 0).to_i
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
# Вычисляет следующий идентификатор для вставки новой записи (+MAX(id) + 1+).
|
|
34
|
+
#
|
|
35
|
+
# @return [Integer] следующий свободный ID
|
|
36
|
+
# @raise [RuntimeError] при ошибке соединения или выполнения SQL-запроса
|
|
37
|
+
def get_next_id
|
|
38
|
+
query = 'SELECT COALESCE(MAX(id), 0) + 1 FROM student'
|
|
39
|
+
result = execute_query(query)
|
|
40
|
+
result.getvalue(0, 0).to_i
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
# Возвращает полный объект {Student} по его уникальному идентификатору.
|
|
44
|
+
#
|
|
45
|
+
# @param id [Integer] идентификатор студента
|
|
46
|
+
# @return [Student] найденный объект студента
|
|
47
|
+
# @raise [RuntimeError] при ошибке выполнения SQL-запроса
|
|
48
|
+
def get_student_by_id(id)
|
|
49
|
+
query = 'SELECT * FROM student WHERE id = $1'
|
|
50
|
+
result = execute_params_query(query, [id])
|
|
51
|
+
|
|
52
|
+
Student.from_hash(result[0].transform_keys(&:to_sym))
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
# Возвращает постраничный список кратких представлений студентов {StudentShort}.
|
|
56
|
+
#
|
|
57
|
+
# @param k [Integer] номер страницы (начиная с 1)
|
|
58
|
+
# @param n [Integer] количество записей на одной странице
|
|
59
|
+
# @return [Array<StudentShort>] список студентов для указанной страницы
|
|
60
|
+
# @raise [RuntimeError] при ошибке выполнения SQL-запроса
|
|
61
|
+
def get_k_n_student_short_list(k, n)
|
|
62
|
+
query = 'SELECT * FROM student ORDER BY id ASC LIMIT $1 OFFSET $2'
|
|
63
|
+
result = execute_params_query(query, [n, n * (k - 1)])
|
|
64
|
+
list = []
|
|
65
|
+
result.each do |row|
|
|
66
|
+
row = row.transform_keys(&:to_sym)
|
|
67
|
+
student = Student.from_hash(row)
|
|
68
|
+
list << StudentShort.from_student(student)
|
|
69
|
+
end
|
|
70
|
+
|
|
71
|
+
list
|
|
72
|
+
end
|
|
73
|
+
|
|
74
|
+
# Добавляет нового студента в базу данных и увеличивает счётчик +@next_id+.
|
|
75
|
+
#
|
|
76
|
+
# @param student [Student] объект нового студента
|
|
77
|
+
# @return [Integer] обновленное значение +@next_id+
|
|
78
|
+
# @raise [RuntimeError] при нарушении уникальности контактов/Git или ошибке БД
|
|
79
|
+
def create_student(student)
|
|
80
|
+
params = [@next_id, student.first_name, student.last_name, student.patronymic, student.telegram, student.email, student.phone, student.git]
|
|
81
|
+
query = 'INSERT INTO student (id, first_name, last_name, patronymic, telegram, email, phone, git) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)'
|
|
82
|
+
execute_params_query(query, params)
|
|
83
|
+
@next_id += 1
|
|
84
|
+
end
|
|
85
|
+
|
|
86
|
+
# Обновляет данные существующего студента в БД по его +id+.
|
|
87
|
+
#
|
|
88
|
+
# @param student [Student] объект студента с обновлёнными полями и заполненным +id+
|
|
89
|
+
# @return [PG::Result] результат выполнения запроса
|
|
90
|
+
# @raise [RuntimeError] при нарушении уникальности или ошибке БД
|
|
91
|
+
def update_student_by_id(student)
|
|
92
|
+
params = [student.id, student.first_name, student.last_name, student.patronymic, student.telegram, student.email, student.phone, student.git]
|
|
93
|
+
query = 'UPDATE student SET first_name = $2, last_name = $3, patronymic = $4, telegram = $5, email = $6, phone = $7, git = $8 WHERE id = $1'
|
|
94
|
+
execute_params_query(query, params)
|
|
95
|
+
end
|
|
96
|
+
|
|
97
|
+
# Удаляет запись студента из БД по идентификатору.
|
|
98
|
+
#
|
|
99
|
+
# @param id [Integer] идентификатор удаляемого студента
|
|
100
|
+
# @return [PG::Result] результат выполнения запроса
|
|
101
|
+
# @raise [RuntimeError] при ошибке выполнения SQL-запроса
|
|
102
|
+
def delete_student_by_id(id)
|
|
103
|
+
query = 'DELETE FROM student WHERE id = $1'
|
|
104
|
+
execute_params_query(query, [id])
|
|
105
|
+
end
|
|
106
|
+
|
|
107
|
+
private
|
|
108
|
+
|
|
109
|
+
# Выполняет SQL-запрос без параметров с обработкой ошибок соединения.
|
|
110
|
+
#
|
|
111
|
+
# @param query [String] текст SQL-запроса
|
|
112
|
+
# @return [PG::Result] результат запроса
|
|
113
|
+
# @raise [RuntimeError] при обрыве соединения или синтаксической/логической ошибке SQL
|
|
114
|
+
def execute_query(query)
|
|
115
|
+
@conn.exec(query)
|
|
116
|
+
rescue PG::ConnectionBad
|
|
117
|
+
raise 'Соединение с базой данных прервано'
|
|
118
|
+
rescue PG::Error => e
|
|
119
|
+
raise "Ошибка выполнения SQL-запроса: #{e.message}"
|
|
120
|
+
end
|
|
121
|
+
|
|
122
|
+
# Выполняет параметризованный SQL-запрос с обработкой ограничений уникальности.
|
|
123
|
+
#
|
|
124
|
+
# @param query [String] текст SQL-запроса с плейсхолдерами +$1, $2, ...+
|
|
125
|
+
# @param params [Array<Object>] массив параметров запроса
|
|
126
|
+
# @return [PG::Result] результат запроса
|
|
127
|
+
# @raise [RuntimeError] при разрыве соединения, нарушении уникальности или иной ошибке PostgreSQL
|
|
128
|
+
def execute_params_query(query, params)
|
|
129
|
+
@conn.exec_params(query, params)
|
|
130
|
+
rescue PG::ConnectionBad
|
|
131
|
+
raise 'Соединение с базой данных прервано'
|
|
132
|
+
rescue PG::UniqueViolation => e
|
|
133
|
+
constraint_name = e.result.error_field(PG::PG_DIAG_CONSTRAINT_NAME)
|
|
134
|
+
raise "Такой #{constraint_name} уже существует"
|
|
135
|
+
rescue PG::Error => e
|
|
136
|
+
raise "Ошибка выполнения SQL-запроса: #{e.message}"
|
|
137
|
+
end
|
|
138
|
+
end
|