session.endpoint.js 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221
  1. /**
  2. * 会话接口。
  3. *
  4. * author: Sand
  5. * since: 12/15/2016
  6. */
  7. "use strict";
  8. let express = require('express');
  9. let router = express.Router();
  10. let http = require('http');
  11. let log = require('../../util/log.js');
  12. let ObjectUtil = require("../../util/object.util.js");
  13. let ControllerUtil = require('../../util/controller.util');
  14. let Sessions = require('../../models/sessions/sessions');
  15. let Participants = require('../../models/sessions/participants');
  16. const SESSION_TYPES = require('../../include/commons').SESSION_TYPES;
  17. const APIv2 = require('../../include/endpoints').APIv2;
  18. /**
  19. * 创建会话。对MUC会话而言,需要创建的是议题,如果是第一次创建议题,那应该附带创建会话,而不是直接创建会话。
  20. *
  21. * session_type:1表示MUC会话,2表示P2P,3表示群会话,4表示临时讨论组
  22. * users 讨论组包含的用户标示
  23. * sessionId 会话ID
  24. *
  25. * 请求URL: /sessions
  26. * 参数:
  27. * {
  28. * session_id: 会话ID,非必须,仅对群消息使用。
  29. * session_type: 会话类型,必须。
  30. * session_name: 会话名称,
  31. * participants: 此会话的成员列表,格式:["userId1:role", "userId2:role"],用户的ID及角色。
  32. * }
  33. */
  34. router.post("/", function (req, res) {
  35. let payload = req.body;
  36. let testing = ObjectUtil.fieldsCheck(payload, 'participants', 'session_name', 'session_type');
  37. if (!testing.pass) {
  38. throw testing.message;
  39. }
  40. let participants = payload.participants;
  41. let sessionName = payload.session_name;
  42. let sessionType = payload.session_type;
  43. let sessionId = null;
  44. if (payload.session_type == SESSION_TYPES.GROUP) {
  45. if(!payload.hasOwnProperty('session_id') && payload.session_id.trim().length > 0){
  46. throw {httpStatus: 406, message: 'Field "session_id" is necessary and cannot be empty for GROUP session.'};
  47. }
  48. sessionId = payload.session_id;
  49. }
  50. let sessions = new Sessions();
  51. ControllerUtil.regModelEventHandler(sessions, res);
  52. sessions.createSession(sessionId, sessionName, sessionType, participants);
  53. });
  54. /**
  55. * 获取会话列表
  56. *
  57. * 请求URL /sessions?user_id=3121&page=0&size=10
  58. */
  59. router.get("/", function (req, res) {
  60. let page = req.query.page;
  61. let size = req.query.size;
  62. let userId = req.query.user_id;
  63. if (!page) {
  64. throw {httpStatus: 406, message: 'Missing page.'};
  65. }
  66. if (!size) {
  67. throw {httpStatus: 406, message: 'Missing size.'};
  68. }
  69. if (!userId) {
  70. throw {httpStatus: 406, message: 'Missing user.'};
  71. }
  72. let sessions = new Sessions();
  73. ControllerUtil.regModelEventHandler(sessions, res);
  74. sessions.getUserSessions(userId, page, size);
  75. });
  76. /**
  77. * 发送消息
  78. *
  79. * 请求URL:
  80. * /sessions/:session_id/messages
  81. *
  82. * 消息体:
  83. * {
  84. * sender_id: bea851fc,
  85. * sender_name: 李毅,
  86. * content_type: 1,
  87. * content: 李医生,你好
  88. * }
  89. */
  90. router.post(APIv2.Sessions.Messages, function (req, res) {
  91. let payload = req.body;
  92. let testing = ObjectUtil.fieldsCheck(payload, "sender_id", "sender_name", "content_type", "content");
  93. if (!testing.pass) {
  94. throw {httpStatus: 406, message: testing.message}
  95. }
  96. let sessions = new Sessions();
  97. ControllerUtil.regModelEventHandler(sessions, res);
  98. payload.timestamp = new Date();
  99. sessions.saveMessageBySession(req.params.session_id, payload);
  100. });
  101. /**
  102. * 获取消息
  103. *
  104. * 请求URL:
  105. * /sessions/:session_id/messages?session_id=blabla&user_id=abc&start_message_id=100&end_message_id=20
  106. */
  107. router.get(APIv2.Sessions.Messages, function (req, res) {
  108. let page = req.query.page;
  109. let size = req.query.size;
  110. let user = req.query.user;
  111. let sessionId = req.query.sessionId;
  112. if (!page) {
  113. throw {httpStatus: 406, message: 'Missing page.'};
  114. }
  115. if (!size) {
  116. throw {httpStatus: 406, message: 'Missing size.'};
  117. }
  118. if (!user) {
  119. throw {httpStatus: 406, message: 'Missing user.'};
  120. }
  121. if (!sessionId) {
  122. throw {httpStatus: 406, message: 'Missing sessionId.'};
  123. }
  124. let sessions = new Sessions();
  125. ControllerUtil.regModelEventHandler(sessions, res);
  126. sessions.getMessages(sessionId, user, page, size);
  127. });
  128. /**
  129. * 某个聊天记录置顶操作
  130. *
  131. * 请求URL /stick?user=3121&sessionId=testsessionmsg1
  132. */
  133. router.post(APIv2.Sessions.SessionSticky, function (req, res) {
  134. let user = req.query.user;
  135. let sessionId = req.query.sessionId;
  136. if (!user) {
  137. throw {httpStatus: 406, message: 'Missing user.'};
  138. }
  139. if (!sessionId) {
  140. throw {httpStatus: 406, message: 'Missing sessionId.'};
  141. }
  142. let sessions = new Sessions();
  143. ControllerUtil.regModelEventHandler(sessions, res);
  144. sessions.stickSession(sessionId, user);
  145. });
  146. /**
  147. * 取消置顶
  148. * 请求URL /cancelStick?user=3121&sessionId=testsessionmsg1
  149. */
  150. router.delete(APIv2.Sessions.SessionSticky, function (req, res) {
  151. let user = req.query.user;
  152. let sessionId = req.query.sessionId;
  153. if (!user) {
  154. throw {httpStatus: 406, message: 'Missing user.'};
  155. }
  156. if (!sessionId) {
  157. throw {httpStatus: 406, message: 'Missing sessionId.'};
  158. }
  159. let sessions = new Sessions();
  160. ControllerUtil.regModelEventHandler(sessions, res);
  161. sessions.cancelStickSession(sessionId, user);
  162. });
  163. /**
  164. * 移除成员
  165. * user:移除的人员
  166. * sessionId 会话ID
  167. */
  168. router.delete(APIv2.Sessions.Participant, function (req, res) {
  169. let user = req.query.user;
  170. if (!user) {
  171. throw {httpStatus: 406, message: 'Missing user.'};
  172. }
  173. let sessionId = req.query.sessionId;
  174. if (!sessionId) {
  175. throw {httpStatus: 406, message: 'Missing sessionId.'};
  176. }
  177. let participants = new Participants();
  178. ControllerUtil.regModelEventHandler(sessions, res);
  179. participants.deleteUser(sessionId, user);
  180. });
  181. /**
  182. * 增加成员
  183. * user:移除的人员
  184. * sessionId 会话ID
  185. */
  186. router.put(APIv2.Sessions.Participant, function (req, res) {
  187. let user = req.query.user;
  188. if (!user) {
  189. throw {httpStatus: 406, message: 'Missing user.'};
  190. }
  191. let sessionId = req.query.sessionId;
  192. if (!sessionId) {
  193. throw {httpStatus: 406, message: 'Missing sessionId.'};
  194. }
  195. let participants = new Participants();
  196. ControllerUtil.regModelEventHandler(sessions, res);
  197. participants.pushUser(sessionId, user);
  198. });
  199. module.exports = router;