Spring Data REST - collectionResourceRel против пути

Question

Я использую Spring Data REST.RepositoryRestResource аннотация имеет два разных поля: path и collectionResourceRel.В чем разница между этими двумя?Я не могу понять это, прочитав документацию.

path описано:

Сегмент пути, по которому этот ресурс должен быть экспортирован.

и collectionResourceRel описаны:

Значение rel, используемое при создании ссылок на ресурс коллекции.

Во всех примерах кода, которые я виделэти два свойства, где то же самое.Есть ли случаи, когда они отличаются?И какая разница между ними?

Answer 1

Например, для сущности User значения по умолчанию будут:

path = users

itemResourceRel = user

collectionResourceRel = users

Пример:

GET / users (путь: users)

"_links": { 
        "self": {
            "href": "http://localhost:8080/api/users"
        },
        "users": {  <-- collectionResourceRel
            "href": "http://localhost:8080/api/users"
        }
    }

GET / users / 1 (путь: users)

"_links": {
        "self": {
            "href": "http://localhost:8080/api/users/1"
        },
        "user": { <-- itemResourceRel
            "href": "http://localhost:8080/api/users/1"
        }
    }