Правило больших веб-служб RESTful

Question

Я создаю несколько веб-сервисов, которые производят и потребляют XML. План состоит в том, чтобы использовать Джерси 1.x на Tomcat 6.x с JAXB.

Что мне нужно знать, это; есть ли какое-либо правильное правило для создания этих служб? Каковы общие практики при выполнении PUT или GET? Ожидает ли ожидание ответа, статуса или объекта?

Я читал и рассматривал примеры всех этих сценариев, но каждый автор/блоггер и, как представляется, рассматривал эти же сценарии по-разному.

Любые предложения от тех, кто делал это некоторое время?

Благодаря

Answer 1

Несколько вещей, все, кажется, согласны или не согласны на:

1. Недействительные запросы возвращают HTTP 400 код. 500 следует использовать только для «неожиданных исключений».
2. Хотя нет определенной нормы, попробуйте использовать Clean URLs. В дополнение к упомянутым преимуществам упрощается настройка обратных прокси, если вам это нужно.
3. В HTTP-методах, хотя, похоже, существует соглашение о GET и DELETE, есть дискуссия о том, какие из PUT или POST создаются или обновляются. См. this discussion. Наконец, некоторые прокси или веб-серверы (IIS) не всегда справляются с чем-либо другим, кроме GET и POST, поэтому вам нужно прибегнуть к дополнительному заголовку X-HTTP-Method-Override, чтобы указать ваш фактический метод.
4. Вы должны уважать заголовок Accept и возвращать содержимое запрашиваемого типа. Типы текста (XML, JSON, Plain Text и HTML) являются наиболее распространенными, но вы можете не захотеть поддерживать их все.

Привлекательность REST - его простота; убедитесь, что вы держите его таким образом. Быть простым, документировать услуги легко, и это реальный ключ, а не то, что вы используете POST или PUT.