Cara Menghitamkan Respons API dalam Go

Penomboran: Panduan Praktikal untuk Pengendalian Data yang Cekap

Bayangkan aplikasi yang berurusan dengan pangkalan data besar yang mengandungi beribu-ribu entri. Mengembalikan semua rekod dalam satu respons API adalah resipi untuk bencana: ia memperlahankan aplikasi, menggunakan lebar jalur yang berlebihan dan mengatasi pengguna dengan jumlah data yang tidak terurus.

Penomboran menyediakan penyelesaiannya. Dengan membahagikan data kepada halaman yang lebih kecil dan boleh diurus, pengguna hanya menerima subset data pada satu masa. Ini menghasilkan API yang lebih pantas dan pengalaman pengguna yang lebih lancar.

Fikirkan sebuah rak perpustakaan besar yang penuh dengan ratusan buku. Daripada carian huru-hara melalui keseluruhan koleksi, ia adalah jauh lebih cekap untuk menyemak imbas bahagian demi bahagian ("Halaman 1," "Halaman 2," dll.). Penomboran berfungsi berdasarkan prinsip yang sama.

Persediaan Pangkalan Data

Untuk demonstrasi ini, jadual items ringkas dalam pangkalan data PostgreSQL akan digunakan. Skema jadual adalah seperti berikut:

CREATE TABLE items (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

Isi jadual dengan data sampel:

INSERT INTO items (name) 
VALUES 
('Item 1'), ('Item 2'), ('Item 3'), ..., ('Item 100');

Membina API Go dengan Penomboran

Mari kita buat titik akhir API (/items) yang menerima dua parameter pertanyaan:

• page: Nombor halaman (lalai kepada 1).
• limit: Bilangan rekod setiap halaman (lalai kepada 10).

Berikut ialah pelaksanaan kod Go:

package main

import (
    "database/sql"
    "fmt"
    "log"
    "net/http"
    "strconv"

    _ "github.com/lib/pq"
)

// ... (rest of the code remains the same)

Memahami Logik

Parameter Penomboran:

• page: Menentukan subset data yang dikehendaki.
• limit: Mentakrifkan bilangan rekod setiap halaman.

Pengiraan Offset:

offset menentukan bilangan rekod untuk dilangkau sebelum mendapatkan semula data halaman semasa:

offset = (page - 1) * limit

Contohnya:

• page=1, limit=5 → offset=0 (langkau 0 rekod).
• page=2, limit=5 → offset=5 (langkau 5 rekod pertama).

Pertanyaan SQL:

Klausa LIMIT dan OFFSET dalam pertanyaan SQL mengambil data yang diperlukan:

SELECT id, name, created_at FROM items ORDER BY id LIMIT 5 OFFSET 5;

Ujian API

Uji API menggunakan alatan seperti Posmen, cURL atau pelayar web:

• Ambil halaman pertama (10 item):

curl "http://localhost:8080/items?page=1&limit=10"

• Ambil halaman kedua (20 item):

curl "http://localhost:8080/items?page=2&limit=20"

Contoh Respons API

Sampel respons untuk /items?page=2&limit=2:

CREATE TABLE items (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

Mengatasi Isu Lazim

1. Mengapa tidak ambil semua rekod dan potong dalam Go? Ini sangat tidak cekap, terutamanya dengan set data yang besar. Memuatkan berjuta-juta rekod ke dalam ingatan akan memperlahankan atau merosakkan API dengan ketara.

2. Mengendalikan Parameter Hilang: Sentiasa tentukan nilai lalai (cth., page=1, limit=10) untuk mengelakkan ralat API.

3. Pengoptimuman: Mengindeks lajur yang kerap ditanya (seperti id atau created_at) secara drastik meningkatkan kelajuan pertanyaan.

Kesimpulan

Melaksanakan penomboran memerlukan kod minimum dan pertanyaan pangkalan data strategik, mengubah tindak balas API yang berpotensi memberangsangkan kepada pengalaman yang ringan dan mesra pengguna. Pertimbangkan untuk menambah ciri seperti jumlah kiraan halaman, pautan seterusnya/sebelumnya atau penomboran berasaskan kursor untuk kebolehskalaan yang dipertingkatkan dalam aplikasi yang lebih besar. Untuk mendapatkan sumber dan kemas kini Golang lanjut, ikuti Siddhesh di Twitter dan GitHub. Teruskan belajar, teruskan membina! ??

Atas ialah kandungan terperinci Cara Menghitamkan Respons API dalam Go. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!