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.
@@ -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