ts-api/api/BaseApi.ts

import { OpenApiError } from '../api/OpenApiError';

export class BaseApi {

    /** Die URL des Servers. Alle Pfadangaben sind relativ zu dieser URL. */
    protected url : string;

    /** Der Anmeldename beim Server */
    protected username : string;

    /** Der Default-RequestInit für einen Fetch */
    #requestinit : RequestInit =  {
        cache : 'no-cache',
        credentials : 'same-origin'
    }

    /** Die Default-Header-Einträge */
    #headers : Record<string, string> = {};

    /**
     * Erstellt eine neue API mit der übergebenen Konfiguration.
     * 
     * @param {string} url - die URL des Servers: Alle Pfadangaben sind relativ zu dieser URL
     * @param {string} username - der Benutzername für den API-Zugriff
     * @param {string} password - das Kennwort des Benutzers für den API-Zugriff
     */
    protected constructor(url : string, username : string, password : string) {
        this.url = url;
        this.username = username;
        this.#headers["Authorization"] = "Basic " + btoa(username + ":" + password);
    }


    #getURL(path : string) : string {
        return this.url + path;
    }


    async #getBinary(path : string, mimetype : string) : Promise<Blob> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Accept"] = mimetype;
        requestInit.body = null;
        requestInit.method = 'GET';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for GET: ' + path);
            return await response.blob();
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for GET: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }


    public getPDF(path : string) : Promise<Blob> {
        return this.#getBinary(path, 'application/pdf');
    }


    async #getTextBased(path : string, mimetype : string) : Promise<string> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Accept"] = mimetype;
        requestInit.body = null;
        requestInit.method = 'GET';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for GET: ' + path);
            return await response.text();
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for GET: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }

    public getText(path : string) : Promise<string> {
        return this.#getTextBased(path, 'text/plain');
    }

    public getJSON(path : string) : Promise<string> {
        return this.#getTextBased(path, 'application/json');
    }


    async #postTextBased(path : string, mimetype_send : string, mimetype_receive : string, body : string | null) : Promise<string> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Content-Type"] = mimetype_send;
        requestInit.headers["Accept"] = mimetype_receive;
        requestInit.body = body;
        requestInit.method = 'POST';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for POST: ' + path);
            return await response.text();
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for POST: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }

    public postText(path : string, body : string | null) : Promise<string> {
        return this.#postTextBased(path, 'text/plain', 'text/plain', body);
    }

    public postJSON(path : string, body : string | null) : Promise<string> {
        return this.#postTextBased(path, 'application/json', 'application/json', body);
    }


    async #patchTextBased(path : string, mimetype : string, body : string) : Promise<void> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Content-Type"] = mimetype;
        requestInit.body = body;
        requestInit.method = 'PATCH';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for PATCH: ' + path);
            return;
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for PATCH: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }

    public patchText(path : string, body : string) : Promise<void> {
        return this.#patchTextBased(path, 'text/plain', body);
    }

    public patchJSON(path : string, body : string) : Promise<void> {
        return this.#patchTextBased(path, 'application/json', body);
    }


    async #putTextBased(path : string, mimetype : string, body : string) : Promise<void> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Content-Type"] = mimetype;
        requestInit.body = body;
        requestInit.method = 'PUT';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for PUT: ' + path);
            return;
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for PUT: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }

    public putText(path : string, body : string) : Promise<void> {
        return this.#putTextBased(path, 'text/plain', body);
    }

    public putJSON(path : string, body : string) : Promise<void> {
        return this.#putTextBased(path, 'application/json', body);
    }

    async #deleteTextBased(path : string, mimetype : string) : Promise<void> {
        let requestInit : RequestInit = { ...this.#requestinit };
        requestInit.headers = { ...this.#headers };
        requestInit.headers["Accept"] = mimetype;
        requestInit.body = null;
        requestInit.method = 'DELETE';
        try {
            const response = await fetch(this.#getURL(path), requestInit);
            if (!response.ok)
                throw new OpenApiError(response, 'Fetch failed for DELETE: ' + path);
            return;
        } catch (e) {
            if (e instanceof Error)
                throw (e instanceof OpenApiError) ? e : new OpenApiError(e, 'Fetch failed for DELETE: ' + path);
            throw new Error("Unexpected Error: " + e);
        }
    }

    public deleteText(path : string) : Promise<void> {
        return this.#deleteTextBased(path, 'text/plain');
    }

    public deleteJSON(path : string) : Promise<void> {
        return this.#deleteTextBased(path, 'application/json');
    }

}