Podłączenie Komend POST: Dogłębna Analiza Tima Coreya

Wprowadzenie do komend POST

Tim rozpoczyna od ponownego odwiedzenia aktualizacji interfejsu z poprzedniej lekcji, zauważając, że system obecnie obsługuje tylko żądania GET. Wyjaśnia, że ta lekcja koncentruje się na umożliwieniu żądań POST, aby użytkownicy mogli wysyłać dane do serwera, takie jak dane JSON lub dane formularza.

Podkreśla, że rozdzielenie kodu UI od kodu biblioteki jest kluczowe. Interfejs użytkownika powinien zarządzać elementami jak dropdown, formularze HTML i pola wejściowe, podczas gdy biblioteka zajmuje się tworzeniem żądań HTTP, formatowaniem treści i wysyłaniem danych do serwera.

Tim zauważa również, że ten projekt może służyć jako przykład do portfolio, ale ważne jest, aby programiści upewnili się, że ich portfolio jest wyjątkowo ich. Odnosi się do swojego Dev Pass na timcorey.com jako sposobu na pogłębienie zrozumienia C# i metod żądań HTTP.

Zrozumienie obecnej konfiguracji

W Visual Studio Tim pokazuje bieżącą konfigurację projektu. UI pozwala wybrać metodę żądania (GET lub POST) i wpisać URL. Obecnie kliknięcie "Go" wykonuje tylko żądanie GET, wyświetlając odpowiedź w oknie wyników.

Jednym z mniejszych problemów, na które wskazuje, jest to, że cały tekst w oknie wyników jest podświetlony po żądaniu GET, co nie jest idealne do wyświetlania informacji. Tim to naprawia, ustawiając skupienie na elemencie zakładki zamiast na polu tekstowym. To zapobiega automatycznemu zaznaczaniu tekstu i poprawia doświadczenie użytkownika.

Odczytanie rozwijanej listy i określenie akcji HTTP

Aby zaimplementować komendy POST, Tim najpierw wyjaśnia, jak odczytać wybór rozwijanej listy, aby określić metodę żądania HTTP. Tworzy zmienną do przechowywania przeanalizowanej metody żądania i używa TryParse, aby przekonwertować wartość ciągu z rozwijanej listy na akcję HTTP.

Jeśli wybrana metoda jest nieprawidłowa, system wyświetla komunikat o błędzie ("Nieprawidłowy czasownik HTTP") i nie próbuje wykonać żądania. Po zweryfikowaniu metoda żądania może być użyta do określenia, czy wykonać żądanie GET, żądanie POST, czy inne metody HTTP, takie jak DELETE lub PATCH.

Przygotowanie zaplecza do obsługi żądań POST

Kolejnym krokiem jest aktualizacja biblioteki do obsługi żądań POST. Tim wyjaśnia, że komendy POST różnią się od żądań GET, ponieważ zwykle wymagają ciała żądania do wysyłania danych do docelowego zasobu. Te dane mogą być w formacie JSON, danych binarnych lub danych formularza.

Tim podkreśla oddzielanie odpowiedzialności UI od kodu biblioteki. UI przesyła zawartość ciała jako ciąg, a biblioteka konwertuje go na odpowiedni typ treści HTTP dla żądania. Ten projekt zapewnia, że ogólne operacje, takie jak formatowanie treści, są obsługiwane w bibliotece, a nie w UI.

Tworzenie przeciążenia dla żądań POST

Tim tworzy przeciążenie dla CallApiAsync, które przyjmuje trzy parametry:

1. URL – adres docelowego zasobu

2. Działanie – metoda żądania HTTP (GET, POST itd.)

3. Zawartość – ciało żądania jako ciąg znaków

To umożliwia programistom przekazywanie JSON, danych formularza lub innego zakodowanego w UI do biblioteki. Obsługując żądania POST w ten sposób, ta sama biblioteka może także obsługiwać przyszłe metody HTTP, takie jak PUT, PATCH czy DELETE.

Konwertowanie zawartości ciągu znaków na zawartość HTTP

Tim pokazuje, jak konwertować zawartość ciągu znaków z UI do StringContent, który dziedziczy po zawartości HTTP. Ustala kodowanie na UTF8 i typ zawartości na application/json, co jest odpowiednie do przesyłania uporządkowanych danych na serwer.

Ten krok zapewnia, że ciało żądania jest odpowiednio sformatowane przed wysłaniem. Tim podkreśla, że takie rozdzielenie odpowiedzialności pozwala programistom używać komend POST bez martwienia się o nagłówki HTTP, kodowanie czy konwersję zawartości w UI.

Aktualizacja interfejsu i testowanie żądań POST

Gdy biblioteka jest gotowa, Tim aktualizuje UI, aby wywoływało nową przeciążoną metodę. Testuje żądania POST używając JSONPlaceholder, ręcznie formatując ciało żądania:

{
"title": "To jest mój tytuł",
"body": "To jest mój tekst ciała",
"userId": 3
}

Tim wyjaśnia, że żądanie POST wysyła te dane do docelowego zasobu, a odpowiedź wskazuje na sukces. Początkowo występuje błąd, ponieważ enum działania HTTP nie zawiera POST. Dodanie POST rozwiązuje ten problem, umożliwiając systemowi wysyłanie komend POST z powodzeniem.

Obsługiwanie żądań POST w bibliotece

Tim demonstruje obsługę komend POST w bibliotece, używając instrukcji switch na metodzie żądania HTTP. Dla GET, system używa GetAsync; dla POST, używa PostAsync z sformatowanym ciałem żądania.

Testowanie komendy POST zwraca odpowiedź z ID (101 w JSONPlaceholder), potwierdzając, że żądanie działało. Tim zauważa, że chociaż ta testowa API nie przechowuje danych w bazie danych, jest przydatna do weryfikacji funkcjonalności żądań POST.

Kluczowe wnioski i przyszłe prace

Tim podsumowuje lekcję:

• Podmenu teraz obsługuje metody GET i POST.

• UI przekazuje ciało żądania do biblioteki.

• Biblioteka konwertuje ciąg znaków na zawartość HTTP i wykonuje poprawne żądanie HTTP.

• Komendy POST zwracają poprawne odpowiedzi, które mogą być wyświetlane w oknie wyników.

Zachęca do implementacji komend PUT, PATCH i DELETE w przyszłych lekcjach, podkreślając, że istniejący framework ułatwia dodawanie nowych metod HTTP.

Tim również doradza unikanie nadmiernego inżynierowania lub dodawania niewykorzystanego kodu, co mogłoby skutkować niepowiązanymi funkcjami lub osieroconymi elementami.

Wnioski

Film Tima Coreya dostarcza klarownego, praktycznego podejścia do komend POST w projekcie Postman Clone. Rozdzielając odpowiedzialności UI od kodu biblioteki, konwertując dane ciągu znaków na zawartość HTTP i efektywnie obsługując odpowiedzi, programiści zdobywają praktyczne doświadczenie z metodami żądań HTTP.

Ta lekcja nie tylko demonstruje przesyłanie danych do serwera, ale także kładzie podwaliny pod obsługę innych metod HTTP, nagłówków i bardziej złożonych żądań, czyniąc ją silnym przykładem praktycznym do nauki interakcji HTTP w C#.