connection.ts 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154
  1. import {NuxtAxiosInstance} from '@nuxtjs/axios'
  2. import {AxiosRequestConfig} from 'axios'
  3. import {AnyJson, DataPersisterArgs, DataProviderArgs, UrlArgs} from '~/types/interfaces'
  4. import {HTTP_METHOD, QUERY_TYPE} from '~/types/enums'
  5. import TypesTesting from "~/services/utils/typesTesting";
  6. /**
  7. * @category Services/connection
  8. * @class Connection
  9. *
  10. * Classe Wrapper du connecteur de requête (Axios dans notre cas)
  11. */
  12. class Connection {
  13. static connector: NuxtAxiosInstance;
  14. /**
  15. * Initialisation du connecteur (Axios dans notre cas)
  16. * @param {NuxtAxiosInstance} connector
  17. */
  18. static initConnector (connector: NuxtAxiosInstance) {
  19. Connection.connector = connector
  20. }
  21. /**
  22. * Main méthode qui appellera les méthodes privées correspondantes (getItem, getCollection, put, post, delete)
  23. * @param {HTTP_METHOD} method Mode de requêtage (GET, PUT, DELETE...)
  24. * @param {string} url
  25. * @param {DataProviderArgs|DataPersisterArgs} args
  26. * @return {Promise<any>}
  27. */
  28. public static invoke (method: HTTP_METHOD, url: string, args: UrlArgs): Promise<any> {
  29. switch (method) {
  30. case HTTP_METHOD.GET:
  31. if (args.id) {
  32. return Connection.getItem(url, args.id, args.showProgress)
  33. } else {
  34. return Connection.getCollection(url, args.showProgress, args.type)
  35. }
  36. case HTTP_METHOD.PUT:
  37. case HTTP_METHOD.POST:
  38. if (!TypesTesting.isDataPersisterArgs(args)) {
  39. throw new Error('*args* is not a dataPersisterArgs')
  40. }
  41. if (!args.data) {
  42. throw new Error('*args* has no data')
  43. }
  44. return method === HTTP_METHOD.PUT ? Connection.put(url, args.id, args.data, args.showProgress) :
  45. Connection.post(url, args.data, args.showProgress)
  46. case HTTP_METHOD.DELETE:
  47. return Connection.deleteItem(url, args.id, args.showProgress)
  48. }
  49. throw new Error('Unknown connection method was invoked')
  50. }
  51. /**
  52. * GET Item : préparation de la config pour la récupération d'un item
  53. * @param {string} url
  54. * @param {number} id
  55. * @param {boolean} showProgress
  56. * @return {Promise<any>}
  57. */
  58. public static getItem (url: string, id: number, showProgress: boolean = true): Promise<any> {
  59. const config: AxiosRequestConfig = {
  60. url: `${url}/${id}`,
  61. method: HTTP_METHOD.GET,
  62. progress: showProgress
  63. }
  64. return Connection.request(config)
  65. }
  66. /**
  67. * Get collection : préparation de la config pour la récupération d'une collection d'items
  68. * @param {string} url
  69. * @param {boolean} progress
  70. * @param {QUERY_TYPE} type
  71. * @return {Promise<any>}
  72. */
  73. public static getCollection (url: string, progress: boolean = true, type: QUERY_TYPE): Promise<any> {
  74. let config: AxiosRequestConfig = {
  75. url: `${url}`,
  76. method: HTTP_METHOD.GET,
  77. progress
  78. }
  79. if(type === QUERY_TYPE.IMAGE)
  80. config = {...config, responseType: 'blob'}
  81. return Connection.request(config)
  82. }
  83. /**
  84. * Post : préparation de la config pour la création d'un item
  85. * @param {string} url
  86. * @param {AnyJson} data
  87. * @param {boolean} progress
  88. * @return {Promise<any>}
  89. */
  90. public static post (url: string, data: AnyJson, progress: boolean = true): Promise<any> {
  91. const config: AxiosRequestConfig = {
  92. url: `${url}`,
  93. method: HTTP_METHOD.POST,
  94. data,
  95. progress
  96. }
  97. return Connection.request(config)
  98. }
  99. /**
  100. * Put : préparation de la config pour la mise à jour d'un item
  101. * @param {string} url
  102. * @param {number} id
  103. * @param {AnyJson} data
  104. * @param {boolean} progress
  105. * @return {Promise<any>}
  106. */
  107. public static put (url: string, id: number, data: AnyJson, progress: boolean = true): Promise<any> {
  108. const config: AxiosRequestConfig = {
  109. url: `${url}/${id}`,
  110. method: HTTP_METHOD.PUT,
  111. data,
  112. progress
  113. }
  114. return Connection.request(config)
  115. }
  116. /**
  117. * DELETE Item : préparation de la config pour la suppression d'un item
  118. * @param {string} url
  119. * @param {number} id
  120. * @param {boolean} progress
  121. * @return {Promise<any>}
  122. */
  123. public static deleteItem (url: string, id: number, progress: boolean = true): Promise<any> {
  124. const config: AxiosRequestConfig = {
  125. url: `${url}/${id}`,
  126. method: HTTP_METHOD.DELETE,
  127. progress
  128. }
  129. return Connection.request(config)
  130. }
  131. /**
  132. * Exécute la requete
  133. * @param {AxiosRequestConfig} config
  134. * @return {Promise<any>}
  135. */
  136. public static async request (config: AxiosRequestConfig): Promise<any> {
  137. return await Connection.connector.$request(config)
  138. }
  139. }
  140. export default Connection