Платформа службы сообщений

Платформа службы сообщений предоставляет другим системам унифицированный доступ к сообщениям. Она может обрабатывать непрочитанные, прочитанные сообщения и списки сообщений. Поддерживается отправка сообщений по электронной почте (с возможностью прикрепления файлов, которые должны быть доступны через интернет) или по SMS.

Подробности изменений можно найти в файлах SendEmailTask.java и SendSmsTask.java.

Кроме того, платформа службы сообщений поддерживает настройку правил для приёма личных сообщений пользователями из групп, включая настройку мобильных номеров и адресов электронной почты для получения сообщений отдельными пользователями в группах.

message-server: после загрузки исходного кода запустите службу message-server. Перед запуском службы необходимо создать базу данных (message), а затем выполнить файлы SQL-скриптов (message.sql и init.sql).

API HTML-версии: интерфейс HTML-диспетчера находится в папке index.html в каталоге api подкаталога main каталога webapp.

Системы и пользователи

Создание базы данных MySQL с именем message

Структура таблицы данных будет создана автоматически при запуске системы.

1. Необходимые данные для создания системы

Используйте интерфейс /sysInfo/saveOrUpdate. Параметры: * sysNo: код системы; * name: название системы. См. тестовый класс AccessUserTest.java.

2. Импорт информации о пользователях системы

Используйте интерфейс /userInfo/saveOrUpdate. Параметры: * sysNo: код системы; * userId: номер пользователя. См. тестовый класс AccessUserTest.java.

Группы сообщений

1. Добавление или изменение группы сообщений

Используйте интерфейс /msgGroup/saveOrUpdate. Параметры: * id: код группы; * sysNo: код системы; * name: имя группы; * type: тип [10 — система, 20 — личный, 30 — другое]; * pid: код родительской группы. См. тестовый класс MsgGroupTest.java.

2. Получение списка групп сообщений постранично

Используйте интерфейс /msgGroup/pageQuery. Параметры: * page: номер страницы; * size: размер страницы; * sysNo: код системы; * pid: код родительской группы (если требуется). См. тестовый класс MsgGroupTest.java.

Правила пользовательских групп

1. Добавление или изменение правила пользовательской группы

Используйте интерфейс /userGroupRule/saveOrUpdate. Параметры: * sysNo: код системы; * groupId: код группы; * userId: номер пользователя; * status: статус [10 — открыт, 20 — закрыт]; * emailStatus: отправка электронной почты [10 — открыта, 20 — закрыта]; * smsStatus: отправка SMS [10 — открыта, 20 — закрыта]. * recePhone: номера телефонов для уведомлений [несколько номеров через точку с запятой]; * receEmail: адреса электронной почты для уведомлений [несколько адресов через точку с запятой]. См. тестовый класс UserGroupRuleTest.java.

2. Получить набор правил пользовательских групп

Используйте интерфейс /userGroupRule/find. Параметры: * sysNo: код системы; * userId: номер пользователя. См. тестовый класс UserGroupRuleTest.java.

Операции с сообщениями

1. Отправка сообщений (поддерживает массовую рассылку нескольким получателям)

Используйте интерфейс /msgInfo/save. Параметры: * sysNo: код системы; * groupId: код группы сообщений [можно передать sys для обозначения системной группы сообщений]; * type: тип [10 — чтение, 20 — действие]; * title: заголовок; * content: содержание; * sendUserId: номер отправителя; * receUserIds: номера получателей [несколько номеров через точку с запятой] * receContent: содержимое для SMS или электронной почты (по умолчанию используется content, если не указано иное); * receEmailFiles: вложения для электронной почты [несколько вложений через точку с запятой]; * recePhones: номера телефонов [несколько номеров через точку с запятой], переключатель отправки определяется первым номером телефона; * receEmails: адреса электронной почты [несколько адресов через точку с запятой], переключатель отправки определяется первым адресом электронной почты. См. тестовый класс MsgSendTest.java.

2. Удаление сообщений и сообщений от определённых получателей

Используйте интерфейс /msgInfo/delete. Параметры: * id: номер сообщения. См. тестовый класс MsgInfoTest.java.

3. Удалить сообщения, полученные мной

Используйте интерфейс /msgInfo/deleteRece. Параметры: * id: номер сообщения; * sysNo: код системы; * userId: номер пользователя. См. тестовый класс MsgInfoTest.java.

4. Отметить сообщение как прочитанное

Используйте интерфейс /msgInfo/updateIsRead. Параметры: * id: номер сообщения; * sysNo: код системы; * userId: номер пользователя; * isRead: прочитано [0 — нет, 1 — да]. См. тестовый класс MsgInfoTest.java.

Запрос сообщений

1. Получить количество непрочитанных сообщений пользователя

Используйте интерфейс /msgInfo/getCountUnread. Параметры: * sysNo: код системы; * userId: номер пользователя; * type: тип [10 — чтение, 20 — действие]. См. тестовый класс MsgQueryTest.java.

2. Получить список непрочитанных сообщений пользователя постранично

Используйте интерфейс /msgInfo/pageQueryUnread. Параметры: * page: номер страницы; * size: размер страницы; * sysNo: код системы; * userId: номер пользователя; * groupId: коды групп сообщений, несколько кодов через точку с запятой; * type: тип [10 — чтение, 20 — действие]. См. тестовый класс MsgQueryTest.java.

3. Получить список сообщений пользователя постранично

Используйте интерфейс /msgInfo/pageQuery. Параметры: * page: номер страницы; * size: размер страницы; * sysNo: код системы; * userId: номер пользователя; * isRead: состояние чтения [0 — нет, 1 — да] (не передавать для получения всех статусов сообщений); * groupId: коды групп сообщений, несколько кодов через точку с запятой; * type: тип [10 — чтение, 20 — действие]. См. тестовый класс MsgQueryTest.java.

4. Получить список записей о непрочитанных сообщениях группы

Используйте интерфейс /msgInfo/findGroupUnread. Параметры: * sysNo: код системы; * userId: номер пользователя; * type: тип [10 — чтение, 20 — действие]. См. тестовый класс MsgQueryTest.java.

5. Получить подробную информацию о сообщении

Используйте интерфейс /msgInfo/getDtl. Параметры: * id: номер сообщения; * sysNo: код системы; * userId: номер пользователя. См. тестовый класс MsgQueryTest.java.

6. Получить список сообщений на основе расширенных полей

Используйте интерфейс /msgInfo/findByExt. Параметры: * sysNo: код системы; * ext1: расширение 1; * ext2: расширение 2; * ext3: расширение 3. См. тестовый класс MsgQueryTest.java.

Интерфейс администратора

Доступ к URL: http://127.0.0.1:6070/index.jsp. Логин: admin. Пароль: 123456.

Страница управления системой: изображение доступно по ссылке.

Страница управления сообщениями: изображение доступно по ссылке.