В данном разделе приведен пример использования REST API v2 из JavaScript, выполняющегося на HTML-странице. На странице изначально отображается форма логина, а после успешного входа - соответствующее сообщение и список сущностей.
Для простоты, в данном примере для хранения файлов HTML/CSS/JavaScript используется каталог modules/web/web/VAADIN
, так как соответствующий каталог развернутого веб-приложения используется для выдачи статических ресурсов. Поэтому никаких настроек на сервере Tomcat делать не требуется. Результирующий URL будет начинаться с http://localhost:8080/app/VAADIN
, так что данный вариант не стоит использовать в реальном приложении, вместо этого создайте отдельное веб-приложение со своим контекстом.
Загрузите jQuery и Bootstrap и скопируйте в каталог modules/web/web/VAADIN
вашего проекта. Создайте файлы customers.html
и customers.js
, так что содержимое каталога должно быть примерно таким:
bootstrap.min.css
customers.html
customers.js
jquery-3.1.1.min.js
Содержимое файла customers.html
:
link:../../../../source/rest/rest_customers.html[role=include]
Содержимое файла customers.js
:
link:../../../../source/rest/rest_customers_script.js[role=include]
Имя пользователя и пароль из полей ввода передаётся на сервер POST-запросом с закодированными Base64 клиентскими именем и паролем в заголовке Authorization
, как описано в разделе [rest_api_v2_ex_get_token]. В случае успешной аутентификации, страница получает с сервера значение токена доступа, токен записывается в переменную oauthToken
, скрывается блок loginForm
и отображается блок loggedInStatus
.
Чтобы отобразить список покупателей, на сервер отправляется запрос на получение списка экземпляров сущности sales$Customer
, передавая значение oauthToken
в заголовке Authorization
.
Если запрос выполнен, блок customers
отображается на экране, и маркированный список customersList
заполняется элементами, содержащими значения атрибутов name и email сущности Customer.