add filestructur for pis

geoapi/api/PisApi.php

@@ -0,0 +1,185 @@
+<?php
+
+namespace api;
+
+include_once "../../global.inc.php";
+include_once PATH_DATABASE . "/SpsSqlManager.php";
+include_once PATH_UTILITTY . "/XmlManager.php";
+require_once PATH_API . "/Api.php";
+
+/**
+ * This class provides some spezial SpsAPI methods
+ * @author stubbfel
+ * @since 20.06.2013
+ */
+class SpsApi extends Api {
+
+    /**
+     * Keyword for alias arguments
+     * @var string
+     */
+    public static $keyAlias = "alias";
+
+    /**
+     * Keyword for domain arguments
+     * @var string
+     */
+    public static $keyDomain = "domain";
+
+    /**
+     * Keyword for polygon arguments
+     * @var string
+     */
+    public static $keyPoly = "poly";
+
+    /**
+     * Keyword for longitude arguments
+     * @var string
+     */
+    public static $keyLong = "longitude";
+
+    /**
+     * Keyword for latitude arguments
+     * @var string
+     */
+    public static $keyLat = "latitude";
+
+    /*
+     * Varible for the range of the searchpolygon
+     * @var float
+     */
+    private $range = 1;
+
+    /*
+     * Varible for the fist chars of the string for a Polygon
+     * @var string
+     */
+    private $polyStartStr = "GeomFromText('Polygon((";
+
+    /*
+     * Varible for the last chars of the string for a Polygon
+     * @var string
+     */
+    private $polyEndStr = "))'";
+
+    /**
+     * maximum value of latitude
+     * @var float
+     */
+    private $maxLat = 180;
+
+    /**
+     * minimum value of latitude
+     * @var float
+     */
+    private $minLat = -180;
+    
+        /**
+     * maximum value of longitude
+     * @var float
+     */
+    private $maxLong = 180;
+
+    /**
+     * minimum value of longitude
+     * @var float
+     */
+    private $minLong = -180;
+
+    /**
+     * Default-Constructor
+     */
+    public function __construct() {
+        $this->sqlManager = new \database\SpsSqlManager();
+        parent::__construct();
+        $this->contentType("Content-type: application/xml;charset=utf-8");
+    }
+
+    /**
+     * Default-DeConstructor
+     */
+    public function __destruct() {
+        parent::__destruct();
+    }
+
+    /**
+     * Method start a sps-query(alias)
+     * @param array $queryArgs
+     * @return querry result as xml
+     */
+    public function sendSpsAliasQuery($queryArgs = array()) {
+        $result = $this->sqlManager->sendSpsAliasQuery($queryArgs);
+        return \utiliy\XmlManager::arrayToSpsXml($result);
+    }
+
+    /**
+     * Method start a sps-query(Coordinates)
+     * @param array $queryArgs
+     * @return querry result as xml
+     */
+    public function sendSpsCoordinateQuery($queryArgs = array()) {
+        if (!array_key_exists(SpsApi::$keyLong, $queryArgs) || !array_key_exists(SpsApi::$keyLat, $queryArgs)) {
+            return null;
+        }
+        $latitude = $queryArgs[SpsApi::$keyLat];
+        $longitude = $queryArgs[SpsApi::$keyLong];
+
+        if (!$this->validLatitude($latitude) || !$this->validLongitude($longitude)) {
+            return null;
+        }
+
+        $queryArgs[SpsApi::$keyPoly] = $this->createPolygon($latitude, $longitude, $this->range);
+        $result = $this->sqlManager->sendSpsCoordinateQuery($queryArgs);
+        return \utiliy\XmlManager::arrayToSpsXml($result);
+    }
+
+    /**
+     * Method check if a string is a valid Longitude
+     * @param string $string
+     * @return bool
+     */
+    private function validLongitude($string) {
+        $digitLessPoint = str_replace(".", "", $string);
+        $digit = str_replace("-", "", $digitLessPoint);
+        if (ctype_digit($digit)) {
+            if ($string <= $this->maxLong && $string >= $this->minLong) {
+                return TRUE;
+            }
+        };
+        return FALSE;
+    }
+
+    /**
+     * Method check if a string is a valid Latitude
+     * @param strinf $string
+     * @return bool
+     */
+    private function validLatitude($string) {
+        $digitLessPoint = str_replace(".", "", $string);
+        $digit = str_replace("-", "", $digitLessPoint);
+        if (ctype_digit($digit)) {
+            if ($string <= $this->maxLat && $string >= $this->minLat) {
+                return TRUE;
+            }
+        };
+        return FALSE;
+    }
+
+    /**
+     * Method create a Polygon
+     * @param float $latitude
+     * @param float $longitude
+     * @param float $range
+     * @return string
+     */
+    private function createPolygon($latitude, $longitude, $range) {
+        $minLat = $latitude - $range;
+        $minLong = $longitude - $range;
+        $maxLat = $latitude + $range;
+        $maxLong = $longitude + $range;
+        return $this->polyStartStr . "$minLat $minLong,$minLat $maxLong,$maxLat $maxLong,$maxLat $minLong,$minLat $minLong" . $this->polyEndStr;
+    }
+
+}
+
+?>

