action.class.php

查看本檔案說明文件.

<?php


    include_once( PLOG_CLASS_PATH."class/object/object.class.php" );
    include_once( PLOG_CLASS_PATH."class/action/actioninfo.class.php" );
    include_once( PLOG_CLASS_PATH."class/config/properties.class.php" );
    include_once( PLOG_CLASS_PATH."class/net/request.class.php" );
    include_once( PLOG_CLASS_PATH."class/object/observable.class.php" );
    include_once( PLOG_CLASS_PATH."class/data/forms/formvalidator.class.php" );

    class Action extends Object
    {

        // this is the pointer to the view associated with this action
        var $_view;
        var $_request;
        var $_actionInfo;
        var $_fieldValidators;
        var $_validationErrorView;
        var $_previousAction;
        var $_isSuccess;

        function Action( $actionInfo, $httpRequest )
        {
            $this->Object();

            $this->_request = new Request( $httpRequest );

            $this->_actionInfo = $actionInfo;
            
            $this->_fieldValidators = Array();
            
            // initialize the views to empty values
            $this->_view = null;
            $this->_validationErrorView = null;
            
            // form object, used for data validation
            $this->_form = new FormValidator();
            
            // no previous action
            $this->_previousAction = null;
            
            // by default, the action is successful
            $this->_isSuccess = true;
        }
        
        function setPreviousAction( $previousAction )
        {
            $this->_previousAction = $previousAction;
        }
        
        function getPreviousAction()
        {
            return $this->_previousAction;
        }
        
        function perform()
        {   
            // to be implemented by child classes...
        }
        
        function validate()
        {
            // use the FormValidator object to validate the data
            $validationOk =  $this->_form->validate( $this->_request );
            
            // if something went wrong... let's do somethinga about it :)
            if( !$validationOk ) {
                $this->validationErrorProcessing();
            }
            
            return $validationOk;
        }
        
        function validationErrorProcessing()
        {
            // if there was a validaton error, then inform the view
            $this->_view->setError( true );
                
            // and  export all the data to the view so that it can be reused in the error view
            $fieldValues = $this->_form->getFieldValues();
            foreach( $fieldValues as $fieldName => $fieldValue ) {
                $this->_view->setValue( "$fieldName", $fieldValue );
            }
                
            $this->_form->setFormIsValid( false );
            $this->setCommonData();
    
            return true;
        }
        
        function setValidationErrorView( $view )
        {
            $this->_view = $view;
            
            return true;
        }
        
        function registerFieldValidator( $fieldName, $validator, $onlyIfAvailable = false )
        {
            $this->_form->registerFieldValidator( $fieldName, $validator, $onlyIfAvailable );
            
            return true;
        }
        
        function registerField( $fieldName )
        {
            $this->_form->registerField( $fieldName );
            
            return true;
        }
        

        function getView()
        {
            return $this->_view;
        }
        
        function setCommonData( $copyFormValues = false )
        {
            $this->_view->setValue( "form", $this->_form );
            
            if( $copyFormValues ) {
                // in case we'd like to copy the values from the form
                $fieldValues = $this->_form->getFieldValues();
                foreach( $fieldValues as $fieldName => $fieldValue ) {
                    $this->_view->setValue( "$fieldName", $fieldValue );
                }
            }
            
            return true;
        }
        
         function setForwardAction( $nextActionKey )
         {       
            Controller::setForwardAction( $nextActionKey, $this );
            
            return true;
         }
         
         function setForwardActionParameter( $param, $value )
         {
            return true;
         }
         
         function setSuccess( $success )
         {
             $this->_isSuccess = $success;
             $this->_form->setFormIsValid( $success );   
         }
    }
?>

 

© 2005 LifeType. All rights reserved.	總站 | 德國 | 台灣	網站地圖 | 聯絡我們