connection.ts 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  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, args.params)
  33. } else {
  34. return Connection.getCollection(url, args.type, args.showProgress, args.params)
  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, args.params) :
  45. Connection.post(url, args.data, args.showProgress, args.params)
  46. case HTTP_METHOD.DELETE:
  47. return Connection.deleteItem(url, args.id, args.showProgress, args.params)
  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. * @param {AnyJson} params
  57. * @return {Promise<any>}
  58. */
  59. public static getItem (url: string, id: number, showProgress: boolean = true, params: AnyJson = {}): Promise<any> {
  60. const config: AxiosRequestConfig = {
  61. url: `${url}/${id}`,
  62. method: HTTP_METHOD.GET,
  63. progress: showProgress,
  64. params: params
  65. }
  66. return Connection.request(config)
  67. }
  68. /**
  69. * Get collection : préparation de la config pour la récupération d'une collection d'items
  70. * @param {string} url
  71. * @param {boolean} progress
  72. * @param {QUERY_TYPE} type
  73. * @param {AnyJson} params
  74. * @return {Promise<any>}
  75. */
  76. public static getCollection (url: string, type: QUERY_TYPE, progress: boolean = true, params: AnyJson = {}): Promise<any> {
  77. let config: AxiosRequestConfig = {
  78. url: `${url}`,
  79. method: HTTP_METHOD.GET,
  80. progress,
  81. params: params
  82. }
  83. if(type === QUERY_TYPE.IMAGE)
  84. config = {...config, responseType: 'blob'}
  85. return Connection.request(config)
  86. }
  87. /**
  88. * Post : préparation de la config pour la création d'un item
  89. * @param {string} url
  90. * @param {AnyJson} data
  91. * @param {boolean} progress
  92. * @param {AnyJson} params
  93. * @return {Promise<any>}
  94. */
  95. public static post (url: string, data: AnyJson, progress: boolean = true, params: AnyJson = {}): Promise<any> {
  96. const config: AxiosRequestConfig = {
  97. url: `${url}`,
  98. method: HTTP_METHOD.POST,
  99. data,
  100. progress,
  101. params: params
  102. }
  103. return Connection.request(config)
  104. }
  105. /**
  106. * Put : préparation de la config pour la mise à jour d'un item
  107. * @param {string} url
  108. * @param {number} id
  109. * @param {AnyJson} data
  110. * @param {boolean} progress
  111. * @param {AnyJson} params
  112. * @return {Promise<any>}
  113. */
  114. public static put (url: string, id: number, data: AnyJson, progress: boolean = true, params: AnyJson = {}): Promise<any> {
  115. const config: AxiosRequestConfig = {
  116. url: `${url}/${id}`,
  117. method: HTTP_METHOD.PUT,
  118. data,
  119. progress,
  120. params: params
  121. }
  122. return Connection.request(config)
  123. }
  124. /**
  125. * DELETE Item : préparation de la config pour la suppression d'un item
  126. * @param {string} url
  127. * @param {number} id
  128. * @param {boolean} progress
  129. * @param {AnyJson} params
  130. * @return {Promise<any>}
  131. */
  132. public static deleteItem (url: string, id: number, progress: boolean = true, params: AnyJson = {}): Promise<any> {
  133. const config: AxiosRequestConfig = {
  134. url: `${url}/${id}`,
  135. method: HTTP_METHOD.DELETE,
  136. progress,
  137. params: params
  138. }
  139. return Connection.request(config)
  140. }
  141. /**
  142. * Exécute la requete
  143. * @param {AxiosRequestConfig} config
  144. * @return {Promise<any>}
  145. */
  146. public static async request (config: AxiosRequestConfig): Promise<any> {
  147. return await Connection.connector.$request(config)
  148. }
  149. }
  150. export default Connection