geoapi/database/PisSqlManager.php

@@ -0,0 +1,229 @@
+<?php
+
+namespace database;
+
+include_once "../../global.inc.php";
+include_once PATH_UTILITTY . "/StringManager.php";
+require_once PATH_DATABASE . "/SqlManager.php";
+
+/**
+ * Description of SpsSqlManager
+ * 
+ * @author stubbfel
+ * @since 20.06.2013
+ */
+class SpsSqlManager extends SQLManager {
+
+    /**
+     * Default-Constructor
+     */
+    public function __construct() {
+        parent::__construct();
+    }
+
+    /**
+     * Default-DEConstructor
+     */
+    public function __destruct() {
+        parent::__destruct();
+    }
+
+    /**
+     * Fieldname of the placeID
+     * @var string
+     */
+    public static $placeId = "id";
+
+    /**
+     * Fieldname of the parendId
+     * @var string
+     */
+    public static $parentId = "parent";
+
+    /**
+     * String for the select part of the query
+     * @var string
+     */
+    private $selectTerm = "SELECT DISTINCT id, parent FROM sps WHERE ";
+
+    /**
+     * String for the alias part of the query
+     * @var string
+     */
+    private $aliasTerm = "alias = ";
+
+    /**
+     * String for the did part of the query
+     * @var string
+     */
+    private $domainTerm = "did = ";
+
+    /**
+     * String for the dNamet part of the query
+     * @var string
+     */
+    private $domainNameTerm = "dName = ";
+
+    /**
+     * first part of  intersect-function
+     * @var string
+     */
+    private $interSectTermStart = "Intersects(";
+
+    /**
+     * last part of  intersect-function
+     * @var string
+     */
+    private $interSectTermEnd = "),plan)";
+
+    /**
+     * first part of  GeomFromText('Polygon-function
+     * @var string
+     */
+    private $polyStartStr = "GeomFromText('Polygon((";
+
+    /**
+     * last part of  GeomFromText('Polygon-function
+     * @var string
+     */
+    private $polyEndStr = "))'";
+
+    /**
+     * maximium length of the value-string for an aliasname
+     * @var int
+     */
+    private $aliasMaxLenght = 32;
+
+    /**
+     * maximium length of the value-string for a domainname
+     * @var int
+     */
+    private $domainMaxLenght = 32;
+
+    /**
+     * Methods send an query for the sps-service depends of alias
+     * @param array $queryArgs
+     * @return array [num][assoc]
+     */
+    public function sendSpsAliasQuery($queryArgs = array()) {
+
+        // check arguments of the query
+        if (array_key_exists(\api\SpsApi::$keyAlias, $queryArgs)) {
+            $alias = $queryArgs[\api\SpsApi::$keyAlias];
+        } else {
+            return null;
+        }
+
+        $domain = null;
+        if (array_key_exists(\api\SpsApi::$keyDomain, $queryArgs)) {
+            $domain = $queryArgs[\api\SpsApi::$keyDomain];
+        }
+
+        // build query string
+        $query = $this->selectTerm;
+        if ($this->validAliasString($alias)) {
+            $query .= $this->aliasTerm . $this->quoteTerm . $alias . $this->quoteTerm . $this->addDomainTerm($domain);
+        } else {
+            return null;
+        }
+
+        // send query
+        return $this->query($query);
+    }
+
+    /**
+     * Methods send an query for the sps-service depends of coordinates
+     * @param array $queryArgs
+     * @return array [num][assoc]
+     */
+    public function sendSpsCoordinateQuery($queryArgs = array()) {
+
+        // check arguments of the query
+        if (array_key_exists(\api\SpsApi::$keyPoly, $queryArgs)) {
+            $poly = $queryArgs[\api\SpsApi::$keyPoly];
+        } else {
+            return null;
+        }
+
+        $domain = null;
+        if (array_key_exists(\api\SpsApi::$keyDomain, $queryArgs)) {
+            $domain = $queryArgs[\api\SpsApi::$keyDomain];
+        }
+
+        // build query string
+        if ($this->validPolyString($poly)) {
+            $query = $this->selectTerm . $this->interSectTermStart . $poly . $this->interSectTermEnd . $this->addDomainTerm($domain);
+        } else {
+            return null;
+        }
+
+        // send query
+        return $this->query($query);
+    }
+
+    /**
+     * Method create the correct domain part depends of $domain. If it is a number => did
+     * otherwise => dName
+     * @param string $domain
+     * @return string
+     */
+    private function addDomainTerm($domain) {
+        $result = null;
+        if ($domain != null && $this->validDomainString($domain)) {
+            if ($this->isDid($domain)) {
+                $result .= $this->andTerm . $this->domainTerm . $this->quoteTerm . $domain . $this->quoteTerm;
+            } else {
+                $result .= $this->andTerm . $this->domainNameTerm . $this->quoteTerm . $domain . $this->quoteTerm;
+            }
+        }
+        return $result;
+    }
+
+    /**
+     * Method check if the input value for the alias is valid
+     * @param string $alias
+     * @return boolean
+     */
+    private function validAliasString($alias) {
+        if ($this->validString($alias) && ctype_alnum($alias) && strlen($alias) <= $this->aliasMaxLenght) {
+            return TRUE;
+        }
+        return FALSE;
+    }
+
+    /**
+     * Method check if the input value for the alias is valid
+     * @param string $domain
+     * @return boolean
+     */
+    private function validDomainString($domain) {
+        if ($this->validString($domain) && ctype_alnum($domain) && strlen($domain) <= $this->domainMaxLenght) {
+            return TRUE;
+        }
+        return FALSE;
+    }
+
+    /**
+     * Method check if the input value for the polygon is valid
+     * @param string $poly
+     * @return boolean
+     */
+    private function validPolyString($poly) {
+        if ($this->validString($poly) && \utiliy\StringManager::startsWith($poly, $this->polyStartStr) && \utiliy\StringManager::endsWith($poly, $this->polyEndStr)) {
+            return TRUE;
+        }
+        return FALSE;
+    }
+
+    /**
+     *  Method check if the ntring is a did
+     * @param string $string
+     * @return boolean
+     */
+    private function isDid($string) {
+        return ctype_digit($string);
+    }
+
+}
+
+?>

