<?PHP

  require_once ('twIf/i18n.php');
  
  class twIf_RPC_Helper_Method {
    private $Name = '';
    private $Callback = null;
    private $Parameters = array ();
    
    private $isHidden = false;
    
    
    // {{{ newInstance
    /**
     * Create a new RPC-Method
     * 
     * @param string $Name Name of the new Method
     * @param callback $Callback Where to forward incoming calls to
     * @param array $Paramters Parameter-Definition for Function-Call
     * 
     * @access public
     * @return object
     **/
    public static function newInstance ($Name, $Callback, $Parameters) {
      // Check if there is a valid callback
      if (!is_callable ($Callback)) {
        trigger_error (twIf_i18n::getText ('Invalid Callback'));
        
        return false;
      }
      
      // Create a new method
      $Instance = new twIf_RPC_Helper_Method;
      
      $Instance->Name = $Name;
      $Instance->Callback = $Callback;
      $Instance->Parameters = $Parameters;
      
      return $Instance;
    }
    // }}}
    
    // {{{ getName
    /**
     * Retrive the external name of this function
     * 
     * @access public
     * @return string
     **/
    public function getName () {
      return $this->Name;
    }
    // }}}
    
    // {{{ getCallback
    /**
     * Retrive the callback for this method
     * 
     * @access public
     * @return callback
     **/
    public function getCallback () {
      return $this->Callback;
    }
    // }}}
    
    // {{{ getParameters
    /** 
     * Retrive our parameter-definition
     * 
     * @access public
     * @return array
     **/
    public function getParameters () {
      return $this->Parameters;
    }
    // }}}
    
    // {{{ isHidden
    /**
     * Check wheter to not expose this function
     * 
     * @access public
     * @return bool
     **/
    public function isHidden () {
      return $this->isHidden;
    }
    // }}}
    
    // {{{ checkParameters
    /**
     * Check if a given parameter-definition matches our signature
     * 
     * @param array $Parameters
     * 
     * @access public
     * @return bool
     **/
    public function checkParameters ($Parameters) {
      # TODO: Implement this
      
      return true;
    }
    // }}}
    
    /**
     * Run the callback
     * 
     * @param array $Parameters
     * 
     * @access public
     * @return mixed
     **/
    public function runCallback ($Parameters) {
      # TODO: Handle the parameters
      return call_user_func ($this->getCallback (), $Parameters);
    }
    // }}]
  }

?>