| <?php |
| /** |
| * File containing the ezcConsoleOptionRule class. |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| * @package ConsoleTools |
| * @version //autogentag// |
| * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved. |
| * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0 |
| * @filesource |
| */ |
| |
| /** |
| * Struct class to store a parameter rule. |
| * |
| * This struct stores relation rules between parameters. A relation consists of |
| * a parameter that the relation refers to and optionally the value(s) the |
| * referred parameter may have assigned. Rules may be used for dependencies and |
| * exclusions between parameters. |
| * |
| * The ezcConsoleOptionRule class has the following properties: |
| * - <b>option</b> <i>ezcConsoleOption</i>, contains the parameter that this rule refers to. |
| * - <b>values</b> <i>array(string)</i>, contains a list of values that are accepted. |
| * |
| * @see ezcConsoleOption |
| * |
| * @package ConsoleTools |
| * @version //autogen// |
| */ |
| class ezcConsoleOptionRule |
| { |
| /** |
| * Properties. |
| * |
| * @var array |
| */ |
| protected $properties = array( |
| 'option' => null, |
| 'values' => array(), |
| 'ifSet' => true |
| ); |
| |
| /** |
| * Creates a new option rule. |
| * |
| * Creates a new option rule. Per default the $values parameter |
| * is an empty array, which determines that the option may accept any |
| * value. To indicate that a option may only have certain values, |
| * place them inside tha $values array. For example to indicate an option |
| * may have the values 'a', 'b' and 'c' use: |
| * |
| * <code> |
| * $rule = new ezcConsoleOptionRule( $option, array( 'a', 'b', 'c' ) ); |
| * </code> |
| * |
| * If you want to allow only 1 specific value for an option, you do not |
| * need to wrap this into an array, when creating the rule. Simply use |
| * |
| * <code> |
| * $rule = new ezcConsoleOptionRule( $option, 'a' ); |
| * </code> |
| * |
| * to create a rule, that allows the desired option only to accept the |
| * value 'a'. |
| * |
| * The $ifSet parameter determines, if the rule is validated when its option |
| * is set or left out. If $ifSet is true, the rule is validated when the |
| * option is set. Otherwise the rule is validated if the option was not set |
| * by the user. |
| * |
| * @param ezcConsoleOption $option The option to refer to. |
| * @param mixed $values The affected values. |
| * @param bool $ifSet |
| */ |
| public function __construct( ezcConsoleOption $option, array $values = array(), $ifSet = true ) |
| { |
| $this->__set( 'option', $option ); |
| $this->__set( 'values', $values ); |
| $this->__set( 'ifSet', $ifSet ); |
| } |
| |
| /** |
| * Property read access. |
| * |
| * @throws ezcBasePropertyNotFoundException |
| * If the the desired property is not found. |
| * |
| * @param string $propertyName Name of the property. |
| * @return mixed Value of the property or null. |
| * @ignore |
| */ |
| public function __get( $propertyName ) |
| { |
| switch ( $propertyName ) |
| { |
| case 'option': |
| return $this->properties['option']; |
| case 'values': |
| return $this->properties['values']; |
| case 'ifSet': |
| return $this->properties['ifSet']; |
| } |
| throw new ezcBasePropertyNotFoundException( $propertyName ); |
| } |
| |
| /** |
| * Property write access. |
| * |
| * @param string $propertyName Name of the property. |
| * @param mixed $propertyValue The value for the property. |
| * |
| * @throws ezcBasePropertyPermissionException |
| * If the property you try to access is read-only. |
| * @throws ezcBasePropertyNotFoundException |
| * If the the desired property is not found. |
| * @ignore |
| */ |
| public function __set( $propertyName, $propertyValue ) |
| { |
| switch ( $propertyName ) |
| { |
| case 'option': |
| if ( !( $propertyValue instanceof ezcConsoleOption ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'ezcConsoleOption' ); |
| } |
| $this->properties['option'] = $propertyValue; |
| return; |
| case 'values': |
| if ( !is_array( $propertyValue ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'array' ); |
| } |
| $this->properties['values'] = $propertyValue; |
| return; |
| case 'ifSet': |
| if ( !is_bool( $propertyValue ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'bool' ); |
| } |
| $this->properties['ifSet'] = $propertyValue; |
| return; |
| } |
| throw new ezcBasePropertyNotFoundException( $propertyName ); |
| } |
| |
| /** |
| * Property isset access. |
| * |
| * @param string $propertyName Name of the property to check. |
| * @return bool If the property exists or not. |
| * @ignore |
| */ |
| public function __isset( $propertyName ) |
| { |
| switch ( $propertyName ) |
| { |
| case 'option': |
| case 'values': |
| case 'ifSet': |
| return true; |
| } |
| return false; |
| } |
| |
| } |
| |
| ?> |