Projekt

Obecné

Profil

Stáhnout (6.44 KB) Statistiky
| Větev: | Tag: | Revize:
<?php defined('SYSPATH') or die('No direct script access.');
/*
* This file is part of open source system FreenetIS
* and it is released under GPLv3 licence.
*
* More info about licence can be found:
* http://www.gnu.org/licenses/gpl-3.0.html
*
* More info about project can be found:
* http://www.freenetis.org/
*
*/

/**
* Bank account settings enables to store different types of settings to
* bank account (e.g. API key) in order to type of the bank account.
*
* Types of bank account are specified at Bank_Account_Model database entity.
*
* @author Ondrej Fibich
* @see Bank_Account_Model
*/
abstract class Bank_Account_Settings
{
/**
* Dir with driver classes
*/
const DIR = 'bank_account_settings';
// Type constants
/** Integer type */
const FIELD_TYPE_INT = 'integer';
/** Integer type */
const FIELD_TYPE_BOOL = 'boolean';
/** String type */
const FIELD_TYPE_STRING = 'string';
/** Data of settings */
private $data = array();
/**
* Creates bank account setting for bank account with given type.
* If an new bank account type will be added, it must be added also
* to this method.
*
* @param integer $type type of bank account (from ORM model)
* @return BankAccountSettings An instance of driver
* @throws InvalidArgumentException On unknown type
*/
public static function factory($type)
{
// class path dir
$cp_dir = dirname(__FILE__) . '/' . self::DIR . '/';
// require class and return it
switch ($type)
{
case Bank_account_Model::TYPE_FIO:
require_once $cp_dir . 'Fio_Bank_Account_Settings.php';
return new Fio_Bank_Account_Settings();
case Bank_account_Model::TYPE_UNICREDIT:
require_once $cp_dir . 'Unicredit_Bank_Account_Settings.php';
return new Unicredit_Bank_Account_Settings();
case Bank_account_Model::TYPE_RAIFFEISENBANK:
require_once $cp_dir . 'Raiffeisenbank_Bank_Account_Settings.php';
return new Raiffeisenbank_Bank_Account_Settings();
}
// invalid type
throw new InvalidArgumentException('Unknown driver for type: ' . $type);
}
/**
* Can be bank statements automatically downloaded (using API) in this
* type of bank?
*
* @return boolean
*/
public abstract function can_download_statements_automatically();
/**
* Gets download statement type (e.g. csv, json).
* Valid only if download is enabled.
* Tells what file type is espected as result of download.
* This type is later use for detection of importer for statement.
*
* Override this method in order to support auto downloading of statements.
*
* @see Bank_Account_Settings#can_download_statements_automatically()
* @return string
*/
public function get_download_statement_type()
{
return NULL;
}
/**
* Gets base download URL (e.g. http://mbank/)
* Valid only if download is enabled.
*
* Override this method in order to support auto downloading of statements.
*
* @see Bank_Account_Settings#can_download_statements_automatically()
* @return string URL string
* @throws InvalidArgumentException On invalid settings (e.g. API token)
*/
public function get_download_base_url()
{
return NULL;
}
/**
* Gets download URL for statement (e.g. http://mbank/json/transactions)
* Valid only if download is enabled.
* The statment for the bank account is downloaded from this URL.
*
* This method may use get_download_base_url() method for obtaining
* of base URL path.
*
* Override this method in order to support auto downloading of statements.
*
* @see Bank_Account_Settings#can_download_statements_automatically()
* @return string URL string
* @throws InvalidArgumentException On invalid settings (e.g. API token)
*/
public function get_download_statement_url()
{
return NULL;
}
/**
* Can be bank statements imported in this type of bank?
*
* @return boolean
*/
public abstract function can_import_statements();
/**
* Gets fields array (key is a name of field and value contains a another
* array with fields type, name, help, rules, etc.)
*
* @return array Fields array
*/
public abstract function get_column_fields();
/**
* Gets settings data in JSON format. This method is used for retrieving
* new value in order to store it into a database table.
*
* @return array Settings
*/
public function get_column_data()
{
return json_encode($this->data);
}
/**
* Loads data settings from a given JSON data.
*
* @param string JSON data
*/
public function load_column_data($json)
{
// init columns
$columns = $this->get_column_fields();
foreach ($columns as $column => $type)
{
$this->data[$column] = NULL;
}
// laod values (only if not empty)
if (!empty($json))
{
$data = json_decode($json, TRUE);

if (!$data)
{
$m = 'Wrong data settings in the database: ' . $json;
throw new InvalidArgumentException($m);
}

foreach ($data as $column => $value)
{
$this->$column = $value; // call setter
}
}
}
/**
* Checks if the column exists in the column data.
*
* @param string $column Column name
* @return boolean
*/
public function __isset($column)
{
return array_key_exists($column, $this->get_column_fields());
}

/**
* Gets value from the column data.
*
* @param string $column Column name
* @throws InvalidArgumentException On invalid column
*/
public function __get($column)
{
$columns = $this->get_column_fields();
if (!array_key_exists($column, $columns))
{
throw new InvalidArgumentException('Column not founded: ' . $column);
}
return $this->data[$column];
}
/**
* Sets value from the column data.
*
* @param string $column Column name
* @param mixed $data
* @throws InvalidArgumentException On invalid column or invalid data format
*/
public function __set($column, $data)
{
$columns = $this->get_column_fields();
if (!array_key_exists($column, $columns))
{
throw new InvalidArgumentException('Column not founded: ' . $column);
}
if (!empty($data) && isset($columns[$column]['type']))
{
switch ($columns[$column]['type'])
{
case self::FIELD_TYPE_INT:
if (!preg_match('/^[0-9]+$/', $data))
{
$m = 'Invalid integer format: ' . data;
throw new InvalidArgumentException($m);
}
$data = intval($data);
break;

case self::FIELD_TYPE_STRING:
$data = strval($data);
break;
case self::FIELD_TYPE_BOOL:
break;
}
$this->data[$column] = $data;
}
else
{
$this->data[$column] = NULL;
}
}
}
(3-3/30)