shad-go/olympics/README.md
2020-02-24 10:37:50 +00:00

166 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## olympics
В этой задаче нужно написать http сервер со следующим API
* GET /athlete-info?name=S
-> вернуть информацию по атлету с именем: откуда, сколько каких медалей выиграл всего и по годам
для упрощения считаем, что спортсмен идентифицируется именем. В случае,
если атлет выступал более чем за одну страну, нужно приписать его
к первой стране в порядке исходных данных.
* GET /top-athletes-in-sport?sport=SSSS&limit=K
-> вернуть top-K (default=3) спортсменов по абсолютному числу медалей в их спортивной карьере в указанном виде спорта
(сортируем по золотым, потом по серебрянным, потом по бронзе, потом лексикографически по имени спортсмена)
* GET /top-countries-in-year?year=YYYY&limit=K
-> вернуть top-K (default=3) стран в порядке медального зачета (сортируем по золотым, потом по серебрянным, потом по бронзе, потом лексикографически по стране)
используя данные о победителях и призёрах олимпийских игр из [./testdata/olympicWInners.json](./testdata/olympicWinners.json).
Сервер должен слушать порт, переданный через аргумент `-port`. Путь к json'у с данными передаётся через флаг `-data`.
### Примеры
Запуск:
```
$ olympics -port 6029 -data ./olympics/testdata/olympicWinners.json
```
#### athlete-info
Успешный запрос (200, json фиксированного вида):
```
$ curl -X GET "localhost:6029/athlete-info?name=Michael%20Phelps"
{
"athlete": "Michael Phelps",
"country": "United States",
"medals": {
"gold": 18,
"silver": 2,
"bronze": 2,
"total": 22
},
"medals_by_year": {
"2004": {
"gold": 6,
"silver": 0,
"bronze": 2,
"total": 8
},
"2008": {
"gold": 8,
"silver": 0,
"bronze": 0,
"total": 8
},
"2012": {
"gold": 4,
"silver": 2,
"bronze": 0,
"total": 6
}
}
}
```
Спортсмен не найден (404, произвольное сообщение об ошибке):
```
$ curl -i -X GET "localhost:6029/athlete-info?name=AB"
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=utf-8
X-Content-Type-Options: nosniff
Date: Wed, 19 Feb 2020 23:24:30 GMT
Content-Length: 21
athlete AB not found
```
#### top-athletes-in-sport
Успешный запрос (200, json фиксированного вида):
```
$ curl -X GET "localhost:6029/top-athletes-in-sport?sport=Swimming&&limit=1"
[
{
"athlete": "Michael Phelps",
"country": "United States",
"medals": {
"gold": 18,
"silver": 2,
"bronze": 2,
"total": 22
},
"medals_by_year": {
"2004": {
"gold": 6,
"silver": 0,
"bronze": 2,
"total": 8
},
"2008": {
"gold": 8,
"silver": 0,
"bronze": 0,
"total": 8
},
"2012": {
"gold": 4,
"silver": 2,
"bronze": 0,
"total": 6
}
}
}
]
```
Неизвестный вид спорта (404, произвольное сообщение об ошибке):
```
$ curl -i -X GET "localhost:6029/top-athletes-in-sport?sport=chess"
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=utf-8
X-Content-Type-Options: nosniff
Date: Thu, 20 Feb 2020 00:42:24 GMT
Content-Length: 24
sport 'chess' not found
```
#### top-countries-in-year
Успешный запрос (200, json фиксированного вида):
```
$ curl -X GET "localhost:6029/top-countries-in-year?year=2012&&limit=2"
[
{
"country": "United States",
"gold": 145,
"silver": 63,
"bronze": 46,
"total": 254
},
{
"country": "China",
"gold": 56,
"silver": 40,
"bronze": 29,
"total": 125
}
]
```
Год не найден (404, произвольное сообщение):
```
$ curl -i -X GET "localhost:6029/top-countries-in-year?year=2009"
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=utf-8
X-Content-Type-Options: nosniff
Date: Thu, 20 Feb 2020 00:10:27 GMT
Content-Length: 20
year 2009 not found
```