Фрактал: практическое прохождение

Теперь мы применим преобразование и создадим выходной массив с использованием сериализатора . Мы собираемся использовать DataArraySerializer потому что это поместит наши данные под data-key в объекте JSON. Это позволяет вам иметь в своем ответе другую информацию, такую ​​как коды состояния или сообщения об ошибках. Чтобы использовать этот сериализатор, нам понадобится экземпляр класса manager. Для этого я буду использовать DI-контейнер, чтобы нам не приходилось каждый раз переписывать шаблонный код. Новый файл /controllers/tracks.php выглядит следующим образом:

 <?php $tracks = $app['controllers_factory']; $tracks->get('/', function() use ($app) { $tracks = Track::getTrackList(); $tracklist = new \League\Fractal\Resource\Collection($tracks, new TracklistTransformer); $output = $app['serializer']->createData($tracklist)->toArray(); return json_encode($output); }); return $tracks; 

Мы используем $tracklist = new \League\Fractal\Resource\Collection($tracks, new TracklistTransformer); применить преобразование. В этом маршруте мы используем коллекцию треков: наша переменная $tracks является объектом класса Illuminate \ Database \ Eloquent \ Collection . Этот класс совместим с Fractal и его преобразователями. Для другого маршрута мы будем использовать трансформатор для одного элемента таблицы. Но об этом чуть позже.

Для использования $app['serializer'] поместите этот код в index.php , прямо под оператором app['database'] :

 $app['serializer'] = $app->share(function() { $manager = new \League\Fractal\Manager(); $manager->setSerializer(new League\Fractal\Serializer\DataArraySerializer()); return $manager; }); 

Теперь у вас есть рабочий треклист.

Отслеживать информацию

Теперь я быстро продемонстрирую, как отображать информацию о конкретных дорожках, а затем вносить изменения в схему данных с помощью Fractal. Откройте controllers/tracks.php и добавьте следующий код над оператором возврата:

 <?php $tracks->get('/{id}', function($id) use ($app) { return Track::find($id); }); 

Track::find($id) возвращает объект класса Track с идентификатором, соответствующим URL. Опять же, это работает, но это не очень хороший способ, поэтому мы будем внедрять Fractal. Создайте новый трансформатор transformers/TrackTransformer.php :

 <?php namespace Musicstore; class TrackTransformer extends \League\Fractal\TransformerAbstract { public function transform(Track $track) { return [ 'id' => (int) $track->id, 'title' => $track->title, 'artist_name' => $track->artist_name, 'artist_website' => $track->artist_website, 'album_name' => $track->album_name, 'album_release' => $track->album_release, 'album_label' => $track->album_label ]; } } 

В вашем контроллере отредактируйте маршрут к этому:

 $tracks->get('/{id}', function($id) use ($app) { $track = Track::find($id); $track = new \League\Fractal\Resource\Item($track, new TrackTransformer); $output = $app['serializer']->createData($track)->toArray(); return json_encode($output); }); 

Как вы можете видеть, он довольно похож на предыдущий маршрут, за исключением того, что в данном случае мы имеем дело не с Collection а с одним Item . Если вы используете 1.sql вы можете перейти к localhost/app/tracks/1 1.sql localhost/app/tracks/1 и посмотреть некоторые примеры данных.

Обновленная версия API

Наш музыкальный магазин хочет расширяться и предоставлять больше информации об артистах и ​​альбомах. В новой схеме базы данных есть отдельные таблицы для художников и альбомов. Вы можете скачать 2.sql чтобы использовать новую схему. Таблицы выглядят так:

СЛЕДЫ:

• Я бы
• заглавие
• artist_id
• album_id

ХУДОЖНИКИ:

• Я бы
• имя
• интернет сайт

АЛЬБОМЫ:

• Я бы
• имя
• выпуск
• метка

В таблице дорожек столбцы исполнителя и альбома представляют собой целые числа, которые соответствуют строкам в соответствующих таблицах. Мы будем использовать трансформеры, чтобы сохранить нашу структуру вывода одинаковой. Чтобы упростить задачу, мы будем использовать некоторые функции Illuminate\Database . Зайдите в models/Track.php и добавьте еще два метода:

 public function artist() { return $this->belongsTo('\Musicstore\Artist'); } public function album() { return $this->belongsTo('\Musicstore\Album'); } 

Если у нас есть объект Track мы можем получить доступ к его Album и Artist , используя $track->album и $track->artist . Сначала нам нужно создать эти модели, поэтому создайте два файла models/Artist.php и models/Album.php :

 // models/Artist.php <?php namespace Musicstore; class Artist extends \Illuminate\Database\Eloquent\Model { public function tracks() { return $this->hasMany('\Musicstore\Track'); } } // models/Album.php <?php namespace Musicstore; class Album extends \Illuminate\Database\Eloquent\Model { public function tracks() { return $this->hasMany('\Musicstore\Track'); } } 

Последнее, что нам нужно сделать, это отредактировать наши трансформеры:

 // transformers/TrackTransformer.php return [ 'id' => (int) $track->id, 'title' => $track->title, 'artist_name' => $track->artist->name, 'artist_website' => $track->artist->website, 'album_name' => $track->album->name, 'album_release' => $track->album->release, 'album_label' => $track->album->label ]; // transformers/TracklistTransformer.php return [ 'id' => (int) $track->id, 'title' => $track->title, 'artist' => $track->artist->name ]; 

Если вы все протестируете, вы увидите, что это работает.

Вывод

Как я продемонстрировал, вы можете, добавив Fractal перед выводом, легко вносить изменения в базу данных, не замечая конечного пользователя. Вы можете скачать полный пример кода здесь в моем хранилище . Если что-то неясно, пожалуйста, не стесняйтесь оставлять комментарии.