2017-01-16 7 views
-4

Я использую для разработки API-интерфейсов с использованием веб-служб на основе SOAP с использованием JAX-WS, но мне нужно переключиться на службы REST.лучший подход к разработке REST API в Java

Интересно, что подход должен быть:

  • начать с сигнатурами методов написания ява
  • начала писать какую-то WSDL, описывающего звонки, даже если он не будет использоваться
  • начать писать некоторые другой вид (какой?) текстового описания для API
  • использовать некоторые инструменты (какой?)
  • что-то еще?

Я не спрашиваю о полной информации, а скорее о том, что должен знать о REST новичок, прежде чем создавать REST API перед началом написания кода. (Например, слишком многие из них)

благодаря

ответ

1

перестать думать о API как набор вызовов методов. REST основан на принципах, которые работают над веб-ресурсами и связями между ними. Начните с рассмотрения того, какие ресурсы и какие представления этих ресурсов требуются.

+0

спасибо. Я думаю, это совершенно другой способ рассмотреть API. А если речь идет не о доступе к ресурсам, а о выполнении действий? (и не обязательно на ресурсе) – aldo

+0

REST - это архитектурный стиль для приложений, работающих на ресурсах. Если ваши операции не находятся на ресурсах (вещи, идентифицированные с помощью веб-URL), то REST не подходит для использования. Вы можете выполнять действия с использованием HTTP-методов в виде глаголов или путем создания другого ресурса, который является результатом действия и навигации к этому ресурсу. Поскольку такая навигация не является побочным эффектом, вы должны использовать POST, а не GET для навигации. –

Смежные вопросы