如何在REST方法中轉換此Java / Soap方法？

Question

如何在REST方法中轉換此Java方法？

Employee[ ] getAllEmployees()

Employee getEmployee(String id)

Employ (Employee employee)

modify_Employee (Employee employee, String id)

我認為解決方案是

GET /api/employee

GET /api/employee/{id}

POST/api/employee/{employee}

PUT /api/employee/{id}/{employee}

但我不確定

Answer 1

你快到了。 您只需要兩個URI，每個URI都有兩個方法的實現。

• /api/employees

  • 使用POST創建新員工。 此方法接受包含單個員工的文檔，該員工序列化為JSON / XML / ...
  • 使用GET檢索所有員工。 返回格式正確的文檔，其中包含員工代表的列表，或者（也許）包含指向各個員工的鏈接的列表。 可能分頁。 您還可以選擇允許URI接受查詢參數，以允許進行過濾/搜索。

• /api/employees/{id}

  • 使用GET檢索單個員工
  • 使用PUT修改現有員工
  • 兩種方法都使用相同的文檔表示格式

注意：URI路徑元素使用復數形式表示一個“組”是一個常見的約定-因此是employees而不是employee 。 但是選擇完全是您的。