Что корни сообщают серверу

Ваш сервер работает как отдельный процесс, поэтому он не может просто увидеть проект пользователя. Клиент должен сообщить ему, с какими папками разрешено работать. Такая подсказка называется корнем. 🧭

Корень — это отдельное расположение, в пределах которого клиент разрешает серверу работать, обычно одна папка проекта. Он обозначает границу доступной области.

Большинство корней — это URI file://, указывающие на каталог на диске. Схема явно показывает, что речь идёт о локальной папке, а не о веб-адресе.

Каждый корень может содержать необязательное имя — короткую метку вроде «My App». Она предназначена только для людей, чтобы журналы и подсказки читались понятно, а не показывали необработанные пути.

Клиент может одновременно открыть доступ к нескольким корням, например к папке с кодом и папке с документацией. Ваш сервер должен считать этот список полным набором мест, которых он может касаться.

Корни — это указание, а не жёсткое ограничение протокола. Они говорят, где сосредоточиться, но именно вы должны фактически оставаться в их пределах. ✋

Корни позволяют пользователю сказать: «работайте здесь и нигде больше». Такое ограничение области не даёт серверу забредать в личные файлы далеко за пределами проекта, который пользователь действительно открыл.

Клиент решает, что считать корнем, обычно основываясь на папке рабочего пространства, которую открыл пользователь. Ваш сервер никогда не устанавливает собственные корни, а только читает переданные ему данные.

Корни не являются неизменными. Если пользователь открывает новую папку, набор изменяется, и поддерживающий эту возможность клиент может сообщить серверу, что список обновился.

Корни — это необязательная возможность клиента. Одни хосты их предоставляют, другие — нет, поэтому хорошо созданный сервер корректно работает и с полным, и с пустым списком.

При передаче по сети запись корня очень мала: это всего лишь URI и необязательное имя. Серверу достаточно этой небольшой структуры, чтобы знать, где он может работать.

Убедитесь, что назначение корня понятно.

Вы узнали, что корень — это заданное клиентом расположение, часто папка file:// с необязательным именем, ограничивающая область, в которой должен работать сервер. Список принадлежит клиенту и может изменяться. 🎯