app_vue2/services/connection/urlBuilder.ts

import {Model} from '@vuex-orm/core'
import {ImageArgs, UrlArgs} from '~/types/interfaces'
import {QUERY_TYPE} from '~/types/enums'
import {repositoryHelper} from '~/services/store/repository'
import TypesTesting from "~/services/utils/typesTesting";
import UrlOptionsBuilder from "~/services/connection/urlOptionsBuilder";

/**
 * Classe permettant de construire une URL pour l'interrogation d'une API externe
 */
class UrlBuilder {
  static ROOT = '/api/'

  /**
   * Main méthode qui appellera les méthode privées correspondantes (getEnumUrl, getModelUrl, getImageUrl)
   * @param {UrlArgs} args
   * @return {string}
   */
  public static build (args: UrlArgs): string {
    let url: string = ''
    switch (args.type) {
      case QUERY_TYPE.DEFAULT:
        url = UrlBuilder.getDefaultUrl( args.url, args.baseUrl)
        break;

      case QUERY_TYPE.ENUM:
        url = UrlBuilder.getEnumUrl(args.enumType)
        break;

      case QUERY_TYPE.MODEL:
        url = UrlBuilder.getModelUrl(args.model, args.rootModel, args.rootId)
        break;

      case QUERY_TYPE.IMAGE:
        if (!TypesTesting.isDataProviderArgs(args)) {
          throw new Error('*args* is not a dataProviderArgs')
        }
        if (!args.imgArgs) {
          throw new Error('*args* has no imgArgs')
        }
        url = UrlBuilder.getImageUrl(args.imgArgs, args.baseUrl)
        break;

      case QUERY_TYPE.FILE:
        url = UrlBuilder.getFileUrl(args.baseUrl)
        break;

      default:
        throw new Error('url, model, image or enum must be defined')
        break;
    }

    const options = UrlOptionsBuilder.build(args)
    return options.length > 0 ? `${url}?${UrlOptionsBuilder.build(args).join('&')}` : url
  }

  /**
   * Construction d'une URL qui ira concaténer la base URL avec l'url
   * @param url
   * @param baseUrl
   * @private
   */
  private static getDefaultUrl (url?: string, baseUrl: string|null = null): string {
    if (!url) {
      throw new Error('no url')
    }
    return baseUrl ? UrlBuilder.concat(baseUrl, url) : url
  }

  /**
   * Construction d'une URL Type Enum qui ira concaténer le type enum passé en paramètre avec la ROOT Url définie
   * @param {string} enumType
   * @return {string}
   */
  private static getEnumUrl (enumType?: string): string {
    if (typeof enumType === 'undefined') {
      throw new Error('enumType must be defined')
    }
    return UrlBuilder.concat(UrlBuilder.ROOT, 'enum', enumType)
  }

  /**
   * Construction d'une URL Type Model qui ira concaténer le nom de l'entité du model passé en paramètre
   * avec la ROOT Url définie (possibilité de récursivité si le root model est défini)
   *
   * @param {Model} model roles à tester
   * @param {Model} rootModel roles à tester
   * @param {number} rootId roles à tester
   * @return {string}
   */
  private static getModelUrl (model?: typeof Model, rootModel?: typeof Model, rootId?: number): string {
    if (typeof model === 'undefined') {
      throw new Error('model must be defined')
    }

    const entity = repositoryHelper.getEntity(model)

    if (typeof rootModel !== 'undefined') {
      if (typeof rootId === 'undefined') {
        throw new Error('Root ID must be defined')
      }

      const rootUrl = UrlBuilder.getModelUrl(rootModel) as string
      return String(`${rootUrl}/${rootId}/${entity}`).toString()
    }

    return UrlBuilder.concat(UrlBuilder.ROOT, entity)
  }

  /**
   * Construction d'une URL "image" qui ira concaténer l'id de l'image à downloeader passé en paramètre avec la ROOT Url définie
   * @param {number} id
   * @param {ImageArgs} imgArgs
   * @param {string} baseUrl
   * @return {string}
   */
  private static getImageUrl (imgArgs: ImageArgs, baseUrl: string = ''): string {
    const downloadUrl = `files/${imgArgs.id}/download/${imgArgs.height}x${imgArgs.width}`
    return UrlBuilder.concat(baseUrl, UrlBuilder.ROOT, downloadUrl)
  }

  /**
   * Construction d'une URL qui ira concaténer la base URL avec le Root et l'uri files
   * @param baseUrl
   * @private
   */
  private static getFileUrl (baseUrl: string = ''): string {
    return UrlBuilder.concat(baseUrl, UrlBuilder.ROOT, 'files')
  }

  /**
   * Concatenate a base url and a tail
   * @param base
   * @param tails
   * @private
   */
  public static concat (base: string, ...tails: string[]): string {
    let url = base
    tails.forEach((tail: string) => {
      url = url.replace(/^|\/$/g, '') + '/' + tail.replace(/^\/?|$/g, '')
    })
    return url
  }
}

export default UrlBuilder