ParseRelation.js 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205
  1. "use strict";
  2. var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
  3. Object.defineProperty(exports, "__esModule", {
  4. value: true
  5. });
  6. exports.default = void 0;
  7. var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
  8. var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
  9. var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
  10. var _ParseOp = require("./ParseOp");
  11. var _ParseObject = _interopRequireDefault(require("./ParseObject"));
  12. var _ParseQuery = _interopRequireDefault(require("./ParseQuery"));
  13. /**
  14. * Copyright (c) 2015-present, Parse, LLC.
  15. * All rights reserved.
  16. *
  17. * This source code is licensed under the BSD-style license found in the
  18. * LICENSE file in the root directory of this source tree. An additional grant
  19. * of patent rights can be found in the PATENTS file in the same directory.
  20. *
  21. * @flow
  22. */
  23. /**
  24. * Creates a new Relation for the given parent object and key. This
  25. * constructor should rarely be used directly, but rather created by
  26. * Parse.Object.relation.
  27. *
  28. * <p>
  29. * A class that is used to access all of the children of a many-to-many
  30. * relationship. Each instance of Parse.Relation is associated with a
  31. * particular parent object and key.
  32. * </p>
  33. * @alias Parse.Relation
  34. */
  35. var ParseRelation =
  36. /*#__PURE__*/
  37. function () {
  38. /**
  39. * @param {Parse.Object} parent The parent of this relation.
  40. * @param {String} key The key for this relation on the parent.
  41. */
  42. function ParseRelation(parent
  43. /*: ?ParseObject*/
  44. , key
  45. /*: ?string*/
  46. ) {
  47. (0, _classCallCheck2.default)(this, ParseRelation);
  48. (0, _defineProperty2.default)(this, "parent", void 0);
  49. (0, _defineProperty2.default)(this, "key", void 0);
  50. (0, _defineProperty2.default)(this, "targetClassName", void 0);
  51. this.parent = parent;
  52. this.key = key;
  53. this.targetClassName = null;
  54. }
  55. /*
  56. * Makes sure that this relation has the right parent and key.
  57. */
  58. (0, _createClass2.default)(ParseRelation, [{
  59. key: "_ensureParentAndKey",
  60. value: function (parent
  61. /*: ParseObject*/
  62. , key
  63. /*: string*/
  64. ) {
  65. this.key = this.key || key;
  66. if (this.key !== key) {
  67. throw new Error('Internal Error. Relation retrieved from two different keys.');
  68. }
  69. if (this.parent) {
  70. if (this.parent.className !== parent.className) {
  71. throw new Error('Internal Error. Relation retrieved from two different Objects.');
  72. }
  73. if (this.parent.id) {
  74. if (this.parent.id !== parent.id) {
  75. throw new Error('Internal Error. Relation retrieved from two different Objects.');
  76. }
  77. } else if (parent.id) {
  78. this.parent = parent;
  79. }
  80. } else {
  81. this.parent = parent;
  82. }
  83. }
  84. /**
  85. * Adds a Parse.Object or an array of Parse.Objects to the relation.
  86. * @param {} objects The item or items to add.
  87. */
  88. }, {
  89. key: "add",
  90. value: function (objects
  91. /*: ParseObject | Array<ParseObject | string>*/
  92. )
  93. /*: ParseObject*/
  94. {
  95. if (!Array.isArray(objects)) {
  96. objects = [objects];
  97. }
  98. var change = new _ParseOp.RelationOp(objects, []);
  99. var parent = this.parent;
  100. if (!parent) {
  101. throw new Error('Cannot add to a Relation without a parent');
  102. }
  103. parent.set(this.key, change);
  104. this.targetClassName = change._targetClassName;
  105. return parent;
  106. }
  107. /**
  108. * Removes a Parse.Object or an array of Parse.Objects from this relation.
  109. * @param {} objects The item or items to remove.
  110. */
  111. }, {
  112. key: "remove",
  113. value: function (objects
  114. /*: ParseObject | Array<ParseObject | string>*/
  115. ) {
  116. if (!Array.isArray(objects)) {
  117. objects = [objects];
  118. }
  119. var change = new _ParseOp.RelationOp([], objects);
  120. if (!this.parent) {
  121. throw new Error('Cannot remove from a Relation without a parent');
  122. }
  123. this.parent.set(this.key, change);
  124. this.targetClassName = change._targetClassName;
  125. }
  126. /**
  127. * Returns a JSON version of the object suitable for saving to disk.
  128. * @return {Object}
  129. */
  130. }, {
  131. key: "toJSON",
  132. value: function ()
  133. /*: { __type: 'Relation', className: ?string }*/
  134. {
  135. return {
  136. __type: 'Relation',
  137. className: this.targetClassName
  138. };
  139. }
  140. /**
  141. * Returns a Parse.Query that is limited to objects in this
  142. * relation.
  143. * @return {Parse.Query}
  144. */
  145. }, {
  146. key: "query",
  147. value: function query()
  148. /*: ParseQuery*/
  149. {
  150. var query;
  151. var parent = this.parent;
  152. if (!parent) {
  153. throw new Error('Cannot construct a query for a Relation without a parent');
  154. }
  155. if (!this.targetClassName) {
  156. query = new _ParseQuery.default(parent.className);
  157. query._extraOptions.redirectClassNameForKey = this.key;
  158. } else {
  159. query = new _ParseQuery.default(this.targetClassName);
  160. }
  161. query._addCondition('$relatedTo', 'object', {
  162. __type: 'Pointer',
  163. className: parent.className,
  164. objectId: parent.id
  165. });
  166. query._addCondition('$relatedTo', 'key', this.key);
  167. return query;
  168. }
  169. }]);
  170. return ParseRelation;
  171. }();
  172. var _default = ParseRelation;
  173. exports.default = _default;