3 * URL parser and mapper
9 * Copyright (c) 2006, Bertrand Mansion <golgote@mamasam.com>
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
16 * * Redistributions of source code must retain the above copyright
17 * notice, this list of conditions and the following disclaimer.
18 * * Redistributions in binary form must reproduce the above copyright
19 * notice, this list of conditions and the following disclaimer in the
20 * documentation and/or other materials provided with the distribution.
21 * * The names of the authors may not be used to endorse or promote products
22 * derived from this software without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
25 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
26 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
28 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
29 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
30 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
31 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
32 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
33 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
34 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37 * @package Net_URL_Mapper
38 * @author Bertrand Mansion <golgote@mamasam.com>
39 * @license http://opensource.org/licenses/bsd-license.php New BSD License
40 * @version CVS: $Id: Part.php,v 1.1 2007/03/28 10:23:04 mansion Exp $
41 * @link http://pear.php.net/package/Net_URL_Mapper
44 abstract class Net_URL_Mapper_Part
50 protected $required = false;
53 * Part name if dynamic or content, generated from path
62 public function __construct($content, $path)
64 $this->content = $content;
68 public function setRule($rule)
73 abstract public function getFormat();
75 abstract public function getRule();
77 public function addSlash($str)
79 $str = trim($str, '/');
80 if (($pos = strpos($this->path, '/')) !== false) {
90 public function addSlashRegex($str)
92 $str = trim($str, '/');
93 if (($pos = strpos($this->path, '/')) !== false) {
100 if (!$this->isRequired()) {
101 $str = '('.$str.'|)';
106 public function setDefaults($defaults)
108 $this->defaults = (string)$defaults;
111 public function getType()
116 public function accept($visitor, $method = null)
118 $args = func_get_args();
119 $visitor->$method($this, $args);
122 public function setRequired($required)
124 $this->required = $required;
127 public function isRequired()
129 return $this->required;
132 abstract public function generate($value = null);
134 public function match($value)
136 $rule = $this->getRule();
137 return preg_match('/^'.$rule.'$/', $this->addSlash($value));