![Справочное API? Не, не слышал.
{
"api_version": "1.3",
"response_code": "200",
"total": "265",
"result": [
{
"id": "4504127908471392",
"lon": "37.6798458645247",
"lat": "55.6172926242175",
// ...
},
// ...
]
}](https://image.slidesharecdn.com/random-121021221549-phpapp01/85/2-Web-API-MVC-4-320.jpg)
![Сервис
GeoService extends DGService {
private $_request;
public function search() {
$data = Yii::app()->geo->search($this->_request-
>what, $this->_request->is_cool_place);
return $this->formatSearch($data)
}
private function formatSearch(array $data) {
$data['total'] = count($data);
return $data;
}
}](https://image.slidesharecdn.com/random-121021221549-phpapp01/85/2-Web-API-MVC-33-320.jpg)
Архитектура кода нового 2ГИС Web API или куда мы дели MVC
- 1. Архитектура кода новой версии справочного API . Или куда мы дели MVC? Сергей Коржнев 2ГИС
- 2. Кто такой? С какого района? Почему я такой дерзкий? ● Архитектор и идейный вдохновитель новой версии справочного API ● До этого приложился к картографическому API (javascript- библиотека) ● Также был замечен в рядах разработчиков Флампа
- 3. Справочное API? Не, не слышал. REST API http://catalog.api.2gis.ru/search ?what=музей &where=Москва &version=1.3 &key=1234567890 &output=json
- 4. Справочное API? Не, не слышал. { "api_version": "1.3", "response_code": "200", "total": "265", "result": [ { "id": "4504127908471392", "lon": "37.6798458645247", "lat": "55.6172926242175", // ... }, // ... ] }
- 5. Справочное API? Не, не слышал.
- 6. О чем доклад? ● Почему простой MVC не подходит для построения развесистого server-side API? ● Как сделать хорошо? ● Наш опыт
- 7. Как все начиналось? ... шел 2009 год, человечество еще не ...
- 8. Маленькие
- 9. Партнеры maps.2gis.ru Внешние партнеры
- 10. Внутренние и внешние партнеры
- 11. Единое API для всех. Фокусируемся.
- 12. Радостные пользователи ● Новые фичи ● Консистентность интерфейсов
- 13. Отказ от текущей версии
- 16. Почему простой MVC не подходит для построения развесистого server-side API?
- 18. Вопросы к Представлению? ● Тривиальные форматы JSON, JSONP, XML ● Yii-представление больше для HTML. ● Как, блин, рефакторить?
- 19. Вопросы к Контроллеру? ● Как его тестировать? ● Как быть когда фильтров и параметров много? ● Как быть нестандартным роутингом?
- 20. Когда много кода
- 21. Инструкция как сделать хорошо Шаг 1 - Распиливаем Модель Шаг 2 - Разводим зоопарк классов Шаг 3 - Анализируем результат
- 22. Model
- 23. Domain в extension'ах ● CApplicationComponent ● Yii::app()->geoCoder
- 24. Разруливание зависимостей return array( 'components' => array( 'geoCoder' => array( 'class' => 'ext.geoCoder.ExtGeoCoder', 'dbConnection' => 'geoDB', ), 'geoDB' => array( /* ... */), ), );
- 25. Инструкция как сделать хорошо Шаг 1 - Распиливаем Модель Шаг 2 - Разводим зоопарк классов Шаг 3 - Анализируем результаты
- 27. ServiceManager $result = ServiceManager::run($_REQUEST); echo $this->convert($result, 'JSON');
- 29. Запрос GeoSearchRequest extends RequestModel { public $what; public $is_cool_place; public function rules() { array('WhatValidator', 'min' => 2, 'max' =>50), array('BooleanValidator', 'param' => 'is_cool_place', 'required' => false), } }
- 31. Валидатор class WhatValidator extends Validator { public function run(RequestModel $model) { $this->checkRange( $model, 'what', $model->minLength, $model->maxLength ); } }
- 33. Сервис GeoService extends DGService { private $_request; public function search() { $data = Yii::app()->geo->search($this->_request- >what, $this->_request->is_cool_place); return $this->formatSearch($data) } private function formatSearch(array $data) { $data['total'] = count($data); return $data; } }
- 34. Структура директорий app/ services/ GeoService.php validators/ WhatValidator.php requests/ geo/ GeoSearchRequest.php
- 35. Инструкция как сделать хорошо Шаг 1 - Распиливаем Модель Шаг 2 - Разводим зоопарк классов Шаг 3 - Анализируем результаты
- 36. Что получилось? До После Filters Request, Validators Controller, View Service
- 37. Request, Validator ● Конфигурирование вместо программирования ● Строгость и безопасность ● Устранение дублирования кода
- 38. Service ● Чистый запрос ● Упрощение декомпозиции методов ● Unit-тесты
- 40. Profit ● Четкие обязанности компонентов ● Все на своих местах ● Консистентный интерфейс ● Единообразие кода ● Скорость разработки ● Unit-тесты
- 41. Итого ● +1 велосипед ● Заточили архитектуру под свои задачи ● Готовы к наращиванию функциональности API
- 42. Вопросы?