Series: Axios Lesson 27

Instance Methods — Custom instance orqali HTTP method'lar

Axios custom instansiya metodlari (get, post, patch, delete), universal instance(config) chaqiruvi va React ilovalarida Service Layer arxitekturasini tashkil qilish.

27-dars

Instance Methods — Custom instance orqali HTTP method'lar

Biz oldingi darslarda axios.create() yordamida shaxsiy apiClient (yoki mainApi) yaratgan edik. Ana shu instansiyaning o'zi barcha standart HTTP metodlarni (get, post, put, patch, delete) o'z ichiga oladi. Ularni Instance Methods deb ataymiz.

Global axios.get() bilan Instance apiClient.get() ning farqi:

  • axios.get() — Hech qanday baseURL, timeout yoki maxsus sarlavhalarni bilmaydigan "toza" global funksiya.
  • apiClient.get() — O'zining ichida sozlangan barcha baseURL, timeout, headers va interceptors qoidalarini avtomatik ravishda o'zi bilan qo'shib olib ketuvchi "aqlli" metod.

1. Instansiya metodlarining to'liq ro'yxati va sintaksisi

TypeScript loyihalarida generiklar (Generics) yordamida bu metodlardan foydalanish xavfsizlikni ta'minlaydi:

import { apiClient } from './apiClient';

interface User {
  id: number;
  name: string;
  email: string;
}

interface CreateUserDto {
  name: string;
  email: string;
}

// 1. GET — Ma'lumot olish
const getUsers = async () => {
  // <User[]> — serverdan keladigan ma'lumotning TypeScript turi
  const response = await apiClient.get<User[]>('/users');
  return response.data;
};

// 2. POST — Yangi ma'lumot qo'shish
const createUser = async (userData: CreateUserDto) => {
  // apiClient.post<JavobTuri>(url, yuboriladiganData, config)
  const response = await apiClient.post<User>('/users', userData);
  return response.data;
};

// 3. PUT / PATCH — Ma'lumotni yangilash
const updateUser = async (id: number, partialData: Partial<CreateUserDto>) => {
  const response = await apiClient.patch<User>(`/users/${id}`, partialData);
  return response.data;
};

// 4. DELETE — Ma'lumotni o'chirish
const deleteUser = async (id: number) => {
  await apiClient.delete(`/users/${id}`);
};

2. Universal instance(config) metodidan foydalanish

Axios instansiyasining o'zi ham aslida funksiya hisoblanadi. Ya'ni, siz apiClient.get() yoki apiClient.post() deyish o'rniga, to'g'ridan-to'g'ri instansiyaning o'ziga konfiguratsiya obyektini uzatishingiz mumkin. Bu dinamik so'rovlar yozishda juda qo'l keladi:

import { apiClient } from './apiClient';

interface Product {
  id: number;
  title: string;
}

// Universal so'rov yuborish
const sendUniversalRequest = async (method: 'get' | 'post', url: string, data?: any) => {
  const response = await apiClient<Product>({
    method: method,
    url: url,
    data: data,
  });

  return response.data;
};

3. Service Layer (Servis qatlami) arxitekturasida Instance Metodlarini qo'llash

Yirik React ilovalarida komponentlar ichida to'g'ridan-to'g'ri apiClient.get yozib o'tirilmaydi. Buning o'rniga har bir resurs uchun alohida Service fayllari ochiladi va barcha instance metodlar shu yerga jamlanadi:

// src/services/userService.ts
import { apiClient } from '../api/axios';

export interface UserProfile {
  id: number;
  username: string;
}

export const UserService = {
  // Barcha foydalanuvchilarni olish
  getAll: async (): Promise<UserProfile[]> => {
    const res = await apiClient.get<UserProfile[]>('/users');
    return res.data;
  },

  // Bitta foydalanuvchini ID bo'yicha olish
  getById: async (id: number): Promise<UserProfile> => {
    const res = await apiClient.get<UserProfile>(`/users/${id}`);
    return res.data;
  },

  // Yangi foydalanuvchi yaratish
  create: async (data: Omit<UserProfile, 'id'>): Promise<UserProfile> => {
    const res = await apiClient.post<UserProfile>('/users', data);
    return res.data;
  },
};