entityManager.ts 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405
  1. import ApiRequestService from "./apiRequestService"
  2. import {Repository} from "pinia-orm"
  3. import UrlUtils from "~/services/utils/urlUtils"
  4. import HydraDenormalizer from "./normalizer/hydraDenormalizer"
  5. import ApiModel from "~/models/ApiModel"
  6. import ApiResource from "~/models/ApiResource"
  7. import MyProfile from "~/models/Access/MyProfile"
  8. import {v4 as uuid4} from 'uuid'
  9. import {AssociativeArray, Collection} from "~/types/data.d"
  10. import models from "~/models/models";
  11. import {useAccessProfileStore} from "~/stores/accessProfile"
  12. import _ from "lodash"
  13. /**
  14. * Entity manager: make operations on the models defined with the Pinia-Orm library
  15. *
  16. * @see https://pinia-orm.codedredd.de/
  17. */
  18. class EntityManager {
  19. protected CLONE_PREFIX = '_clone_'
  20. /**
  21. * In instance of ApiRequestService
  22. * @protected
  23. */
  24. protected apiRequestService: ApiRequestService
  25. /**
  26. * A method to retrieve the repository of a given ApiResource
  27. * @protected
  28. */
  29. protected _getRepo: (model: typeof ApiResource) => Repository<ApiResource>
  30. public constructor(
  31. apiRequestService: ApiRequestService,
  32. getRepo: (model: typeof ApiResource) => Repository<ApiResource>
  33. ) {
  34. this.apiRequestService = apiRequestService
  35. this._getRepo = getRepo
  36. }
  37. /**
  38. * Return the repository for the model
  39. *
  40. * @param model
  41. */
  42. public getRepository(model: typeof ApiResource): Repository<ApiResource> {
  43. return this._getRepo(model)
  44. }
  45. /**
  46. * Cast an object as an ApiResource
  47. * This in used internally to ensure the object is recognized as an ApiResource
  48. *
  49. * @param model
  50. * @param instance
  51. * @protected
  52. */
  53. // noinspection JSMethodCanBeStatic
  54. protected cast(model: typeof ApiResource, instance: ApiResource): ApiResource {
  55. return new model(instance)
  56. }
  57. /**
  58. * Return the model class with the given entity name
  59. *
  60. * @param entityName
  61. */
  62. public getModelFor(entityName: string): typeof ApiResource {
  63. return models[entityName]
  64. }
  65. /**
  66. * Return the model class from an Opentalent Api IRI
  67. *
  68. * @param iri An IRI of the form .../api/<entity>/...
  69. */
  70. public getModelFromIri(iri: string): typeof ApiResource {
  71. const matches = iri.match(/^\/api\/(\w+)\/.*/)
  72. if (!matches || !matches[1]) {
  73. throw new Error('cannot parse the IRI')
  74. }
  75. return this.getModelFor(matches[1])
  76. }
  77. /**
  78. * Create a new instance of the given model
  79. *
  80. * @param model
  81. * @param properties
  82. */
  83. public newInstance(model: typeof ApiResource, properties: object = {}): ApiResource {
  84. const repository = this.getRepository(model)
  85. let instance = repository.make(properties)
  86. // Keep track of the model
  87. // TODO : attendre de voir si utile ou non
  88. // instance.setModel(model)
  89. // @ts-ignore
  90. if (!properties.hasOwnProperty('id') || !properties.id) {
  91. // Object has no id yet, we give him a temporary one
  92. instance.id = 'tmp' + uuid4()
  93. }
  94. return this.save(model, instance, true)
  95. }
  96. /**
  97. * Save the model instance into the store
  98. *
  99. * @param model
  100. * @param instance
  101. * @param permanent Is the change already persisted in the datasource? If this is the case, the initial state of this
  102. * record is also updated.
  103. */
  104. public save(model: typeof ApiResource, instance: ApiResource, permanent: boolean = false): ApiResource {
  105. if (permanent) {
  106. this.saveInitialState(model, instance)
  107. }
  108. return this.getRepository(model).save(instance)
  109. }
  110. /**
  111. * Find the model instance in the store
  112. * TODO: comment réagit la fonction si l'id n'existe pas?
  113. *
  114. * @param model
  115. * @param id
  116. */
  117. // @ts-ignore
  118. public find<T extends ApiResource>(model: typeof T, id: number): T {
  119. const repository = this.getRepository(model)
  120. return repository.find(id) as T
  121. }
  122. /**
  123. * Fetch an ApiModel / ApiResource by its id, save it to the store and returns it
  124. *
  125. * @param model Model of the object to fetch
  126. * @param id Id of the object to fetch
  127. * @param forceRefresh Force a new get request to the api ;
  128. * current object in store will be overwritten if it exists
  129. */
  130. public async fetch(model: typeof ApiResource, id: number, forceRefresh: boolean = false): Promise<ApiResource> {
  131. // If the model instance is already in the store and forceRefresh is false, return the object in store
  132. if (!forceRefresh) {
  133. const item = this.find(model, id)
  134. if (item && typeof item !== 'undefined') {
  135. return item
  136. }
  137. }
  138. // Else, get the object from the API
  139. const url = UrlUtils.join('api', model.entity, String(id))
  140. const response = await this.apiRequestService.get(url)
  141. // deserialize the response
  142. const attributes = HydraDenormalizer.denormalize(response).data as object
  143. return this.newInstance(model, attributes)
  144. }
  145. /**
  146. * Fetch a collection of model instances
  147. * The content of `query` is converted into a query-string in the request URL
  148. *
  149. * @param model
  150. * @param query
  151. * @param parent
  152. */
  153. public async fetchCollection(model: typeof ApiResource, parent: ApiResource | null, query: AssociativeArray = []): Promise<Collection> {
  154. let url
  155. if (parent !== null) {
  156. url = UrlUtils.join('api', parent.entity, '' + parent.id, model.entity)
  157. } else {
  158. url = UrlUtils.join('api', model.entity)
  159. }
  160. const response = await this.apiRequestService.get(url, query)
  161. // deserialize the response
  162. const apiCollection = HydraDenormalizer.denormalize(response)
  163. const items = apiCollection.data.map((attributes: object) => {
  164. return this.newInstance(model, attributes)
  165. })
  166. return {
  167. items,
  168. totalItems: apiCollection.metadata.totalItems,
  169. pagination: {
  170. first: apiCollection.metadata.firstPage || 1,
  171. last: apiCollection.metadata.lastPage || 1,
  172. next: apiCollection.metadata.nextPage || undefined,
  173. previous: apiCollection.metadata.previousPage || undefined,
  174. }
  175. }
  176. }
  177. /**
  178. * Persist the model instance as it is in the store into the data source via the API
  179. *
  180. * @param model
  181. * @param instance
  182. */
  183. public async persist(model: typeof ApiModel, instance: ApiModel) {
  184. // Recast in case class definition has been "lost"
  185. // TODO: attendre de voir si cette ligne est nécessaire
  186. // instance = this.cast(model, instance)
  187. let url = UrlUtils.join('api', model.entity)
  188. let response
  189. const data: any = instance.$toJson()
  190. if (!instance.isNew()) {
  191. url = UrlUtils.join(url, String(instance.id))
  192. response = await this.apiRequestService.put(url, data)
  193. } else {
  194. delete data.id
  195. response = await this.apiRequestService.post(url, data)
  196. }
  197. const hydraResponse = await HydraDenormalizer.denormalize(response)
  198. const newInstance = this.newInstance(model, hydraResponse.data)
  199. // Si l'instance était nouvelle avant d'être persistée, elle vient désormais de recevoir un id définitif. On
  200. // peut donc supprimer l'instance temporaire.
  201. if (instance.isNew()) {
  202. this.removeTempAfterPersist(model, instance.id)
  203. }
  204. return newInstance
  205. }
  206. /**
  207. * Send an update request (PUT) to the API with the given data on an existing model instance
  208. *
  209. * @param model
  210. * @param id
  211. * @param data
  212. */
  213. public async patch(model: typeof ApiModel, id: number, data: AssociativeArray) {
  214. let url = UrlUtils.join('api', model.entity, ''+id)
  215. const body = JSON.stringify(data)
  216. const response = await this.apiRequestService.put(url, body)
  217. const hydraResponse = await HydraDenormalizer.denormalize(response)
  218. return this.newInstance(model, hydraResponse.data)
  219. }
  220. /**
  221. * Delete the model instance from the datasource via the API
  222. *
  223. * @param model
  224. * @param instance
  225. */
  226. public async delete(model: typeof ApiModel, instance: ApiResource) {
  227. const repository = this.getRepository(model)
  228. // If object has been persisted to the datasource, send a delete request
  229. if (!instance.isNew()) {
  230. const url = UrlUtils.join('api', model.entity, String(instance.id))
  231. await this.apiRequestService.delete(url)
  232. }
  233. // reactiveUpdate the store
  234. repository.destroy(instance.id)
  235. }
  236. /**
  237. * Reset the model instance to its initial state (i.e. the state it had when it was fetched from the API)
  238. *
  239. * @param model
  240. * @param instance
  241. */
  242. public reset(model: typeof ApiResource, instance: ApiResource) {
  243. const initialInstance = this.getInitialStateOf(model, instance.id)
  244. if (initialInstance === null) {
  245. throw new Error('no initial state recorded for this object - abort [' + model.entity + '/' + instance.id + ']')
  246. }
  247. const repository = this.getRepository(model)
  248. repository.save(initialInstance)
  249. return initialInstance
  250. }
  251. /**
  252. * @todo: à déplacer dans le store directement
  253. * @Deprecated : a priori ce n'est pas le bon service pour mettre à jour le profil, on devrait voir ça
  254. * depuis un service dédié, un composable, ou directement dans le store ==> oui !
  255. *
  256. * Re-fetch the user profile and update the store
  257. */
  258. public async refreshProfile(accessId: number) {
  259. const profile = await this.fetch(MyProfile, accessId)
  260. // On met à jour le store accessProfile
  261. const accessProfile = useAccessProfileStore()
  262. accessProfile.setProfile(profile)
  263. }
  264. /**
  265. * Delete all records in the repository of the model
  266. *
  267. * @param model
  268. */
  269. public flush(model: typeof ApiModel) {
  270. const repository = this.getRepository(model)
  271. repository.flush()
  272. }
  273. /**
  274. * Is the model instance a new one, or does it already exist in the data source (=API)
  275. *
  276. * This is a convenient way of testing a model instance you did not already fetch, else prefer the use of the
  277. * isNew() method of ApiResource
  278. *
  279. * @param model
  280. * @param id
  281. */
  282. public isNewInstance(model: typeof ApiModel, id: number | string): boolean {
  283. const repository = this.getRepository(model)
  284. const item = repository.find(id)
  285. if (!item || typeof item === 'undefined') {
  286. // TODO: est-ce qu'il ne faudrait pas lever une erreur ici plutôt?
  287. console.error(model.entity + '/' + id + ' does not exist!')
  288. return false
  289. }
  290. return item.isNew()
  291. }
  292. /**
  293. * Save the state of the model instance in the store, so this state could be restored later
  294. *
  295. * @param model
  296. * @param instance
  297. * @private
  298. */
  299. protected saveInitialState(model: typeof ApiResource, instance: ApiResource) {
  300. const repository = this.getRepository(model)
  301. // Clone and prefix id
  302. const clone = _.cloneDeep(instance)
  303. clone.id = this.CLONE_PREFIX + clone.id
  304. repository.save(clone)
  305. }
  306. /**
  307. * Return the saved state of the model instance from the store
  308. *
  309. * @param model
  310. * @param id
  311. * @private
  312. */
  313. protected getInitialStateOf(model: typeof ApiResource, id: string | number): ApiResource | null {
  314. const repository = this.getRepository(model)
  315. // Find the clone by id
  316. const instance = repository.find(this.CLONE_PREFIX + id)
  317. if (instance === null) {
  318. return null
  319. }
  320. // Restore the initial id
  321. instance.id = id
  322. return instance
  323. }
  324. /**
  325. * Delete the temporary model instance from the repo after it was persisted via the api, replaced by the instance
  326. * that has been returned by the api with is definitive id.
  327. *
  328. * @param model
  329. * @param tempInstanceId
  330. * @private
  331. */
  332. protected removeTempAfterPersist(model: typeof ApiResource, tempInstanceId: number | string) {
  333. const repository = this.getRepository(model)
  334. const instance = repository.find(tempInstanceId)
  335. if (!instance || typeof instance === 'undefined') {
  336. // TODO: il vaudrait peut-être mieux lever une erreur ici?
  337. console.error(model.entity + '/' + tempInstanceId + ' does not exist!')
  338. return
  339. }
  340. if (!instance.isNew()) {
  341. throw new Error('Error: Can not remove a non-temporary model instance')
  342. }
  343. repository.destroy(tempInstanceId)
  344. repository.destroy(this.CLONE_PREFIX + tempInstanceId)
  345. }
  346. }
  347. export default EntityManager