JAPI Maintenance Exception (#11)

* Listen for maintenance exceptions and return the appropriate response code

* Update message

Author: mikegsmith76

src/Docnet/JAPI.php

@@ -18,6 +18,7 @@
 
 use \Docnet\JAPI\Exceptions\Routing as RoutingException;
 use \Docnet\JAPI\Exceptions\Auth as AuthException;
+use \Docnet\JAPI\Exceptions\Maintenance as MaintenanceException;
 
 /**
  * Front controller for our JSON APIs
@@ -74,10 +75,16 @@ public function run()
             $obj_router = $this->getRouter();
             $obj_router->route();
             $obj_router->dispatch();
+
+        } catch (MaintenanceException $obj_ex) {
+            $this->jsonError('Service Temporarily Unavailable', 503);
+
         } catch (RoutingException $obj_ex) {
             $this->jsonError($obj_ex, 404);
+
         } catch (AuthException $obj_ex) {
             $this->jsonError($obj_ex, 401);
+
         } catch (\Exception $obj_ex) {
             $this->jsonError($obj_ex);
         }
@@ -114,6 +121,9 @@ protected function jsonError($mix_message = NULL, $int_code = 500)
             case 404:
                 header($_SERVER["SERVER_PROTOCOL"] . " 404 Not Found", TRUE, 404);
                 break;
+            case 503:
+                header($_SERVER["SERVER_PROTOCOL"] . " 503 Service Unavailable", TRUE, 503);
+                break;
             case 500:
             default:
                 header($_SERVER["SERVER_PROTOCOL"] . " 500 Internal Server Error", TRUE, 500);

src/Docnet/JAPI/Exceptions/Maintenance.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * Copyright 2014 Docnet
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+namespace Docnet\JAPI\Exceptions;
+
+/**
+ * Class Maintenance
+ *
+ * @author Mike Smith <[email protected]>
+ * @package Docnet\JAPI\Exceptions
+ */
+class Maintenance extends \Exception
+{
+}