Начальный, или стартовый, файл – традиция столь же старая, как и сам гипертекстовый Интернет. Практически на всех сайтах имеются домашние страницы или начальные файлы, призванные быть заглавной страницей, или входной дверью этих web-сайтов. Такие страницы обычно носят имя index.html, welcome.html, или default.html. Можно сконфигурировать web-приложение, чтобы обеспечить передачу запросов к этим страницам, для этого нужно добавить в дескриптор развертывания web-приложения элемент welcome-file-list.

<welcome-file-list>
   <welcome-file>index.html</welcome-file>
   <welcome-file>default.jsp</welcome-file>
</welcome-file-list>

Когда контейнер сервлетов сталкивается с URL web-приложения, задающим только каталог, а не конкретное имя файла или сервлет, он ищет в дескрипторе развертывания элемент welcome-file-list со списком начальных файлов. Контейнер сервлетов прикрепляет к запросу любой найденный в web.xml начальный файл (в порядке их перечисления в web.xml) и возвращает этот файл клиенту.

Предположим, Tomcat получил запрос к http://www.mysite.org/topcode/. И пусть также файл web.xml приложения topcode содержит элемент welcome-file-list, показанный в листинге выше. В этом случае Tomcat вернет файл http://www.mysite.org/topcode/index.html, если такой существует, если нет, Tomcat ищет в каталоге topcode файл default.jsp и возвращает его.

Контейнер сервлетов инициирует такой поиск в ответ на любой URL с запросом каталога, который он получает. Иными словами, если index.html или default.jsp (или другой выбранный вами файл) существует в корневом каталоге web-приложения и разработчик правильно настроил элемент welcome-file-list, то эти файлы автоматически возвращаются в ответ на запросы каталога.