Chris@0: <?php
Chris@0: 
Chris@0: /*
Chris@0:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
Chris@0:  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
Chris@0:  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
Chris@0:  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
Chris@0:  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
Chris@0:  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
Chris@0:  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
Chris@0:  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
Chris@0:  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
Chris@0:  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Chris@0:  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Chris@0:  *
Chris@0:  * This software consists of voluntary contributions made by many individuals
Chris@0:  * and is licensed under the MIT license. For more information, see
Chris@0:  * <http://www.doctrine-project.org>.
Chris@0:  */
Chris@0: 
Chris@0: namespace Doctrine\Common\Annotations\Annotation;
Chris@0: 
Chris@0: /**
Chris@0:  * Annotation that can be used to signal to the parser
Chris@0:  * to check the annotation target during the parsing process.
Chris@0:  *
Chris@0:  * @author Fabio B. Silva <fabio.bat.silva@gmail.com>
Chris@0:  *
Chris@0:  * @Annotation
Chris@0:  */
Chris@0: final class Target
Chris@0: {
Chris@0:     const TARGET_CLASS              = 1;
Chris@0:     const TARGET_METHOD             = 2;
Chris@0:     const TARGET_PROPERTY           = 4;
Chris@0:     const TARGET_ANNOTATION         = 8;
Chris@0:     const TARGET_ALL                = 15;
Chris@0: 
Chris@0:     /**
Chris@0:      * @var array
Chris@0:      */
Chris@0:     private static $map = array(
Chris@0:         'ALL'        => self::TARGET_ALL,
Chris@0:         'CLASS'      => self::TARGET_CLASS,
Chris@0:         'METHOD'     => self::TARGET_METHOD,
Chris@0:         'PROPERTY'   => self::TARGET_PROPERTY,
Chris@0:         'ANNOTATION' => self::TARGET_ANNOTATION,
Chris@0:     );
Chris@0: 
Chris@0:     /**
Chris@0:      * @var array
Chris@0:      */
Chris@0:     public $value;
Chris@0: 
Chris@0:     /**
Chris@0:      * Targets as bitmask.
Chris@0:      *
Chris@0:      * @var integer
Chris@0:      */
Chris@0:     public $targets;
Chris@0: 
Chris@0:     /**
Chris@0:      * Literal target declaration.
Chris@0:      *
Chris@0:      * @var integer
Chris@0:      */
Chris@0:     public $literal;
Chris@0: 
Chris@0:     /**
Chris@0:      * Annotation constructor.
Chris@0:      *
Chris@0:      * @param array $values
Chris@0:      *
Chris@0:      * @throws \InvalidArgumentException
Chris@0:      */
Chris@0:     public function __construct(array $values)
Chris@0:     {
Chris@0:         if (!isset($values['value'])){
Chris@0:             $values['value'] = null;
Chris@0:         }
Chris@0:         if (is_string($values['value'])){
Chris@0:             $values['value'] = array($values['value']);
Chris@0:         }
Chris@0:         if (!is_array($values['value'])){
Chris@0:             throw new \InvalidArgumentException(
Chris@0:                 sprintf('@Target expects either a string value, or an array of strings, "%s" given.',
Chris@0:                     is_object($values['value']) ? get_class($values['value']) : gettype($values['value'])
Chris@0:                 )
Chris@0:             );
Chris@0:         }
Chris@0: 
Chris@0:         $bitmask = 0;
Chris@0:         foreach ($values['value'] as $literal) {
Chris@0:             if(!isset(self::$map[$literal])){
Chris@0:                 throw new \InvalidArgumentException(
Chris@0:                     sprintf('Invalid Target "%s". Available targets: [%s]',
Chris@0:                             $literal,  implode(', ', array_keys(self::$map)))
Chris@0:                 );
Chris@0:             }
Chris@0:             $bitmask |= self::$map[$literal];
Chris@0:         }
Chris@0: 
Chris@0:         $this->targets  = $bitmask;
Chris@0:         $this->value    = $values['value'];
Chris@0:         $this->literal  = implode(', ', $this->value);
Chris@0:     }
Chris@0: }