Tôi yêu cách RAML có thể mất động tham khảo schemas khác nhau khi khai báo một resourceType như:động dân số ví dụ json theo RAML
resourceTypes:
- collection:
get:
responses:
200:
body:
application/json:
schema: <<schema>>
post:
body:
application/json:
schema: <<schema>>Create
responses:
200:
body:
application/json:
schema: <<schema>>
Ở đây tôi có thể sử dụng điều này như
/users:
type: { collection: { schema: user } }
và RAML sẽ cung cấp cho tôi user phản hồi lược đồ từ GET và POST và cũng sử dụng lược đồ userCreate để gửi yêu cầu POST. Mát mẻ! Bây giờ tôi có thể tái sử dụng định nghĩa bộ sưu tập của mình với hàng tấn các lược đồ khác nhau.
Nhưng bây giờ tôi muốn có ví dụ cho tất cả mọi thứ json quá, tôi đã hy vọng để sử dụng các <<schema>> var theo một cách khác để tận dụng "tái sử dụng mã". Tôi đã hy vọng có thể làm được
resourceTypes:
- collection:
get:
responses:
200:
body:
application/json:
schema: <<schema>>
example: examples/v1-<<schema>>.json
post:
body:
application/json:
schema: <<schema>>Create
example: examples/v1-<<schema>>-create.json
responses:
200:
body:
application/json:
schema: <<schema>>
example: examples/v1-<<schema>>.json
nhưng tiếc là điều này không có tác dụng. Tôi nhận được một lỗi nói
error: File with path "/examples/v1-%3C%3Cschema%3E%3E.json" does not exist
Vì vậy, bây giờ tôi đã phải dùng đến tay thêm này cho tất cả các bộ sưu tập của tôi và /users ví dụ trên đã trở thành
/users:
type: { collection: { schema: user } }
get:
responses:
200:
body:
application/json:
example: !include examples/v1-user.json
post:
body:
application/json:
example: !include examples/v1-user-create.json
responses:
200:
body:
application/json:
example: !include examples/v1-user.json
Đối với tôi, đây là một LOT của overhead chỉ để thêm ví dụ. Đặc biệt là khi tôi muốn lặp lại mô hình trên nhiều tài nguyên.
Câu hỏi: Có cách nào để thực hiện việc này không?