Source for file ResultConverter.php

Documentation is available at ResultConverter.php

  1. <?php
  2. require_once RDFAPI_INCLUDE_DIR . 'sparql/SparqlEngineDb/ResultRenderer.php';
  3.  
  4. /**
  5. *   Converts a database result into a proper
  6. *   rdf statement triple array
  7. *
  8. *   @author Christian Weiske <cweiske@cweiske.de>
  9. *
  10. *   @package sparql
  11. */
  12. class SparqlEngineDb_ResultConverter
  13. {
  14.     /**
  15.     *   Determines the correct renderer and calls it.
  16.     *
  17.     *   The $resultform may be:
  18.     *   - false: The default renderer is taken then
  19.     *   - an object that implements SparqlEngineDb_ResultRenderer interface
  20.     *   - a string like "HTML" or "XML". The appropriate renderer is used then.
  21.     *   - a full class name, e.g. SparqlEngineDb_ResultRenderer_XML
  22.     *
  23.     *   @param array    $arRecordSets   Array of anything ADOConnection::Execute() can return
  24.     *   @param SparqlEngineDb $engine   Sparql database engine.
  25.     *   @param mixed    $resultform     Which format the results shall be in (false or "xml")
  26.     *
  27.     *   @return mixed   Most likely an array or a boolean value,
  28.     *                    or anything else as determined by $resultform
  29.     */
  30.     public static function convertFromDbResults($arRecordSets, SparqlEngineDb $engine, $resultform = false)
  31.     {
  32.         if (is_object($resultform)) {
  33.             if ($resultform instanceof SparqlEngineDb_ResultRenderer) {
  34.                 return $resultform->convertFromDbResults(
  35.                     $arRecordSets,
  36.                     $engine->getQuery(),
  37.                     $engine
  38.                 );
  39.             } else {
  40.                 throw new Exception(
  41.                     'Result renderer object needs to implement'
  42.                     . ' SparqlEngineDb_ResultRenderer interface'
  43.                 );
  44.             }
  45.         }
  46.  
  47.         if ($resultform === false) {
  48.             $resultform = 'Default';
  49.         } else if ($resultform == 'xml') {
  50.             //kept for BC reasons
  51.             $resultform = 'XML';
  52.         }
  53.  
  54.         if ($strClass = self::loadClass($resultform)) {
  55.             $rrObj = new $strClass();
  56.             if ($rrObj instanceof SparqlEngineDb_ResultRenderer) {
  57.                 return $rrObj->convertFromDbResults(
  58.                     $arRecordSets,
  59.                     $engine->getQuery(),
  60.                     $engine
  61.                 );
  62.             } else {
  63.                 throw new Exception(
  64.                     'Result renderer class "' . $strClass . '" needs to implement'
  65.                     . ' SparqlEngineDb_ResultRenderer interface'
  66.                 );
  67.             }
  68.         } else {
  69.             throw new Exception(
  70.                 'Result renderer class "' . $resultform . '" could not be loaded.'
  71.             );
  72.         }
  73.     }//public static function convertFromDbResults($arRecordSets, SparqlEngineDb $engine, $resultform = false)
  74.  
  75.  
  76.  
  77.     /**
  78.     *   Tries to load a given class if it doesn't exist,
  79.     *   and returns true if the class can be used.
  80.     *
  81.     *   @param string $strClass Classname
  82.     *   @return mixed Class name if the class is loaded and can be used, false if not.
  83.     */
  84.     protected static function loadClass($strClass)
  85.     {
  86.         if (class_exists($strClass)) {
  87.             return $strClass;
  88.         }
  89.  
  90.         //RAP style, shortcut notation
  91.         $strFile = 'SparqlEngineDb/ResultRenderer/' . $strClass . '.php';
  92.         @include_once RDFAPI_INCLUDE_DIR . 'sparql/' . $strFile;
  93.         if (class_exists('SparqlEngineDb_ResultRenderer_' . $strClass)) {
  94.             return 'SparqlEngineDb_ResultRenderer_' . $strClass;
  95.         }
  96.  
  97.         //RAP style
  98.         $strFile = str_replace('_', '/', $strClass) . '.php';
  99.         @include_once RDFAPI_INCLUDE_DIR . 'sparql/' . $strFile;
  100.         if (class_exists($strClass)) {
  101.             return $strClass;
  102.         }
  103.  
  104.         //PEAR style
  105.         @include_once $strFile;
  106.         if (class_exists($strClass)) {
  107.             return $strClass;
  108.         }
  109.  
  110.         return false;
  111.     }//protected static function loadClass($strClass)
  112.  
  113. }//class SparqlEngineDb_ResultConverter
  114. ?>

Documentation generated on Fri, 1 Jun 2007 16:51:40 +0200 by phpDocumentor 1.3.2