Co katalogi roots mówią serwerowi

Państwa serwer działa jako osobny proces, więc nie może po prostu zobaczyć projektu użytkownika. Potrzebuje informacji od klienta o tym, które foldery może wykorzystywać. Taka wskazówka nazywa się root. 🧭

Root to pojedyncza lokalizacja wskazana przez klienta, w obrębie której serwer może pracować, zwykle jeden folder projektu. Wyznacza granicę obszaru, do którego serwer powinien mieć dostęp.

Większość rootów to identyfikatory URI file:// wskazujące katalog na dysku. Schemat jasno pokazuje, że chodzi o lokalny folder, a nie adres internetowy.

Każdy root może mieć opcjonalną nazwę, czyli krótką etykietę, na przykład „My App”. Służy ona wyłącznie ludziom, aby logi i prompty były czytelne zamiast wyświetlać surowe ścieżki.

Klient może jednocześnie udostępniać kilka rootów, na przykład folder z kodem i folder z dokumentacją. Państwa serwer powinien traktować tę listę jako pełny zbiór miejsc, których może dotykać.

Rooty są formą wskazówki, a nie ścisłym ograniczeniem wymuszanym przez protokół. Informują, na czym się skupić, ale to Państwo muszą dopilnować, aby rzeczywiście pozostać w ich obrębie. ✋

Korzenie pozwalają użytkownikowi powiedzieć: „pracuj tutaj i nigdzie indziej”. Takie ograniczenie zakresu powstrzymuje serwer przed zaglądaniem do prywatnych plików znajdujących się daleko poza projektem rzeczywiście otwartym przez użytkownika.

Klient decyduje, co jest korzeniem — często na podstawie folderu obszaru roboczego otwartego przez użytkownika. Serwer nigdy nie ustala własnych korzeni; jedynie odczytuje te, które otrzyma.

Korzenie nie są niezmienne. Gdy użytkownik otworzy nowy folder, zestaw się zmienia, a sprawny klient może poinformować serwer, że lista została zaktualizowana.

Korzenie to opcjonalna funkcja klienta. Niektóre hosty ją udostępniają, a inne nie, dlatego dobrze zbudowany serwer powinien działać poprawnie zarówno wtedy, gdy lista jest pełna, jak i wtedy, gdy jest pusta.

W przesyłanych danych wpis korzenia jest bardzo mały: zawiera tylko uri oraz opcjonalną nazwę. Taka prosta struktura wystarcza serwerowi, aby wiedzieć, gdzie może działać.

Dowiedziałeś się, że korzeń to lokalizacja przekazana przez klienta — często folder file:// z opcjonalną nazwą — która określa zakres działania serwera. To klient kontroluje listę, a lista może się zmieniać. 🎯