Column.cs 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733
  1. using System;
  2. using System.Collections;
  3. using System.Collections.Generic;
  4. using System.Diagnostics.CodeAnalysis;
  5. using System.Linq;
  6. using System.Linq.Expressions;
  7. using System.Reflection;
  8. using System.Runtime.CompilerServices;
  9. using System.Runtime.Serialization;
  10. using JetBrains.Annotations;
  11. using Newtonsoft.Json;
  12. using Newtonsoft.Json.Linq;
  13. namespace InABox.Core
  14. {
  15. public interface IColumn
  16. {
  17. string Property { get; }
  18. Type Type { get; }
  19. }
  20. public static class Column
  21. {
  22. public static IColumn Create(Type concrete, string property)
  23. {
  24. var type = typeof(Column<>).MakeGenericType(concrete);
  25. var result = Activator.CreateInstance(type, property) as IColumn;
  26. return result!;
  27. }
  28. }
  29. public class Column<T> : IColumn
  30. {
  31. private IProperty _property;
  32. public Type Type
  33. {
  34. get
  35. {
  36. if (Expression is null)
  37. throw new Exception($"Expression [{Property}] may not be null");
  38. if (Expression is IndexExpression)
  39. return DatabaseSchema.Property(typeof(T), Property).PropertyType;
  40. return Expression.Type;
  41. }
  42. }
  43. public string Property { get; private set; }
  44. public Expression Expression { get; private set; }
  45. public bool IsEqualTo(string name) =>
  46. !name.IsNullOrWhiteSpace() && Property.Equals(name);
  47. public bool IsEqualTo(Column<T> column) =>
  48. string.Equals(Property, column.Property);
  49. public bool IsParentOf(string name) =>
  50. !name.IsNullOrWhiteSpace() && name.StartsWith(Property + ".");
  51. public Column(IProperty property)
  52. {
  53. Property = property.Name;
  54. Expression = property.Expression();
  55. }
  56. public Column(Expression<Func<T, object?>> expression)
  57. {
  58. Property = CoreUtils.GetFullPropertyName(expression, ".");
  59. Expression = CoreUtils.ExtractMemberExpression(expression);
  60. }
  61. public Column(string property)
  62. {
  63. Property = property;
  64. var iprop = DatabaseSchema.Property(typeof(T), property);
  65. if (iprop != null)
  66. Expression = iprop.Expression();
  67. else
  68. Expression = CoreUtils.CreateMemberExpression(typeof(T), property);
  69. }
  70. public Column<TNew> Cast<TNew>()
  71. where TNew: T
  72. {
  73. return new Column<TNew>(Property);
  74. }
  75. public bool TryCast<TNew>([NotNullWhen(true)] out Column<TNew>? newColumn)
  76. {
  77. if(DatabaseSchema.Property(typeof(TNew), Property) is IProperty property)
  78. {
  79. newColumn = new Column<TNew>(property);
  80. return true;
  81. }
  82. else
  83. {
  84. newColumn = null;
  85. return false;
  86. }
  87. }
  88. public override string ToString() => Property;
  89. }
  90. public interface IColumns : ISerializeBinary
  91. {
  92. int Count { get; }
  93. IEnumerable<string> ColumnNames();
  94. bool Contains(string column);
  95. IColumns Add(string column);
  96. IColumns Add(IColumn column);
  97. IColumns Add<T>(Expression<Func<T, object?>> column);
  98. IColumns Add(IProperty property);
  99. IColumns Add(IEnumerable<string> columns);
  100. IColumns Add(params string[] columns);
  101. IEnumerator<IColumn> GetEnumerator();
  102. }
  103. [Flags]
  104. public enum ColumnTypeFlags
  105. {
  106. /// <summary>
  107. /// No columns at all.
  108. /// </summary>
  109. None = 0,
  110. /// <summary>
  111. /// All columns which are marked as <see cref="RequiredColumnAttribute"/>.
  112. /// </summary>
  113. Required = 1,
  114. /// <summary>
  115. /// All columns.
  116. /// </summary>
  117. All = 2,
  118. /// <summary>
  119. /// Only columns on the entity, and not on entity links or calculated fields.
  120. /// </summary>
  121. /// <remarks>
  122. /// This option <b>does</b> include foreign keys.
  123. /// </remarks>
  124. Local = 4,
  125. IncludeID = 8,
  126. IncludeForeignKeys = 16,
  127. /// <summary>
  128. /// Include all columns that are accessible through entity links present in the root class.
  129. /// </summary>
  130. IncludeLinked = 32,
  131. /// <summary>
  132. /// Include all columns that are accessible through entity links, even nested ones.
  133. /// </summary>
  134. IncludeNestedLinks = 64,
  135. IncludeAggregates = 128,
  136. IncludeFormulae = 256,
  137. /// <summary>
  138. /// Include any columns that are a <see cref="CustomProperty"/>.
  139. /// </summary>
  140. IncludeUserProperties = 512,
  141. IncludeEditable = 1024,
  142. /// <summary>
  143. /// Include all columns marked as <see cref="Visible.Optional"/>, <see cref="Visible.Default"/> (or that don't have a visibility).
  144. /// </summary>
  145. IncludeOptional = 2048,
  146. /// <summary>
  147. /// Include all columns marked as <see cref="Visible.Default"/> (or that don't have a visibility).
  148. /// </summary>
  149. IncludeVisible = 4096,
  150. DefaultVisible = IncludeVisible | IncludeID,
  151. EditorColumns = IncludeID | Required | IncludeOptional | IncludeForeignKeys | IncludeUserProperties | IncludeEditable,
  152. }
  153. public static class Columns
  154. {
  155. public static IColumns Create<T>(Type concrete, ColumnTypeFlags flags)
  156. {
  157. if (!typeof(T).IsAssignableFrom(concrete))
  158. throw new Exception($"Columns: {concrete.EntityName()} does not implement {typeof(T).EntityName()}");
  159. var type = typeof(Columns<>).MakeGenericType(concrete);
  160. var result = Activator.CreateInstance(type, flags);
  161. return (result as IColumns)!;
  162. }
  163. public static IColumns Create(Type concrete, ColumnTypeFlags flags)
  164. {
  165. var type = typeof(Columns<>).MakeGenericType(concrete);
  166. var result = Activator.CreateInstance(type, flags) as IColumns;
  167. return result!;
  168. }
  169. /// <summary>
  170. /// Create a new <see cref="IColumns"/> that is completely empty.
  171. /// </summary>
  172. public static IColumns None(Type T) => Create(T, ColumnTypeFlags.None);
  173. /// <summary>
  174. /// Create a new <see cref="IColumns"/> with all columns of <paramref name="T"/> that are marked as <see cref="RequiredColumnAttribute"/>.
  175. /// </summary>
  176. public static IColumns Required(Type T) => Create(T, ColumnTypeFlags.Required);
  177. /// <summary>
  178. /// Create a new <see cref="IColumns"/> with all columns local to the entity, and not on entity links or calculated fields.
  179. /// </summary>
  180. public static IColumns Local(Type T) => Create(T, ColumnTypeFlags.Local);
  181. /// <summary>
  182. /// Create a new <see cref="IColumns"/> with all columns that the entity has.
  183. /// </summary>
  184. public static IColumns All(Type T) => Create(T, ColumnTypeFlags.All);
  185. /// <summary>
  186. /// Create a new <see cref="IColumns"/> that is completely empty.
  187. /// </summary>
  188. public static Columns<T> None<T>()
  189. {
  190. return new Columns<T>(ColumnTypeFlags.None);
  191. }
  192. /// <summary>
  193. /// Create a new <see cref="IColumns"/> with all columns of <paramref name="T"/> that are marked as <see cref="RequiredColumnAttribute"/>.
  194. /// </summary>
  195. public static Columns<T> Required<T>()
  196. {
  197. return new Columns<T>(ColumnTypeFlags.Required);
  198. }
  199. /// <summary>
  200. /// Create a new <see cref="IColumns"/> with all columns local to the entity, and not on entity links or calculated fields.
  201. /// </summary>
  202. public static Columns<T> Local<T>()
  203. {
  204. return new Columns<T>(ColumnTypeFlags.Local);
  205. }
  206. /// <summary>
  207. /// Create a new <see cref="IColumns"/> with all columns that the entity has.
  208. /// </summary>
  209. public static Columns<T> All<T>()
  210. {
  211. return new Columns<T>(ColumnTypeFlags.All);
  212. }
  213. }
  214. public class Columns<T> : IColumns, ICollection<Column<T>>
  215. {
  216. #region Private Fields
  217. private readonly List<Column<T>> columns;
  218. #endregion
  219. #region Public Accessors
  220. public Column<T> this[int index] => columns[index];
  221. public int Count => columns.Count;
  222. bool ICollection<Column<T>>.IsReadOnly => false;
  223. #endregion
  224. private Columns()
  225. {
  226. columns = new List<Column<T>>();
  227. }
  228. public Columns(ColumnTypeFlags flags)
  229. {
  230. columns = new List<Column<T>>();
  231. AddColumns(flags);
  232. }
  233. public Columns<T> AddColumns(ColumnTypeFlags flags)
  234. {
  235. if (flags == ColumnTypeFlags.None)
  236. return this;
  237. var props = DatabaseSchema.Properties(typeof(T))
  238. .Where(x => x.Setter() != null)
  239. .OrderBy(x => x.PropertySequence()).ToList();
  240. if (flags.HasFlag(ColumnTypeFlags.All))
  241. {
  242. foreach (var prop in props)
  243. columns.Add(new Column<T>(prop.Name));
  244. return this;
  245. }
  246. if (typeof(T).IsSubclassOf(typeof(Entity)) && flags.HasFlag(ColumnTypeFlags.IncludeID))
  247. columns.Add(new Column<T>(nameof(Entity.ID)));
  248. foreach(var prop in props)
  249. {
  250. if (flags.HasFlag(ColumnTypeFlags.Required) && prop.Required)
  251. {
  252. columns.Add(new Column<T>(prop));
  253. }
  254. else
  255. {
  256. var isLocal = !prop.HasParentEntityLink()
  257. || (prop.Parent?.HasParentEntityLink() != true && prop.Name.EndsWith(".ID"));
  258. if (flags.HasFlag(ColumnTypeFlags.Local) && isLocal && !prop.IsCalculated)
  259. {
  260. columns.Add(new Column<T>(prop));
  261. }
  262. else if(prop is CustomProperty)
  263. {
  264. if (flags.HasFlag(ColumnTypeFlags.IncludeUserProperties))
  265. {
  266. columns.Add(new Column<T>(prop));
  267. }
  268. else
  269. {
  270. // Don't add
  271. }
  272. }
  273. else
  274. {
  275. var parentLink = prop.HasParentEntityLink();
  276. var failed = false;
  277. if(prop.HasParentEntityLink())
  278. {
  279. if(prop.Parent?.HasParentEntityLink() == true && !flags.HasFlag(ColumnTypeFlags.IncludeNestedLinks))
  280. {
  281. failed = true;
  282. }
  283. else if(!prop.Name.EndsWith(".ID") && !flags.HasFlag(ColumnTypeFlags.IncludeLinked))
  284. {
  285. failed = true;
  286. }
  287. else if(prop.Name.EndsWith(".ID") && !flags.HasFlag(ColumnTypeFlags.IncludeForeignKeys))
  288. {
  289. failed = true;
  290. }
  291. }
  292. if (!failed)
  293. {
  294. var hasNullEditor = prop.GetParent(x => x.HasEditor && x.Editor is NullEditor) != null;
  295. var visible = hasNullEditor ? Visible.Hidden : (prop.Editor?.Visible ?? Visible.Optional);
  296. var editable = hasNullEditor ? Editable.Hidden : (prop.Editor?.Editable ?? Editable.Enabled);
  297. failed = (!flags.HasFlag(ColumnTypeFlags.IncludeVisible) || visible != Visible.Default)
  298. && (!flags.HasFlag(ColumnTypeFlags.IncludeOptional) || (visible != Visible.Optional && visible != Visible.Default))
  299. && (!flags.HasFlag(ColumnTypeFlags.IncludeEditable) || !editable.ColumnVisible());
  300. }
  301. if (!failed)
  302. {
  303. failed = (!flags.HasFlag(ColumnTypeFlags.IncludeAggregates) && prop.HasAttribute<AggregateAttribute>())
  304. || (!flags.HasFlag(ColumnTypeFlags.IncludeFormulae) && prop.HasAttribute<FormulaAttribute>());
  305. }
  306. if (!failed)
  307. {
  308. columns.Add(new Column<T>(prop));
  309. }
  310. }
  311. }
  312. }
  313. return this;
  314. }
  315. #region IColumns
  316. IColumns IColumns.Add(string column) => Add(column);
  317. IColumns IColumns.Add<TEntity>(Expression<Func<TEntity, object?>> expression)
  318. {
  319. return Add(CoreUtils.GetFullPropertyName(expression, "."));
  320. }
  321. public IColumns Add(IColumn column)
  322. {
  323. if (column is Column<T> col)
  324. return Add(col);
  325. return this;
  326. }
  327. IColumns IColumns.Add(IProperty property) => Add(property);
  328. IColumns IColumns.Add(params string[] columnnames) => Add(columnnames);
  329. IColumns IColumns.Add(IEnumerable<string> columnnames) => Add(columnnames);
  330. #endregion
  331. #region Add
  332. private Columns<T> Add(string column)
  333. {
  334. if (!Contains(column))
  335. {
  336. var property = DatabaseSchema.Property(typeof(T), column);
  337. if(property is null)
  338. {
  339. Logger.Send(LogType.Error, "", $"Property {column} does not exist on {typeof(T).Name}");
  340. }
  341. else
  342. {
  343. columns.Add(new Column<T>(property));
  344. }
  345. }
  346. return this;
  347. }
  348. public Columns<T> Add(Column<T> column)
  349. {
  350. if(!Contains(column.Property))
  351. {
  352. columns.Add(column);
  353. }
  354. return this;
  355. }
  356. public Columns<T> Add(IProperty property)
  357. {
  358. if (!Contains(property.Name))
  359. {
  360. columns.Add(new Column<T>(property));
  361. }
  362. return this;
  363. }
  364. public Columns<T> Add(Expression<Func<T, object?>> expression)
  365. => Add(CoreUtils.GetFullPropertyName(expression, "."));
  366. public Columns<T> Add<TType>(Expression<Func<T, TType>> expression)
  367. => Add(CoreUtils.GetFullPropertyName(expression, "."));
  368. #region Range Adds
  369. public Columns<T> AddSubColumns<TSub>(Expression<Func<T, TSub>> super, Columns<TSub>? sub)
  370. {
  371. sub ??= CoreUtils.GetColumns(sub);
  372. var prefix = CoreUtils.GetFullPropertyName(super, ".") + ".";
  373. foreach(var column in sub.ColumnNames())
  374. {
  375. columns.Add(new Column<T>(prefix + column));
  376. }
  377. return this;
  378. }
  379. public Columns<T> Add(IEnumerable<Column<T>> columns)
  380. {
  381. foreach(var col in columns)
  382. {
  383. Add(col);
  384. }
  385. return this;
  386. }
  387. public Columns<T> Add(params string[] columnnames)
  388. {
  389. foreach (var name in columnnames)
  390. Add(name);
  391. return this;
  392. }
  393. public Columns<T> Add(IEnumerable<string> columnnames)
  394. {
  395. foreach (var name in columnnames)
  396. Add(name);
  397. return this;
  398. }
  399. public Columns<T> Add(params Expression<Func<T, object?>>[] expressions)
  400. {
  401. foreach (var expression in expressions)
  402. columns.Add(new Column<T>(expression));
  403. return this;
  404. }
  405. /// <summary>
  406. /// Add a range of columns, <b>without</b> checking for duplicates.
  407. /// </summary>
  408. /// <param name="columns"></param>
  409. /// <returns></returns>
  410. public Columns<T> AddRange(IEnumerable<Column<T>> columns)
  411. {
  412. this.columns.AddRange(columns);
  413. return this;
  414. }
  415. #endregion
  416. #endregion
  417. #region Remove
  418. public Columns<T> Remove(string column)
  419. {
  420. columns.RemoveAll(x => x.Property == column);
  421. return this;
  422. }
  423. #endregion
  424. #region Casting Columns Type
  425. public Columns<TNew> Cast<TNew>()
  426. where TNew : T
  427. {
  428. var cols = Columns.None<TNew>();
  429. foreach(var column in columns)
  430. {
  431. cols.Add(column.Cast<TNew>());
  432. }
  433. return cols;
  434. }
  435. /// <summary>
  436. /// Cast the columns to <typeparamref name="TNew"/>, keeping the columns that are found in both <typeparamref name="T"/> and <typeparamref name="TNew"/>.
  437. /// </summary>
  438. /// <typeparam name="TNew"></typeparam>
  439. /// <returns></returns>
  440. public Columns<TNew> CastIntersection<TNew>()
  441. {
  442. var cols = Columns.None<TNew>();
  443. foreach(var column in columns)
  444. {
  445. if (column.TryCast<TNew>(out var newColumn))
  446. {
  447. cols.Add(newColumn);
  448. }
  449. }
  450. return cols;
  451. }
  452. #endregion
  453. public override string ToString()
  454. {
  455. return string.Join("; ", columns.Select(x => x.Property));
  456. }
  457. public int IndexOf(Expression<Func<T, object>> expression)
  458. {
  459. var columnName = CoreUtils.GetFullPropertyName(expression, ".");
  460. for(int i = 0; i < columns.Count; ++i)
  461. {
  462. if (columns[i].Property == columnName)
  463. {
  464. return i;
  465. }
  466. }
  467. return -1;
  468. }
  469. public bool Contains(string column) => columns.Any(x => x.IsEqualTo(column));
  470. public IEnumerable<string> ColumnNames()
  471. {
  472. return columns.Select(c => c.Property);
  473. }
  474. #region Binary Serialization
  475. public void SerializeBinary(CoreBinaryWriter writer)
  476. {
  477. writer.Write(columns.Count);
  478. foreach(var column in columns)
  479. {
  480. writer.Write(column.Property);
  481. }
  482. }
  483. public void DeserializeBinary(CoreBinaryReader reader)
  484. {
  485. columns.Clear();
  486. var nColumns = reader.ReadInt32();
  487. for(int i = 0; i < nColumns; ++i)
  488. {
  489. var property = reader.ReadString();
  490. columns.Add(new Column<T>(property));
  491. }
  492. }
  493. #endregion
  494. #region ICollection
  495. public IEnumerator<Column<T>> GetEnumerator()
  496. {
  497. return columns.GetEnumerator();
  498. }
  499. IEnumerator<IColumn> IColumns.GetEnumerator() => GetEnumerator();
  500. IEnumerator IEnumerable.GetEnumerator()
  501. {
  502. return columns.GetEnumerator();
  503. }
  504. void ICollection<Column<T>>.Add(Column<T> item)
  505. {
  506. Add(item);
  507. }
  508. void ICollection<Column<T>>.Clear()
  509. {
  510. columns.Clear();
  511. }
  512. bool ICollection<Column<T>>.Contains(Column<T> item)
  513. {
  514. return Contains(item.Property);
  515. }
  516. void ICollection<Column<T>>.CopyTo(Column<T>[] array, int arrayIndex)
  517. {
  518. columns.CopyTo(array, arrayIndex);
  519. }
  520. bool ICollection<Column<T>>.Remove(Column<T> item)
  521. {
  522. return columns.RemoveAll(x => x.Property == item.Property) > 0;
  523. }
  524. #endregion
  525. }
  526. public static class ColumnsExtensions
  527. {
  528. public static Columns<T> ToColumns<T>(this IEnumerable<Column<T>> columns, ColumnTypeFlags flags)
  529. {
  530. return new Columns<T>(flags).AddRange(columns);
  531. }
  532. }
  533. public static class ColumnSerialization
  534. {
  535. /// <summary>
  536. /// Inverse of <see cref="Write{T}(CoreBinaryWriter, Columns{T}?)"/>.
  537. /// </summary>
  538. /// <param name="reader"></param>
  539. /// <returns></returns>
  540. public static Columns<T>? ReadColumns<T>(this CoreBinaryReader reader)
  541. {
  542. if (reader.ReadBoolean())
  543. {
  544. var columns = Columns.None<T>();
  545. columns.DeserializeBinary(reader);
  546. return columns;
  547. }
  548. return null;
  549. }
  550. /// <summary>
  551. /// Inverse of <see cref="ReadColumns{T}(CoreBinaryReader)"/>.
  552. /// </summary>
  553. /// <param name="filter"></param>
  554. /// <param name="writer"></param>
  555. public static void Write<T>(this CoreBinaryWriter writer, Columns<T>? columns)
  556. {
  557. if (columns is null)
  558. {
  559. writer.Write(false);
  560. }
  561. else
  562. {
  563. writer.Write(true);
  564. columns.SerializeBinary(writer);
  565. }
  566. }
  567. }
  568. public class ColumnJsonConverter : JsonConverter
  569. {
  570. public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
  571. {
  572. if(value is null)
  573. {
  574. writer.WriteNull();
  575. return;
  576. }
  577. var property = (CoreUtils.GetPropertyValue(value, "Expression") as Expression)
  578. ?? throw new Exception("'Column.Expression' may not be null");
  579. var prop = CoreUtils.ExpressionToString(value.GetType().GenericTypeArguments[0], property, true);
  580. var name = CoreUtils.GetPropertyValue(value, "Property") as string;
  581. writer.WriteStartObject();
  582. writer.WritePropertyName("$type");
  583. writer.WriteValue(value.GetType().FullName);
  584. writer.WritePropertyName("Expression");
  585. writer.WriteValue(prop);
  586. writer.WritePropertyName("Property");
  587. writer.WriteValue(name);
  588. writer.WriteEndObject();
  589. }
  590. public override object? ReadJson(JsonReader reader, Type objectType, object? existingValue, JsonSerializer serializer)
  591. {
  592. if (reader.TokenType == JsonToken.Null)
  593. return null;
  594. var data = new Dictionary<string, object>();
  595. while (reader.TokenType != JsonToken.EndObject && reader.Read())
  596. if (reader.Value != null)
  597. {
  598. var key = reader.Value.ToString();
  599. reader.Read();
  600. if (String.Equals(key, "$type"))
  601. objectType = Type.GetType(reader.Value.ToString()) ?? objectType;
  602. else
  603. data[key] = reader.Value;
  604. }
  605. var prop = data["Property"].ToString();
  606. var result = Activator.CreateInstance(objectType, prop);
  607. return result;
  608. }
  609. public override bool CanConvert(Type objectType)
  610. {
  611. if (objectType.IsConstructedGenericType)
  612. {
  613. var ot = objectType.GetGenericTypeDefinition();
  614. var tt = typeof(Column<>);
  615. if (ot == tt)
  616. return true;
  617. }
  618. return false;
  619. }
  620. }
  621. }