list airports api

app/Http/Controllers/AirportController.php

@@ -2,7 +2,19 @@
 
 namespace App\Http\Controllers;
 
-use GuzzleHttp\Psr7\Request;
+use App\Libraries\IotaCodes\Airport;
+use App\Libraries\IotaCodes\AirportTransformer;
+use App\Libraries\IotaCodes\Client;
+use Illuminate\Http\Request;
+use Illuminate\Pagination\LengthAwarePaginator;
+use League\Fractal\Manager;
+use League\Fractal\Pagination\IlluminatePaginatorAdapter;
+use League\Fractal\Resource\Collection;
+use League\Fractal\Resource\Item;
+use League\Fractal\Resource\ResourceInterface;
+use League\Fractal\Serializer\JsonApiSerializer;
+
+//use GuzzleHttp\Psr7\Request;
 
 class AirportController extends Controller
 {
@@ -15,14 +27,76 @@ class AirportController extends Controller
     {
         //
     }
-
+    
+    /**
+     * Fetch list of airports
+     *
+     * @api {get} /airports
+     * @apiName List Airports
+     *
+     * @apiParam (pagination) {number} [page] page number to display
+     * @apiParam (pagination) {number} [per_page] number of items to display on the page
+     *
+     * @apiParam (autocomplete) {string} [autocomplete] string to try and autocomplete
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
     public function resourceList(Request $request)
     {
-        //todo
+        $client = Client::create();
+        $per_page = $request->input('per_page', 10);
+        $page = $request->input('page', 1);
+        
+        $collection = $client->listAirports($request->input('autocomplete'));
+        $paginator = new LengthAwarePaginator(
+            $collection->forPage($page, $per_page),
+            $collection->count(),
+            $per_page,
+            $page
+        );
+    
+        $airports = new Collection($paginator, new AirportTransformer(), 'airports');
+        $airports->setPaginator(new IlluminatePaginatorAdapter($paginator));
+        
+        return $this->JsonApiResponse($airports, 200);
     }
-
-    public function get(Request $request)
+    
+    /**
+     * Get details of an airport by it's code
+     *
+     * @api {get} /airports/:code
+     * @apiName Get Airport from code
+     *
+     * @apiParam {string} code 3 letter airport code
+     *
+     * @param \Illuminate\Http\Request $request
+     * @param $code
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function getAirport(Request $request, $code)
     {
-        //
+        $client = Client::create();
+        
+        $result = $client->getAirport($code);
+        $result = new Item($result, new AirportTransformer(), 'airports');
+    
+        return $this->JsonApiResponse($result, 200);
+    }
+    
+    
+    /**
+     * Convert the response to Json
+     *
+     * @param \League\Fractal\Resource\Item $resource
+     * @param $statusCode
+     * @return \Illuminate\Http\JsonResponse
+     */
+    protected function JsonApiResponse(ResourceInterface $resource, $statusCode)
+    {
+        $manager = new Manager();
+        $manager->setSerializer(new JsonApiSerializer('http://docker.dev:8080'));
+        
+        return response()->json($manager->createData($resource)->toArray(), $statusCode);
     }
 }

app/Libraries/IotaCodes/Airport.php

@@ -0,0 +1,21 @@
+<?php
+namespace App\Libraries\IotaCodes;
+
+class Airport
+{
+    
+    public $name;
+    
+    public $code;
+    
+    protected function __construct($name, $code)
+    {
+        $this->name = $name;
+        $this->code = $code;
+    }
+    
+    public static function create($name, $code)
+    {
+        return new self($name, $code);
+    }
+}

app/Libraries/IotaCodes/AirportTransformer.php

@@ -0,0 +1,19 @@
+<?php
+namespace App\Libraries\IotaCodes;
+
+use League\Fractal\TransformerAbstract;
+
+class AirportTransformer extends TransformerAbstract
+{
+    public function transform(Airport $airport)
+    {
+        return [
+            'id'        => $airport->code,
+            'name'      => $airport->name,
+            'links'   => [
+                'rel'  => 'self',
+                'uri' => '/airports/'.$airport->code,
+            ]
+        ];
+    }
+}

app/Libraries/IotaCodes/Client.php

@@ -0,0 +1,117 @@
+<?php
+namespace App\Libraries\IotaCodes;
+
+use GuzzleHttp\Client as Guzzle;
+use Illuminate\Support\Collection;
+
+class Client
+{
+    /**
+     * Guzzle Client
+     * @var Guzzle
+     */
+    protected $guzzle;
+    
+    /**
+     * Client constructor.
+     * @param \GuzzleHttp\Client $guzzle
+     * @param array $config
+     */
+    public function __construct(Guzzle $guzzle, array $config = [])
+    {
+        $this->guzzle = $guzzle;
+    }
+    
+    public static function create()
+    {
+        return new self(new Guzzle([
+            'base_uri' => 'https://iatacodes.org',
+            'timeout'  => 5.0,
+            'verify'   => false
+        ]));
+    }
+    
+    public function listAirports($autoComplete = '')
+    {
+        $uri = '/api/v6/airports';
+        $key = 'all.airports';
+        $minutes = 60;
+    
+        $response = app('cache')->get($key, function () use ($key, $minutes, $uri) {
+            try {
+                /** @var \Psr\Http\Message\ResponseInterface $response */
+                $response = $this->guzzle->get($uri, [
+                    'query' => [
+                        'lang'    => 'en',
+                        'api_key' => '8105c628-a86c-41af-85da-828bcf8190e0'
+                    ],
+                ]);
+    
+            } catch (\Exception $e) {
+                //todo handle error
+            }
+            
+            $result = $response->getBody()->getContents();
+            app('cache')->put($key, $result, $minutes);
+            return $result;
+        });
+        
+        $result = $this->toAirportCollection($response);
+        if ($autoComplete != '') {
+            $result = $this->autoCompleteMap($result, $autoComplete);
+        }
+        return $result;
+    }
+    
+    public function getAirport($code)
+    {
+        $uri = '/api/v6/airports';
+        $cacheKey = 'airport.'.$code;
+        $cacheMinutes = 60;
+    
+        $response = app('cache')->get($cacheKey, function () use ($cacheKey, $cacheMinutes, $uri, $code) {
+            try {
+                /** @var \Psr\Http\Message\ResponseInterface $response */
+                $response = $this->guzzle->get($uri, [
+                    'query' => [
+                        'code'    => $code,
+                        'lang'    => 'en',
+                        'api_key' => '8105c628-a86c-41af-85da-828bcf8190e0'
+                    ],
+                ]);
+            
+            } catch (\Exception $e) {
+                //todo handle error
+            }
+        
+            $result = $response->getBody()->getContents();
+            app('cache')->put($cacheKey, $result, $cacheMinutes);
+            return $result;
+        });
+    
+        return $result = $this->toAirportCollection($response)->first();
+    }
+    
+    /**
+     * @param $json string
+     * @return \Illuminate\Support\Collection
+     */
+    private function toAirportCollection($json)
+    {
+        $data = json_decode($json);
+        $result = (new Collection($data->response))
+            ->sortBy('name')
+            ->map(function ($item, $key) {
+            return Airport::create($item->name, $item->code);
+        });
+        
+        return $result;
+    }
+    
+    private function autoCompleteMap(Collection $collection, $autoComplete)
+    {
+        return $collection->filter(function ($value, $key) use ($autoComplete) {
+            return strpos(strtolower($value->name), strtolower($autoComplete)) !== false;
+        });
+    }
+}