home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / XML / RPC2 / Backend / Php / Value / Scalar.php < prev    next >
Encoding:
PHP Script  |  2008-07-02  |  5.9 KB  |  173 lines

  1. <?php
  2.  
  3. /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */
  4.  
  5. // LICENSE AGREEMENT. If folded, press za here to unfold and read license {{{ 
  6.  
  7. /**
  8. * +-----------------------------------------------------------------------------+
  9. * | Copyright (c) 2004-2006 Sergio Goncalves Carvalho                                |
  10. * +-----------------------------------------------------------------------------+
  11. * | This file is part of XML_RPC2.                                              |
  12. * |                                                                             |
  13. * | XML_RPC2 is free software; you can redistribute it and/or modify            |
  14. * | it under the terms of the GNU Lesser General Public License as published by |
  15. * | the Free Software Foundation; either version 2.1 of the License, or         |
  16. * | (at your option) any later version.                                         |
  17. * |                                                                             |
  18. * | XML_RPC2 is distributed in the hope that it will be useful,                 |
  19. * | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
  20. * | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
  21. * | GNU Lesser General Public License for more details.                         |
  22. * |                                                                             |
  23. * | You should have received a copy of the GNU Lesser General Public License    |
  24. * | along with XML_RPC2; if not, write to the Free Software                     |
  25. * | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA                    |
  26. * | 02111-1307 USA                                                              |
  27. * +-----------------------------------------------------------------------------+
  28. * | Author: Sergio Carvalho <sergio.carvalho@portugalmail.com>                  |
  29. * +-----------------------------------------------------------------------------+
  30. *
  31. * @category   XML
  32. * @package    XML_RPC2
  33. * @author     Sergio Carvalho <sergio.carvalho@portugalmail.com>  
  34. * @copyright  2004-2006 Sergio Carvalho
  35. * @license    http://www.gnu.org/copyleft/lesser.html  LGPL License 2.1
  36. * @version    CVS: $Id: Scalar.php,v 1.3 2006/01/22 01:58:22 fab Exp $
  37. * @link       http://pear.php.net/package/XML_RPC2
  38. */
  39.  
  40. // }}}
  41.  
  42. // dependencies {{{
  43. require_once 'XML/RPC2/Exception.php';
  44. require_once 'XML/RPC2/Backend/Php/Value.php';
  45. // }}}
  46.  
  47. /**
  48.  * XML_RPC scalar value abstract class. All XML_RPC value classes representing scalar types inherit from XML_RPC2_Value_Scalar
  49.  * 
  50.  * @category   XML
  51.  * @package    XML_RPC2
  52.  * @author     Sergio Carvalho <sergio.carvalho@portugalmail.com>  
  53.  * @copyright  2004-2006 Sergio Carvalho
  54.  * @license    http://www.gnu.org/copyleft/lesser.html  LGPL License 2.1
  55.  * @link       http://pear.php.net/package/XML_RPC2
  56.  */
  57. abstract class XML_RPC2_Backend_Php_Value_Scalar extends XML_RPC2_Backend_Php_Value
  58. {
  59.     
  60.     // {{{ properties
  61.     
  62.     /**
  63.      * scalar type
  64.      *
  65.      * @var string
  66.      */
  67.     private $_scalarType = null;
  68.     
  69.     // }}}
  70.     // {{{ setScalarType()
  71.  
  72.     /**
  73.      * scalarType property setter
  74.      *
  75.      * @param mixed value The new scalarType
  76.      */
  77.     protected function setScalarType($value) 
  78.     {
  79.         switch ($value) {
  80.             case 'int':
  81.             case 'i4':
  82.             case 'boolean':
  83.             case 'string':
  84.             case 'double': 
  85.             case 'dateTime.iso8601':
  86.             case 'base64':
  87.                 $this->_scalarType = $value;
  88.                 break;
  89.             default:
  90.                 throw new XML_RPC2_InvalidTypeException(sprintf('Type \'%s\' is not an XML-RPC scalar type', $value));
  91.         }
  92.     }
  93.     
  94.     // }}}
  95.     // {{{ getScalarType()
  96.     
  97.     /**
  98.      * scalarType property getter
  99.      *
  100.      * @return mixed The current scalarType
  101.      */
  102.     public function getScalarType() 
  103.     {
  104.         return $this->_scalarType;
  105.     }
  106.     
  107.     // }}}
  108.     // {{{ constructor
  109.  
  110.     /**
  111.      * Constructor. Will build a new XML_RPC2_Value_Scalar with the given nativeValue
  112.      *
  113.      * @param mixed nativeValue
  114.      */
  115.     public function __construct($scalarType, $nativeValue) 
  116.     {
  117.         $this->setScalarType($scalarType);
  118.         $this->setNativeValue($nativeValue);
  119.     }
  120.     
  121.     // }}}
  122.     // {{{ createFromNative()
  123.     
  124.     /**
  125.      * Choose a XML_RPC2_Value subclass appropriate for the 
  126.      * given value and create it.
  127.      * 
  128.      * @param string The native value
  129.      * @param string Optinally, the scalar type to use
  130.      * @throws XML_RPC2_InvalidTypeEncodeException When native value's type is not a native type
  131.      * @return XML_RPC2_Value The newly created value
  132.      */
  133.     public static function createFromNative($nativeValue, $explicitType = null)
  134.     {
  135.         if (is_null($explicitType)) {
  136.             switch (gettype($nativeValue)) {
  137.                 case 'boolean':
  138.                 case 'integer':
  139.                 case 'double':
  140.                 case 'string':
  141.                     $explicitType = gettype($nativeValue);
  142.                     break;
  143.                 default:
  144.                     throw new XML_RPC2_InvalidTypeEncodeException(sprintf('Impossible to encode scalar value \'%s\' from type \'%s\'. Native type is not a scalar XML_RPC type (boolean, integer, double, string)',
  145.                         (string) $nativeValue,
  146.                         gettype($nativeValue)));
  147.             }
  148.         }
  149.         $explicitType = ucfirst(strtolower($explicitType));
  150.         require_once(sprintf('XML/RPC2/Backend/Php/Value/%s.php', $explicitType));
  151.         $explicitType = sprintf('XML_RPC2_Backend_Php_Value_%s', $explicitType);
  152.         return new $explicitType($nativeValue);
  153.     }
  154.     
  155.     // }}}
  156.     // {{{ encode()
  157.     
  158.     /**
  159.      * Encode the instance into XML, for transport
  160.      * 
  161.      * @return string The encoded XML-RPC value,
  162.      */
  163.     public function encode() 
  164.     {
  165.         return '<' . $this->getScalarType() . '>' . $this->getNativeValue() . '</' . $this->getScalarType() . '>';
  166.     }
  167.     
  168.     // }}}
  169.     
  170. }
  171.  
  172. ?>
  173.