This repository has been archived by the owner on Jan 29, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 37
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'git/namespace-pass3' into git/development-2.0
- Loading branch information
Showing
52 changed files
with
1,752 additions
and
722 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,350 @@ | ||
<?php | ||
/** | ||
* Zend Framework | ||
* | ||
* LICENSE | ||
* | ||
* This source file is subject to the new BSD license that is bundled | ||
* with this package in the file LICENSE.txt. | ||
* It is also available through the world-wide-web at this URL: | ||
* http://framework.zend.com/license/new-bsd | ||
* If you did not receive a copy of the license and are unable to | ||
* obtain it through the world-wide-web, please send an email | ||
* to [email protected] so we can send you a copy immediately. | ||
* | ||
* @category Zend | ||
* @package Zend_Barcode | ||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com) | ||
* @license http://framework.zend.com/license/new-bsd New BSD License | ||
* @version $Id$ | ||
*/ | ||
|
||
/** | ||
* @namespace | ||
*/ | ||
namespace Zend\Barcode; | ||
use Zend\Barcode\Renderer; | ||
use Zend\Loader; | ||
use Zend\Config; | ||
use Zend; | ||
|
||
/** | ||
* Class for generate Barcode | ||
* | ||
* @uses \Zend\Barcode\Exception | ||
* @uses \Zend\Barcode\Object\ObjectInterface | ||
* @uses \Zend\Loader | ||
* @category Zend | ||
* @package Zend_Barcode | ||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com) | ||
* @license http://framework.zend.com/license/new-bsd New BSD License | ||
*/ | ||
class Barcode | ||
{ | ||
/** | ||
* Default barcode TTF font name | ||
* | ||
* It's used by standard barcode objects derived from | ||
* {@link \Zend\Barcode\Object\AbstractObject} class | ||
* if corresponding constructor option is not provided. | ||
* | ||
* @var string | ||
*/ | ||
protected static $_staticFont = null; | ||
|
||
/** | ||
* Factory for Zend_Barcode classes. | ||
* | ||
* First argument may be a string containing the base of the adapter class | ||
* name, e.g. 'int25' corresponds to class \Zend\Barcode\Object\Int25. This | ||
* is case-insensitive. | ||
* | ||
* First argument may alternatively be an object of type \Zend\Config\Config. | ||
* The barcode class base name is read from the 'barcode' property. | ||
* The barcode config parameters are read from the 'params' property. | ||
* | ||
* Second argument is optional and may be an associative array of key-value | ||
* pairs. This is used as the argument to the barcode constructor. | ||
* | ||
* If the first argument is of type \Zend\Config\Config, it is assumed to contain | ||
* all parameters, and the second argument is ignored. | ||
* | ||
* @param mixed $barcode String name of barcode class, or \Zend\Config\Config\Config object. | ||
* @param mixed $renderer String name of renderer class | ||
* @param mixed $barcodeConfig OPTIONAL; an array or \Zend\Config\Config object with barcode parameters. | ||
* @param mixed $rendererConfig OPTIONAL; an array or \Zend\Config\Config object with renderer parameters. | ||
* @param boolean $automaticRenderError OPTIONAL; set the automatic rendering of exception | ||
* @return \Zend\Barcode\Barcode | ||
* @throws \Zend\Barcode\Exception | ||
*/ | ||
public static function factory($barcode, | ||
$renderer = 'image', | ||
$barcodeConfig = array(), | ||
$rendererConfig = array(), | ||
$automaticRenderError = true) | ||
{ | ||
/* | ||
* Convert \Zend\Config\Config argument to plain string | ||
* barcode name and separate config object. | ||
*/ | ||
if ($barcode instanceof Config\Config) { | ||
if (isset($barcode->rendererParams)) { | ||
$rendererConfig = $barcode->rendererParams->toArray(); | ||
} | ||
if (isset($barcode->renderer)) { | ||
$renderer = (string) $barcode->renderer; | ||
} | ||
if (isset($barcode->barcodeParams)) { | ||
$barcodeConfig = $barcode->barcodeParams->toArray(); | ||
} | ||
if (isset($barcode->barcode)) { | ||
$barcode = (string) $barcode->barcode; | ||
} else { | ||
$barcode = null; | ||
} | ||
} | ||
|
||
try { | ||
$barcode = self::makeBarcode($barcode, $barcodeConfig); | ||
$renderer = self::makeRenderer($renderer, $rendererConfig); | ||
} catch (Zend\Exception $e) { | ||
$renderable = ($e instanceof Exception) ? $e->isRenderable() : false; | ||
if ($automaticRenderError && $renderable) { | ||
$barcode = self::makeBarcode('error', array( 'text' => $e->getMessage() )); | ||
$renderer = self::makeRenderer($renderer, array()); | ||
} else { | ||
throw $e; | ||
} | ||
} | ||
|
||
$renderer->setAutomaticRenderError($automaticRenderError); | ||
return $renderer->setBarcode($barcode); | ||
} | ||
|
||
/** | ||
* Barcode Constructor | ||
* | ||
* @param mixed $barcode String name of barcode class, or \Zend\Config\Config object, or barcode object. | ||
* @param mixed $barcodeConfig OPTIONAL; an array or \Zend\Config\Config object with barcode parameters. | ||
* @return \Zend\Barcode\Object | ||
*/ | ||
public static function makeBarcode($barcode, $barcodeConfig = array()) | ||
{ | ||
if ($barcode instanceof Object\ObjectInterface) { | ||
return $barcode; | ||
} | ||
|
||
/* | ||
* Convert \Zend\Config\Config argument to plain string | ||
* barcode name and separate config object. | ||
*/ | ||
if ($barcode instanceof Config\Config) { | ||
if (isset($barcode->barcodeParams) && $barcode->barcodeParams instanceof Config\Config) { | ||
$barcodeConfig = $barcode->barcodeParams->toArray(); | ||
} | ||
if (isset($barcode->barcode)) { | ||
$barcode = (string) $barcode->barcode; | ||
} else { | ||
$barcode = null; | ||
} | ||
} | ||
if ($barcodeConfig instanceof Config\Config) { | ||
$barcodeConfig = $barcodeConfig->toArray(); | ||
} | ||
|
||
/* | ||
* Verify that barcode parameters are in an array. | ||
*/ | ||
if (!is_array($barcodeConfig)) { | ||
throw new Exception( | ||
'Barcode parameters must be in an array or a \Zend\Config\Config object' | ||
); | ||
} | ||
|
||
/* | ||
* Verify that an barcode name has been specified. | ||
*/ | ||
if (!is_string($barcode) || empty($barcode)) { | ||
throw new Exception( | ||
'Barcode name must be specified in a string' | ||
); | ||
} | ||
/* | ||
* Form full barcode class name | ||
*/ | ||
$barcodeNamespace = '\Zend\Barcode\Object'; | ||
if (isset($barcodeConfig['barcodeNamespace'])) { | ||
$barcodeNamespace = $barcodeConfig['barcodeNamespace']; | ||
} | ||
|
||
/** @todo Check if it's correct to drop case transformation */ | ||
$barcodeName = $barcodeNamespace . '\\' . ucfirst($barcode); | ||
|
||
/* | ||
* Load the barcode class. | ||
* Important! This throws an exception if the specified class cannot be loaded. | ||
*/ | ||
if (!class_exists($barcodeName, false)) { | ||
Loader::loadClass($barcodeName); | ||
} | ||
|
||
/* | ||
* Create an instance of the barcode class. | ||
* Pass the config to the barcode class constructor. | ||
*/ | ||
$bcAdapter = new $barcodeName($barcodeConfig); | ||
|
||
/* | ||
* Verify that the object created is a descendent of the abstract barcode type. | ||
*/ | ||
if (!$bcAdapter instanceof Object\ObjectInterface) { | ||
throw new Exception( | ||
"Barcode class '$barcodeName' does not implement \Zend\Barcode\Object\ObjectInterface" | ||
); | ||
} | ||
return $bcAdapter; | ||
} | ||
|
||
/** | ||
* Renderer Constructor | ||
* | ||
* @param mixed $renderer String name of renderer class, or \Zend\Config\Config object. | ||
* @param mixed $rendererConfig OPTIONAL; an array or \Zend\Config\Config object with renderer parameters. | ||
* @return \Zend\Barcode\Renderer\RendererInterface | ||
*/ | ||
public static function makeRenderer($renderer = 'image', $rendererConfig = array()) | ||
{ | ||
if ($renderer instanceof Renderer\RendererInterface) { | ||
return $renderer; | ||
} | ||
|
||
/* | ||
* Convert \Zend\Config\Config argument to plain string | ||
* barcode name and separate config object. | ||
*/ | ||
if ($renderer instanceof Config\Config) { | ||
if (isset($renderer->rendererParams)) { | ||
$rendererConfig = $renderer->rendererParams->toArray(); | ||
} | ||
if (isset($renderer->renderer)) { | ||
$renderer = (string) $renderer->renderer; | ||
} | ||
} | ||
if ($rendererConfig instanceof Config\Config) { | ||
$rendererConfig = $rendererConfig->toArray(); | ||
} | ||
|
||
/* | ||
* Verify that barcode parameters are in an array. | ||
*/ | ||
if (!is_array($rendererConfig)) { | ||
$e = new Exception( | ||
'Barcode parameters must be in an array or a \Zend\Config\Config object' | ||
); | ||
$e->setIsRenderable(false); | ||
throw $e; | ||
} | ||
|
||
/* | ||
* Verify that an barcode name has been specified. | ||
*/ | ||
if (!is_string($renderer) || empty($renderer)) { | ||
$e = new Exception( | ||
'Renderer name must be specified in a string' | ||
); | ||
$e->setIsRenderable(false); | ||
throw $e; | ||
} | ||
|
||
/* | ||
* Form full barcode class name | ||
*/ | ||
$rendererNamespace = '\Zend\Barcode\Renderer'; | ||
if (isset($rendererConfig['rendererNamespace'])) { | ||
$rendererNamespace = $rendererConfig['rendererNamespace']; | ||
} | ||
|
||
/** @todo Check if it's correct to drop case transformation */ | ||
$rendererName = $rendererNamespace . '\\' . ucfirst($renderer); | ||
|
||
/* | ||
* Load the renderer class. | ||
* Important! This throws an exception if the specified class cannot be loaded. | ||
*/ | ||
if (!class_exists($rendererName, false)) { | ||
Loader::loadClass($rendererName); | ||
} | ||
|
||
/* | ||
* Create an instance of the barcode class. | ||
* Pass the config to the barcode class constructor. | ||
*/ | ||
$rdrAdapter = new $rendererName($rendererConfig); | ||
|
||
/* | ||
* Verify that the object created is a descendent of the abstract barcode type. | ||
*/ | ||
if (!$rdrAdapter instanceof Renderer\RendererInterface) { | ||
$e = new Exception( | ||
"Renderer class '$rendererName' does not implements \Zend\Barcode\Renderer\RendererInterface" | ||
); | ||
$e->setIsRenderable(false); | ||
throw $e; | ||
} | ||
return $rdrAdapter; | ||
} | ||
|
||
/** | ||
* Proxy to renderer render() method | ||
* | ||
* @param string | \Zend\Barcode\Object\ObjectInterface | array | \Zend\Config\Config $barcode | ||
* @param string | \Zend\Barcode\Renderer\RendererInterface $renderer | ||
* @param array | \Zend\Config\Config $barcodeConfig | ||
* @param array | \Zend\Config\Config $rendererConfig | ||
*/ | ||
public static function render($barcode, | ||
$renderer, | ||
$barcodeConfig = array(), | ||
$rendererConfig = array()) | ||
{ | ||
self::factory($barcode, $renderer, $barcodeConfig, $rendererConfig)->render(); | ||
} | ||
|
||
/** | ||
* Proxy to renderer draw() method | ||
* | ||
* @param string | \Zend\Barcode\Object\ObjectInterface | array | \Zend\Config\Config $barcode | ||
* @param string | \Zend\Barcode\Renderer\RendererInterface $renderer | ||
* @param array | \Zend\Config\Config $barcodeConfig | ||
* @param array | \Zend\Config\Config $rendererConfig | ||
* @return mixed | ||
*/ | ||
public static function draw($barcode, | ||
$renderer, | ||
$barcodeConfig = array(), | ||
$rendererConfig = array()) | ||
{ | ||
return self::factory($barcode, $renderer, $barcodeConfig, $rendererConfig)->draw(); | ||
} | ||
|
||
/** | ||
* Set the default font for new instances of barcode | ||
* | ||
* @param string $font | ||
* @return void | ||
*/ | ||
public static function setBarcodeFont($font) | ||
{ | ||
self::$_staticFont = $font; | ||
} | ||
|
||
/** | ||
* Get current default font | ||
* | ||
* @return string | ||
*/ | ||
public static function getBarcodeFont() | ||
{ | ||
return self::$_staticFont; | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.