Как создать динамическую форму с использованием REST?

Question

[VikentiyR]

Всем привет.
Я хочу создать динамическую форму, в приложении использую REST.
Из за того, что приложение изначально не знает структуру данных, нет возможности подготовить форму.
Придётся создавать её динамически.

Меня интересует как передать аннотацию, по которой будет формироваться форма (параметры валидации, источники данных для выпадающих списков, заголовки полей формы...).

Может кто подскажет, способ формирования динамической формы и способ передачи аннотации?

Answer 1

[Алексей Гусейнов]

С идеологической точки зрения, клиент посылает на сервер запрос с заголовком «Accept: формат», сервер вспоминает, умеет ли он описывать формы в таком формате, выдает описание формы в нём и обязательно указывает его Content-type. Клиент смотрит на Content-type, вспоминает, умеет ли он обрабатывать этот формат и рендерит форму. Сама идеология REST не накладывает никаких ограничений на то, как именно передавать данные.

Например можно с сервера выдать HTML страницу с формой, клиент смотрит, видит html, содержимое head добавляет к текущему head страницы (чтобы стили подгрузились), а содержимое body добавляет в div для формы. Очень соответсвует REST.

Answer 2

[VikentiyR]

Спасибо за ответ.
Как раз думал в данном направлении, но интересовало насколько это верно с идеологической точки зрения.

Answer 3

[Сергей Протько]

Что-то типа того:

[
    {name: "fieldName", 'type': "email", 'length': {min: 10, max: 50}, label: "Field Label"}
]

И все в таком духе. Реализовать сборщик формы в зависимости от типа тоже реально.

Еще есть готовые реализации. Я увы работал с этой проблемой только в контексте работы с Backbone. Тут мне помогла эта реализация

Comments

[Алексей Гусейнов]

Если нужно просто решить задачу, то этого достаточно. Если хочется именно REST, то наверное workflow будет примерно такой:
Послать на сервер GET запрос на адрес ресурса, который будем редактировать. В Accept указать в каком виде хотим получить описание объекта. Скорее всего это будет application/json, а лучше application/vnd.<ваше имя>.<ваш формат>+json т.к. сойдет не любой json, а с вполне конкретной структурой. Для версионирования форматов можно использовать спецификатор ";version=1.0"

Сервер вернет объект, в заголовке Content-type формат (мы могли указать несколько форматов в Accept), а также в заголовке Link адрес, по которому GET запросом можно забрать описание формы.

Аналогичным образом забираем форму.

Заполненную форму отправляем на адрес редактируемого ресурса методом PUT (ни в коем случае не POST). Не забываем указать Content-type, чтобы сервер понял, что ему отправили.

Хорошим тоном будет отправить ресурс в том же формате, в котором его прислал сервер. Так больше вероятность, что сервер поймет запрос.

А вот как эту красоту реализовать так, чтобы в браузерах работало — большой вопрос. Такое HTTP API хорошо работает для классических клиентских приложений т.к. там не будет проблем с поддержкой всех тонкостей HTTP. Для браузерного клиента придётся отказаться от строгого следования REST или добавлять костыли в виде дополнительных параметров, заменяющих заголовки для клиентов, не позволяющих их послать.

[VikentiyR]

Идея с Link мне понравилась.
Нужно будет попробовать реализовать функционал несколькими способами и оценить удобство использования.

[Алексей Гусейнов]

Сильно зависит от приложения. Сделать кошерный интерфейс сложно, зато легко поддерживать зоопарк клиентов разных версий.

[VikentiyR]

Я пока в собственном проекте планирую RESTful использовать, для отработки механизмов, вот и ищу удачные решения.
Для коммерческого использования пока использование серверной генерации страниц быстрее и проблем меньше. Но прогресс не стоит на месте)

Answer 4

[Wott]

Я, для похожей задачи по запросу просто присылал кусок html с формой. тип полей для валидации лежал в параметре поля, который клиентский код видел и валидировал и формировал PUT или POST ( создать или изменить ). вызов — куда конкретно оправлять также клал в action.
потому что php сам по себе нормальнйы шаблонизатор, а на клиенте же приходиться создавать и лопатить DOM «вручную»

Можно присылать список полей со всеми параметрами и создавать на клиенте и это лучше в том случае если мы хотим разгрузить сервер или у нас уже есть шаблонизатор на клиенте.

Answer 5

[VikentiyR]

Присылать форму очень заманчиво, но при разработке альтернативного клиента (например для мобильного) придётся дорабатывать серверную часть, отвечающую за формирование html.

К тому же я использую достаточно удобный шаблонизатор.