0Pricing
Go Academy · Lekcja

Pomocnicze funkcje odpowiedzi i kody statusu

c.JSON, c.AbortWithError i odpowiedzi błędów

Pomocnicze funkcje odpowiedzi i kody statusu to bezpłatna lekcja Go Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Go Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Go Academy zawiera 4 lekcji w sumie.

c.JSON

c.JSON(statusCode, obj) serializuje obj do JSON i ustawia Content-Type na application/json. To najczęściej używana metoda wysyłania odpowiedzi.

c.JSON(http.StatusOK, gin.H{
    "id":   user.ID,
    "name": user.Name,
})

gin.H

gin.H to skrócona forma zapisu map[string]any. Używaj jej do tworzenia doraźnych obiektów JSON bez definiowania struktury.

c.JSON(200, gin.H{"message": "created", "id": id})

Stałe kodów statusu HTTP

Dla większej czytelności używaj stałych http.Status* zamiast surowych liczb:

c.JSON(http.StatusCreated, gin.H{"id": id})
c.JSON(http.StatusBadRequest, gin.H{"error": "invalid input"})
c.JSON(http.StatusInternalServerError, gin.H{"error": "internal error"})

c.String i c.Data

Wysyłaj zwykły tekst za pomocą c.String lub dowolne bajty za pomocą c.Data:

c.String(200, "Hello, %s!", name)
c.Data(200, "application/octet-stream", fileBytes)

c.File i c.FileAttachment

Udostępniaj plik z dysku — bezpośrednio w odpowiedzi lub jako pobieranie:

c.File("./public/report.pdf")           // inline
c.FileAttachment("./report.pdf", "report.pdf") // download

c.Redirect

Wysyłaj przekierowanie HTTP (301 — trwałe, 302 — tymczasowe):

c.Redirect(http.StatusMovedPermanently, "/new-url")

c.AbortWithStatus

Zatrzymuje przetwarzanie łańcucha żądania i wysyła pustą odpowiedź z podanym kodem statusu. W przeciwieństwie do c.JSON wywołuje Abort, aby uniemożliwić uruchomienie kolejnych programów obsługi.

c.AbortWithStatus(http.StatusUnauthorized)

c.Error

Dołączaj błędy do kontekstu bez wysyłania odpowiedzi. Middleware może je zebrać i na końcu wysłać ujednoliconą odpowiedź błędu.

c.Error(fmt.Errorf("database error: %w", err))

Nagłówki odpowiedzi

Ustawiaj niestandardowe nagłówki odpowiedzi przed wywołaniem c.JSON lub c.Data:

c.Header("X-Request-ID", requestID)
c.Header("Cache-Control", "max-age=3600")

Renderowanie XML

Gin obsługuje również odpowiedzi XML i YAML:

c.XML(200, user) // requires xml struct tags
c.YAML(200, user)

Niestandardowa struktura odpowiedzi

Zdefiniuj standardowy wrapper odpowiedzi API, aby zachować spójny format we wszystkich endpointach:

type APIResponse struct {
    Success bool   `json:"success"`
    Data    any    `json:"data,omitempty"`
    Error   string `json:"error,omitempty"`
}

Szybkie sprawdzenie

Czym c.AbortWithStatus różni się od c.Status?

Podsumowanie: pomocnicze metody odpowiedzi

Najważniejsze informacje:

  • c.JSON(statusCode, obj) to podstawowa metoda wysyłania odpowiedzi JSON
  • Dla większej czytelności używaj stałych http.Status*
  • c.AbortWithStatus zatrzymuje łańcuch programów obsługi
  • Zdefiniuj spójny wrapper APIResponse dla wszystkich endpointów

Często zadawane pytania

Czy lekcja „Pomocnicze funkcje odpowiedzi i kody statusu” jest bezpłatna?

Tak — pełny tekst „Pomocnicze funkcje odpowiedzi i kody statusu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Go Academy, przejdź na CoddyKit PRO. Kurs Go Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Pomocnicze funkcje odpowiedzi i kody statusu”?

c.JSON, c.AbortWithError i odpowiedzi błędów Ćwiczysz Go Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Go Academy?

Nie wymagamy żadnego doświadczenia. Go Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Pomocnicze funkcje odpowiedzi i kody statusu”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Go Academy?

Tak. Każda lekcja Go Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Router Gin i grupy tras
  2. Wiązanie żądań i walidacja
  3. Pomocnicze funkcje odpowiedzi i kody statusu
  4. Middleware Gin: uwierzytelnianie i logowanie
← Powrót do Go Academy