geoapi/service/pis/.htaccess

@@ -0,0 +1,2 @@
+RewriteEngine  on
+RewriteRule ^ index.php [QSA,L]

geoapi/service/pis/index.php

@@ -0,0 +1,39 @@
+<?php
+
+include_once "../../global.inc.php";
+require_once PATH_API . "/SpsApi.php";
+
+// instance a new api
+$app = new \api\SpsApi();
+
+// declare the get-methods
+$app->get('/alias/:alias', function ($alias) use ($app) {
+            $args = array();
+            $args[\api\SpsApi::$keyAlias] = $alias;            
+            echo $app->sendSpsAliasQuery($args);
+        });
+
+$app->get('/alias/:alias/domain/:domain', function ($alias, $domain) use ($app) {
+            $args = array();
+            $args[\api\SpsApi::$keyAlias] = $alias;
+            $args[\api\SpsApi::$keyDomain] = $domain;              
+            echo $app->sendSpsAliasQuery($args);
+        });
+
+$app->get('/longitude/:longitude/latitude/:latitude', function ($longitude, $latitude) use ($app) {
+            $args = array();
+            $args[\api\SpsApi::$keyLong] = $longitude;
+            $args[\api\SpsApi::$keyLat] = $latitude;
+            echo ($app->sendSpsCoordinateQuery($args));
+        });
+
+$app->get('/longitude/:longitude/latitude/:latitude/domain/:domain', function ($longitude, $latitude, $domain) use ($app) {
+            $args = array();
+            $args[\api\SpsApi::$keyLong] = $longitude;
+            $args[\api\SpsApi::$keyLat] = $latitude;
+            $args[\api\SpsApi::$keyDomain] = $domain;
+            echo ($app->sendSpsCoordinateQuery($args));
+        });
+
+$app->run();
+?>