powerdlz23 1.1.7 → 1.1.8

package/pto/yaamp/web/framework-1.0.8/web/CWebModule.php

@@ -0,0 +1,187 @@
+<?php
+/**
+ * CWebModule class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CWebModule represents an application module.
+ *
+ * An application module may be considered as a self-contained sub-application
+ * that has its own controllers, models and views and can be reused in a different
+ * project as a whole. Controllers inside a module must be accessed with routes
+ * that are prefixed with the module ID.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CWebModule.php 870 2009-03-22 15:06:23Z qiang.xue $
+ * @package system.web
+ * @since 1.0.3
+ */
+class CWebModule extends CModule
+{
+	/**
+	 * @var string the ID of the default controller for this module. Defaults to 'default'.
+	 */
+	public $defaultController='default';
+	/**
+	 * @var mixed the layout that is shared by the controllers inside this module.
+	 * If a controller has explicitly declared its own {@link CController::layout layout},
+	 * this property will be ignored.
+	 * If this is null (default), the application's layout or the parent module's layout (if available)
+	 * will be used. If this is false, then no layout will be used.
+	 */
+	public $layout;
+	/**
+	 * @var array mapping from controller ID to controller configurations.
+	 * Pleaser refer to {@link CWebApplication::controllerMap} for more details.
+	 */
+	public $controllerMap=array();
+
+	private $_controllerPath;
+	private $_viewPath;
+	private $_layoutPath;
+
+
+	/**
+	 * Returns the name of this module.
+	 * The default implementation simply returns {@link id}.
+	 * You may override this method to customize the name of this module.
+	 * @return string the name of this module.
+	 */
+	public function getName()
+	{
+		return basename($this->getId());
+	}
+
+	/**
+	 * Returns the description of this module.
+	 * The default implementation returns an empty string.
+	 * You may override this method to customize the description of this module.
+	 * @return string the description of this module.
+	 */
+	public function getDescription()
+	{
+		return '';
+	}
+
+	/**
+	 * Returns the version of this module.
+	 * The default implementation returns '1.0'.
+	 * You may override this method to customize the version of this module.
+	 * @return string the version of this module.
+	 */
+	public function getVersion()
+	{
+		return '1.0';
+	}
+
+	/**
+	 * @return string the directory that contains the controller classes. Defaults to 'protected/controllers'.
+	 */
+	public function getControllerPath()
+	{
+		if($this->_controllerPath!==null)
+			return $this->_controllerPath;
+		else
+			return $this->_controllerPath=$this->getBasePath().DIRECTORY_SEPARATOR.'controllers';
+	}
+
+	/**
+	 * @param string the directory that contains the controller classes.
+	 * @throws CException if the directory is invalid
+	 */
+	public function setControllerPath($value)
+	{
+		if(($this->_controllerPath=realpath($value))===false || !is_dir($this->_controllerPath))
+			throw new CException(Yii::t('yii','The controller path "{path}" is not a valid directory.',
+				array('{path}'=>$value)));
+	}
+
+	/**
+	 * @return string the root directory of view files. Defaults to 'protected/views'.
+	 */
+	public function getViewPath()
+	{
+		if($this->_viewPath!==null)
+			return $this->_viewPath;
+		else
+			return $this->_viewPath=$this->getBasePath().DIRECTORY_SEPARATOR.'views';
+	}
+
+	/**
+	 * @param string the root directory of view files.
+	 * @throws CException if the directory does not exist.
+	 */
+	public function setViewPath($path)
+	{
+		if(($this->_viewPath=realpath($path))===false || !is_dir($this->_viewPath))
+			throw new CException(Yii::t('yii','The view path "{path}" is not a valid directory.',
+				array('{path}'=>$path)));
+	}
+
+	/**
+	 * @return string the root directory of layout files. Defaults to 'protected/views/layouts'.
+	 */
+	public function getLayoutPath()
+	{
+		if($this->_layoutPath!==null)
+			return $this->_layoutPath;
+		else
+			return $this->_layoutPath=$this->getViewPath().DIRECTORY_SEPARATOR.'layouts';
+	}
+
+	/**
+	 * @param string the root directory of layout files.
+	 * @throws CException if the directory does not exist.
+	 */
+	public function setLayoutPath($path)
+	{
+		if(($this->_layoutPath=realpath($path))===false || !is_dir($this->_layoutPath))
+			throw new CException(Yii::t('yii','The layout path "{path}" is not a valid directory.',
+				array('{path}'=>$path)));
+	}
+
+	/**
+	 * The pre-filter for controller actions.
+	 * This method is invoked before the currently requested controller action and all its filters
+	 * are executed. You may override this method in the following way:
+	 * <pre>
+	 * if(parent::beforeControllerAction($controller,$action))
+	 * {
+	 *     // your code
+	 *     return true;
+	 * }
+	 * else
+	 *     return false;
+	 * </pre>
+	 * @param CController the controller
+	 * @param CAction the action
+	 * @return boolean whether the action should be executed.
+	 * @since 1.0.4
+	 */
+	public function beforeControllerAction($controller,$action)
+	{
+		if(($parent=$this->getParentModule())===null)
+			$parent=Yii::app();
+		return $parent->beforeControllerAction($controller,$action);
+	}
+
+	/**
+	 * The post-filter for controller actions.
+	 * This method is invoked after the currently requested controller action and all its filters
+	 * are executed. If you override this method, make sure you call the parent implementation at the end.
+	 * @param CController the controller
+	 * @param CAction the action
+	 * @since 1.0.4
+	 */
+	public function afterControllerAction($controller,$action)
+	{
+		if(($parent=$this->getParentModule())===null)
+			$parent=Yii::app();
+		$parent->afterControllerAction($controller,$action);
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/actions/CAction.php

@@ -0,0 +1,58 @@
+<?php
+/**
+ * CAction class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CAction is the base class for all controller action classes.
+ *
+ * CAction provides a way to divide a complex controller into
+ * smaller actions in separate class files.
+ *
+ * Derived classes must implement {@link run()} which is invoked by
+ * controller when the action is requested.
+ *
+ * An action instance can access its controller via {@link getController controller} property.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CAction.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.web.actions
+ * @since 1.0
+ */
+abstract class CAction extends CComponent implements IAction
+{
+	private $_id;
+	private $_controller;
+
+	/**
+	 * Constructor.
+	 * @param CController the controller who owns this action.
+	 * @param string id of the action.
+	 */
+	public function __construct($controller,$id)
+	{
+		$this->_controller=$controller;
+		$this->_id=$id;
+	}
+
+	/**
+	 * @return CController the controller who owns this action.
+	 */
+	public function getController()
+	{
+		return $this->_controller;
+	}
+
+	/**
+	 * @return string id of this action
+	 */
+	public function getId()
+	{
+		return $this->_id;
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/actions/CInlineAction.php

@@ -0,0 +1,34 @@
+<?php
+/**
+ * CInlineAction class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+
+/**
+ * CInlineAction represents an action that is defined as a controller method.
+ *
+ * The method name is like 'actionXYZ' where 'XYZ' stands for the action name.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CInlineAction.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.web.actions
+ * @since 1.0
+ */
+class CInlineAction extends CAction
+{
+	/**
+	 * Runs the action.
+	 * The action method defined in the controller is invoked.
+	 * This method is required by {@link CAction}.
+	 */
+	public function run()
+	{
+		$method='action'.$this->getId();
+		$this->getController()->$method();
+	}
+}

package/pto/yaamp/web/framework-1.0.8/web/actions/CViewAction.php

@@ -0,0 +1,165 @@
+<?php
+/**
+ * CViewAction class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2009 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+/**
+ * CViewAction represents an action that displays a view according to a user-specified parameter.
+ *
+ * By default, the view being displayed is specified via the <code>view</code> GET parameter.
+ * The name of the GET parameter can be customized via {@link viewParam}.
+ * If the user doesn't provide the GET parameter, the default view specified by {@link defaultView}
+ * will be displayed.
+ *
+ * Users specify a view in the format of <code>path.to.view</code>, which translates to the view name
+ * <code>BasePath/path/to/view</code> where <code>BasePath</code> is given by {@link basePath}.
+ *
+ * Note, the user specified view can only contain word characters, dots and dashes and
+ * the first letter must be a word letter.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CViewAction.php 433 2008-12-30 22:59:17Z qiang.xue $
+ * @package system.web.actions
+ * @since 1.0
+ */
+class CViewAction extends CAction
+{
+	/**
+	 * @var string the name of the GET parameter that contains the requested view name. Defaults to 'view'.
+	 */
+	public $viewParam='view';
+	/**
+	 * @var string the name of the default view when {@link viewParam} GET parameter is not provided by user. Defaults to 'index'.
+	 * This should be in the format of 'path.to.view', similar to that given in
+	 * the GET parameter.
+	 * @see basePath
+	 */
+	public $defaultView='index';
+	/**
+	 * @var string the name of the view to be rendered. This property will be set
+	 * once the user requested view is resolved.
+	 */
+	public $view;
+	/**
+	 * @var string the base path for the views. Defaults to 'pages'.
+	 * The base path will be prefixed to any user-specified page view.
+	 * For example, if a user requests for <code>tutorial.chap1</code>, the corresponding view name will
+	 * be <code>pages/tutorial/chap1</code>, assuming the base path is <code>pages</code>.
+	 * The actual view file is determined by {@link CController::getViewFile}.
+	 * @see CController::getViewFile
+	 */
+	public $basePath='pages';
+	/**
+	 * @var mixed the name of the layout to be applied to the views.
+	 * This will be assigned to {@link CController::layout} before the view is rendered.
+	 * Defaults to null, meaning the controller's layout will be used.
+	 * If false, no layout will be applied.
+	 */
+	public $layout;
+	/**
+	 * @var boolean whether the view should be rendered as PHP script or static text. Defaults to false.
+	 */
+	public $renderAsText=false;
+
+	private $_viewPath;
+
+
+	/**
+	 * Returns the name of the view requested by the user.
+	 * If the user doesn't specify any view, the {@link defaultView} will be returned.
+	 * @return string the name of the view requested by the user.
+	 * This is in the format of 'path.to.view'.
+	 */
+	public function getRequestedView()
+	{
+		if($this->_viewPath===null)
+		{
+			if(isset($_GET[$this->viewParam]) && !empty($_GET[$this->viewParam]))
+				$this->_viewPath=$_GET[$this->viewParam];
+			else
+				$this->_viewPath=$this->defaultView;
+		}
+		return $this->_viewPath;
+	}
+
+	/**
+	 * Resolves the user-specified view into a valid view name.
+	 * @param string user-specified view in the format of 'path.to.view'.
+	 * @return string fully resolved view in the format of 'path/to/view'.
+	 * @throw CHttpException if the user-specified view is invalid
+	 */
+	protected function resolveView($viewPath)
+	{
+		// start with a word char and have word chars, dots and dashes only
+		if(preg_match('/^\w[\w\.\-]*$/',$viewPath))
+		{
+			$view=strtr($viewPath,'.','/');
+			if(!empty($this->basePath))
+				$view=$this->basePath.'/'.$view;
+			if($this->getController()->getViewFile($view)!==false)
+			{
+				$this->view=$view;
+				return;
+			}
+		}
+		throw new CHttpException(404,Yii::t('yii','The requested view "{name}" is not found.',
+			array('{name}'=>$viewPath)));
+	}
+
+	/**
+	 * Runs the action.
+	 * This method displays the view requested by the user.
+	 * @throws CHttpException if the view is invalid
+	 */
+	public function run()
+	{
+		$this->resolveView($this->getRequestedView());
+		$controller=$this->getController();
+		if($this->layout!==null)
+		{
+			$layout=$controller->layout;
+			$controller->layout=$this->layout;
+		}
+
+		$this->onBeforeRender($event=new CEvent($this));
+		if(!$event->handled)
+		{
+			if($this->renderAsText)
+			{
+				$text=file_get_contents($controller->getViewFile($this->view));
+				$controller->renderText($text);
+			}
+			else
+				$controller->render($this->view);
+			$this->onAfterRender(new CEvent($this));
+		}
+
+		if($this->layout!==null)
+			$controller->layout=$layout;
+	}
+
+	/**
+	 * Raised right before the action invokes the render method.
+	 * Event handlers can set the {@link CEvent::handled} property
+	 * to be true to stop further view rendering.
+	 * @param CEvent event parameter
+	 */
+	public function onBeforeRender($event)
+	{
+		$this->raiseEvent('onBeforeRender',$event);
+	}
+
+	/**
+	 * Raised right after the action invokes the render method.
+	 * @param CEvent event parameter
+	 */
+	public function onAfterRender($event)
+	{
+		$this->raiseEvent('onAfterRender',$event);
+	}
+}