1: <?php
 2: /**
 3:  * Magento
 4:  *
 5:  * NOTICE OF LICENSE
 6:  *
 7:  * This source file is subject to the Open Software License (OSL 3.0)
 8:  * that is bundled with this package in the file LICENSE.txt.
 9:  * It is also available through the world-wide-web at this URL:
10:  * http://opensource.org/licenses/osl-3.0.php
11:  * If you did not receive a copy of the license and are unable to
12:  * obtain it through the world-wide-web, please send an email
13:  * to license@magentocommerce.com so we can send you a copy immediately.
14:  *
15:  * DISCLAIMER
16:  *
17:  * Do not edit or add to this file if you wish to upgrade Magento to newer
18:  * versions in the future. If you wish to customize Magento for your
19:  * needs please refer to http://www.magentocommerce.com for more information.
20:  *
21:  * @category    Mage
22:  * @package     Mage_Api2
23:  * @copyright   Copyright (c) 2012 Magento Inc. (http://www.magentocommerce.com)
24:  * @license     http://opensource.org/licenses/osl-3.0.php  Open Software License (OSL 3.0)
25:  */
26: 
27: /**
28:  * Webservice API2 renderer factory model
29:  *
30:  * @category   Mage
31:  * @package    Mage_Api2
32:  * @author     Magento Core Team <core@magentocommerce.com>
33:  */
34: abstract class Mage_Api2_Model_Renderer
35: {
36:     /**
37:      * Get Renderer of given type
38:      *
39:      * @param array|string $acceptTypes
40:      * @throws Mage_Api2_Exception
41:      * @throws Exception
42:      * @return Mage_Api2_Model_Renderer_Interface
43:      */
44:     public static function factory($acceptTypes)
45:     {
46:         /** @var $helper Mage_Api2_Helper_Data */
47:         $helper   = Mage::helper('api2');
48:         $adapters = $helper->getResponseRenderAdapters();
49: 
50:         if (!is_array($acceptTypes)) {
51:             $acceptTypes = array($acceptTypes);
52:         }
53: 
54:         $type = null;
55:         $adapterPath = null;
56:         foreach ($acceptTypes as $type) {
57:             foreach ($adapters as $item) {
58:                 $itemType = $item->type;
59:                 if ($type == $itemType
60:                     || $type == current(explode('/', $itemType)) . '/*' || $type == '*/*'
61:                 ) {
62:                     $adapterPath = $item->model;
63:                     break 2;
64:                 }
65:             }
66:         }
67: 
68:         //if server can't respond in any of accepted types it SHOULD send 406(not acceptable)
69:         if (null === $adapterPath) {
70:             throw new Mage_Api2_Exception(
71:                 'Server can not understand Accept HTTP header media type.',
72:                 Mage_Api2_Model_Server::HTTP_NOT_ACCEPTABLE
73:             );
74:         }
75: 
76:         $adapter = Mage::getModel($adapterPath);
77:         if (!$adapter) {
78:             throw new Exception(sprintf('Response renderer adapter for content type "%s" not found.', $type));
79:         }
80: 
81:         return $adapter;
82:     }
83: }
84: