Request.cs 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389
  1. using System;
  2. using System.Collections.Generic;
  3. using System.IO;
  4. using System.Runtime.InteropServices.ComTypes;
  5. using InABox.Core;
  6. namespace InABox.Clients
  7. {
  8. public class Credentials
  9. {
  10. [Obsolete]
  11. public string? UserID { get; set; }
  12. [Obsolete]
  13. public string? Password { get; set; }
  14. public string Platform { get; set; }
  15. public string Version { get; set; }
  16. public Guid Session { get; set; }
  17. }
  18. public abstract class Request
  19. {
  20. public Request()
  21. {
  22. Credentials = new Credentials();
  23. }
  24. public static Action<Request>? BeforeRequest { get; set; }
  25. public Credentials Credentials { get; set; }
  26. public abstract RequestMethod GetMethod();
  27. }
  28. public enum StatusCode
  29. {
  30. OK,
  31. Incomplete,
  32. Error,
  33. Unauthenticated,
  34. BadServer
  35. }
  36. public enum RequestMethod
  37. {
  38. Info,
  39. Ping,
  40. Check2FA,
  41. Validate,
  42. MultiQuery,
  43. MultiDelete,
  44. Delete,
  45. Save,
  46. MultiSave,
  47. Query,
  48. Notify
  49. }
  50. public abstract class Response
  51. {
  52. public Response()
  53. {
  54. Status = StatusCode.Incomplete;
  55. Messages = new List<string>();
  56. }
  57. public StatusCode Status { get; set; }
  58. public List<string> Messages { get; }
  59. public virtual void DeserializeBinary(BinaryReader reader)
  60. {
  61. Status = (StatusCode)Enum.ToObject(typeof(StatusCode), reader.ReadInt32());
  62. Messages.Clear();
  63. var nMessages = reader.ReadInt32();
  64. for (int i = 0; i < nMessages; ++i)
  65. {
  66. Messages.Add(reader.ReadString());
  67. }
  68. }
  69. public virtual void SerializeBinary(BinaryWriter writer)
  70. {
  71. writer.Write((int)Status);
  72. writer.Write(Messages.Count);
  73. foreach(var message in Messages)
  74. {
  75. writer.Write(message);
  76. }
  77. }
  78. }
  79. public abstract class BaseRequest<TEntity> : Request where TEntity : Entity, new()
  80. {
  81. }
  82. public abstract class BaseResponse<TEntity> : Response where TEntity : Entity, new()
  83. {
  84. }
  85. /*public class ListRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  86. {
  87. public Filter<TEntity>? Filter { get; set; }
  88. public Columns<TEntity>? Columns { get; set; }
  89. public SortOrder<TEntity>? Sort { get; set; }
  90. public override RequestMethod GetMethod() => RequestMethod.Query;
  91. }
  92. public class ListResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  93. {
  94. public IEnumerable<object[]> Data { get; set; }
  95. }*/
  96. public class QueryRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  97. {
  98. public Filter<TEntity>? Filter { get; set; }
  99. public Columns<TEntity>? Columns { get; set; }
  100. public SortOrder<TEntity>? Sort { get; set; }
  101. public override RequestMethod GetMethod() => RequestMethod.Query;
  102. }
  103. public class QueryResponse<TEntity> : BaseResponse<TEntity>, ISerializeBinary where TEntity : Entity, new()
  104. {
  105. public CoreTable? Items { get; set; }
  106. public override void DeserializeBinary(BinaryReader reader)
  107. {
  108. base.DeserializeBinary(reader);
  109. if (reader.ReadBoolean())
  110. {
  111. Items = new CoreTable();
  112. Items.DeserializeBinary(reader);
  113. }
  114. else
  115. {
  116. Items = null;
  117. }
  118. }
  119. public override void SerializeBinary(BinaryWriter writer)
  120. {
  121. base.SerializeBinary(writer);
  122. if(Items is null)
  123. {
  124. writer.Write(false);
  125. }
  126. else
  127. {
  128. writer.Write(true);
  129. Items.SerializeBinary(writer);
  130. }
  131. }
  132. }
  133. /*public class LoadRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  134. {
  135. public Filter<TEntity>? Filter { get; set; }
  136. public SortOrder<TEntity>? Sort { get; set; }
  137. }
  138. public class LoadResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  139. {
  140. public TEntity[] Items { get; set; }
  141. }*/
  142. public class MultiSaveRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  143. {
  144. public TEntity[] Items { get; set; }
  145. public string AuditNote { get; set; }
  146. [Obsolete("We don't like this; it should always be true.")]
  147. // Added 11/04/23 to address incompatibility, remove as soon as possible; the relevant code to update is in RestService; update assuming that ReturnOnlyChanged is always true.
  148. public bool ReturnOnlyChanged { get; set; } = false;
  149. public override RequestMethod GetMethod() => RequestMethod.MultiSave;
  150. }
  151. public class MultiSaveResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  152. {
  153. //public Guid[] IDs { get; set; }
  154. public TEntity[] Items { get; set; }
  155. public List<Dictionary<string, object?>> ChangedValues { get; set; } = new List<Dictionary<string, object?>>();
  156. }
  157. public class SaveRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  158. {
  159. public TEntity Item { get; set; }
  160. public string AuditNote { get; set; }
  161. public bool ReturnOnlyChanged { get; set; } = false;
  162. public override RequestMethod GetMethod() => RequestMethod.Save;
  163. }
  164. public class SaveResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  165. {
  166. //public Guid ID { get; set; }
  167. public TEntity Item { get; set; }
  168. public Dictionary<string, object?> ChangedValues { get; set; } = new Dictionary<string, object?>();
  169. }
  170. public class DeleteRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  171. {
  172. public TEntity Item { get; set; }
  173. public string AuditNote { get; set; }
  174. public override RequestMethod GetMethod() => RequestMethod.Delete;
  175. }
  176. public class DeleteResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  177. {
  178. }
  179. public class MultiDeleteRequest<TEntity> : BaseRequest<TEntity> where TEntity : Entity, new()
  180. {
  181. public TEntity[] Items { get; set; }
  182. public string AuditNote { get; set; }
  183. public override RequestMethod GetMethod() => RequestMethod.MultiDelete;
  184. }
  185. public class MultiDeleteResponse<TEntity> : BaseResponse<TEntity> where TEntity : Entity, new()
  186. {
  187. }
  188. public class MultiQueryRequest : Request
  189. {
  190. public Dictionary<string, string> TableTypes { get; set; }
  191. public Dictionary<string, string> Filters { get; set; }
  192. public Dictionary<string, string> Columns { get; set; }
  193. public Dictionary<string, string> Sorts { get; set; }
  194. public override RequestMethod GetMethod() => RequestMethod.MultiQuery;
  195. }
  196. public class MultiQueryResponse : Response, ISerializeBinary
  197. {
  198. public MultiQueryResponse()
  199. {
  200. Tables = new Dictionary<string, CoreTable>();
  201. }
  202. public Dictionary<string, CoreTable> Tables { get; set; }
  203. public override void DeserializeBinary(BinaryReader reader)
  204. {
  205. base.DeserializeBinary(reader);
  206. Tables.Clear();
  207. var nTables = reader.ReadInt32();
  208. for(int i = 0; i < nTables; ++i)
  209. {
  210. var name = reader.ReadString();
  211. var table = new CoreTable();
  212. table.DeserializeBinary(reader);
  213. Tables[name] = table;
  214. }
  215. }
  216. public override void SerializeBinary(BinaryWriter writer)
  217. {
  218. base.SerializeBinary(writer);
  219. writer.Write(Tables.Count);
  220. foreach(var (name, table) in Tables)
  221. {
  222. writer.Write(name);
  223. table.SerializeBinary(writer);
  224. }
  225. }
  226. }
  227. public enum ValidationResult
  228. {
  229. VALID,
  230. INVALID,
  231. REQUIRE_2FA,
  232. PASSWORD_EXPIRED
  233. }
  234. public class ValidateRequest : Request
  235. {
  236. public string? UserID { get; set; }
  237. public string? Password { get; set; }
  238. public string? PIN { get; set; }
  239. public bool UsePIN { get; set; }
  240. public override RequestMethod GetMethod() => RequestMethod.Validate;
  241. }
  242. public class ValidateResponse : Response
  243. {
  244. public ValidationResult ValidationResult { get; set; }
  245. public Guid UserGuid { get; set; }
  246. public string UserID { get; set; }
  247. public Guid SecurityID { get; set; }
  248. public Guid Session { get; set; }
  249. public string? Recipient2FA { get; set; }
  250. public DateTime PasswordExpiration { get; set; }
  251. }
  252. public class Check2FARequest : Request
  253. {
  254. public string Code { get; set; }
  255. public override RequestMethod GetMethod() => RequestMethod.Check2FA;
  256. }
  257. public class Check2FAResponse : Response
  258. {
  259. public bool Valid { get; set; }
  260. }
  261. public class PingRequest : Request
  262. {
  263. public override RequestMethod GetMethod() => RequestMethod.Ping;
  264. }
  265. public class PingResponse : Response { }
  266. public class InfoRequest : Request
  267. {
  268. public override RequestMethod GetMethod() => RequestMethod.Info;
  269. }
  270. public class DatabaseInfo
  271. {
  272. public string? ColorScheme { get; set; }
  273. public byte[]? Logo { get; set; }
  274. public string Version { get; set; }
  275. }
  276. public class InfoResponse : Response
  277. {
  278. public DatabaseInfo Info { get; set; }
  279. public InfoResponse() : base()
  280. {
  281. Info = new DatabaseInfo();
  282. }
  283. }
  284. public static class Extensions
  285. {
  286. public static T Status<T>(this T response, StatusCode status) where T : Response
  287. {
  288. response.Status = status;
  289. return response;
  290. }
  291. }
  292. public class RequestException : Exception
  293. {
  294. public StatusCode Status { get; set; }
  295. public RequestMethod Method { get; set; }
  296. public RequestException(string message, StatusCode status, Request request): base(message)
  297. {
  298. Status = status;
  299. Method = request.GetMethod();
  300. }
  301. }
  302. }