<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<!-- template designed by Marco Von Ballmoos -->
<title>File Source for TransactionTemplate.class.inc</title>
<link rel="stylesheet" href="../media/stylesheet.css" />
<meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
</head>
<body>
<h1>Source for file TransactionTemplate.class.inc</h1>
<p>Documentation is available at <a href="../swam/_transaction---TransactionTemplate.class.inc.html">TransactionTemplate.class.inc</a></p>
<div class="src-code">
<div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
<li><div class="src-line"><a name="a2"></a> </div></li>
<li><div class="src-line"><a name="a3"></a><span class="src-comm">/*</span></div></li>
<li><div class="src-line"><a name="a4"></a><span class="src-comm">* SWAM (Simple Web Account Manager) is a personal finance manager</span></div></li>
<li><div class="src-line"><a name="a5"></a><span class="src-comm">* written in PHP.</span></div></li>
<li><div class="src-line"><a name="a6"></a><span class="src-comm">* Copyright (C) 2004-2009 Mathieu Peltier.</span></div></li>
<li><div class="src-line"><a name="a7"></a><span class="src-comm">* Contact: mpeltier at users.sourceforge.net</span></div></li>
<li><div class="src-line"><a name="a8"></a><span class="src-comm">*</span></div></li>
<li><div class="src-line"><a name="a9"></a><span class="src-comm">* This program is free software: you can redistribute it and/or modify</span></div></li>
<li><div class="src-line"><a name="a10"></a><span class="src-comm">* it under the terms of the GNU General Public License as published by</span></div></li>
<li><div class="src-line"><a name="a11"></a><span class="src-comm">* the Free Software Foundation, either version 3 of the License, or</span></div></li>
<li><div class="src-line"><a name="a12"></a><span class="src-comm">* (at your option) any later version.</span></div></li>
<li><div class="src-line"><a name="a13"></a><span class="src-comm">*</span></div></li>
<li><div class="src-line"><a name="a14"></a><span class="src-comm">* This program is distributed in the hope that it will be useful, but</span></div></li>
<li><div class="src-line"><a name="a15"></a><span class="src-comm">* WITHOUT ANY WARRANTY; without even the implied warranty of</span></div></li>
<li><div class="src-line"><a name="a16"></a><span class="src-comm">* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div></li>
<li><div class="src-line"><a name="a17"></a><span class="src-comm">* General Public License for more details.</span></div></li>
<li><div class="src-line"><a name="a18"></a><span class="src-comm">*</span></div></li>
<li><div class="src-line"><a name="a19"></a><span class="src-comm">* You should have received a copy of the GNU General Public License</span></div></li>
<li><div class="src-line"><a name="a20"></a><span class="src-comm">* along with this program. If not, see <http://www.gnu.org/licenses/>.</span></div></li>
<li><div class="src-line"><a name="a21"></a><span class="src-comm">*</span></div></li>
<li><div class="src-line"><a name="a22"></a><span class="src-comm">* Initial developer(s): Mathieu Peltier.</span></div></li>
<li><div class="src-line"><a name="a23"></a><span class="src-comm">* Contributor(s):</span></div></li>
<li><div class="src-line"><a name="a24"></a><span class="src-comm">*/</span></div></li>
<li><div class="src-line"><a name="a25"></a> </div></li>
<li><div class="src-line"><a name="a26"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a27"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> swam</span></div></li>
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Mathieu Peltier <hide@address.com></span></div></li>
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a30"></a> </div></li>
<li><div class="src-line"><a name="a31"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-str">'pre.inc'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a32"></a> </div></li>
<li><div class="src-line"><a name="a33"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a34"></a><span class="src-doc"> * Defines a transaction template.</span></div></li>
<li><div class="src-line"><a name="a35"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a36"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> swam</span></div></li>
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a38"></a><span class="src-key">class </span><a href="../swam/TransactionTemplate.html">TransactionTemplate</a> <span class="src-key">extends </span><a href="../swam/Transaction.html">Transaction</a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a39"></a> </div></li>
<li><div class="src-line"><a name="a40"></a> <span class="src-comm">/*</span></div></li>
<li><div class="src-line"><a name="a41"></a><span class="src-comm"> * -----------------------------</span></div></li>
<li><div class="src-line"><a name="a42"></a><span class="src-comm"> * Constructor</span></div></li>
<li><div class="src-line"><a name="a43"></a><span class="src-comm"> * -----------------------------</span></div></li>
<li><div class="src-line"><a name="a44"></a><span class="src-comm"> */</span></div></li>
<li><div class="src-line"><a name="a45"></a> </div></li>
<li><div class="src-line"><a name="a46"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a47"></a><span class="src-doc"> * Creates a new TransactionTemplate. The method does NOT add the</span></div></li>
<li><div class="src-line"><a name="a48"></a><span class="src-doc"> * transaction template into the database as long as store() method</span></div></li>
<li><div class="src-line"><a name="a49"></a><span class="src-doc"> * is not called. If the transaction template has been already</span></div></li>
<li><div class="src-line"><a name="a50"></a><span class="src-doc"> * stored in the database, the transaction template id must be</span></div></li>
<li><div class="src-line"><a name="a51"></a><span class="src-doc"> * given. Otherwise the id will be set when the transaction template</span></div></li>
<li><div class="src-line"><a name="a52"></a><span class="src-doc"> * will be saved.</span></div></li>
<li><div class="src-line"><a name="a53"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a54"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">array </span><span class="src-doc-var">$data </span><span class="src-doc">transaction template data to use (associate</span></div></li>
<li><div class="src-line"><a name="a55"></a><span class="src-doc"> * array containing: transaction_template_id, name, account object,</span></div></li>
<li><div class="src-line"><a name="a56"></a><span class="src-doc"> * is_debit, mean_of_payment_code, date, comment,</span></div></li>
<li><div class="src-line"><a name="a57"></a><span class="src-doc"> * is_valid).</span></div></li>
<li><div class="src-line"><a name="a58"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">int </span><span class="src-doc-var">$transaction_template_id </span><span class="src-doc">optional transaction template</span></div></li>
<li><div class="src-line"><a name="a59"></a><span class="src-doc"> * id.</span></div></li>
<li><div class="src-line"><a name="a60"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> TransactionException</span></div></li>
<li><div class="src-line"><a name="a61"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> IllegalArgumentException if the transaction template data</span></div></li>
<li><div class="src-line"><a name="a62"></a><span class="src-doc"> * are not valid.</span></div></li>
<li><div class="src-line"><a name="a63"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a64"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-var">$transaction_template_id </span>= -<span class="src-num">1</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a65"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/TransactionTemplate.html#methodset_id">set_id</a><span class="src-sym">(</span><span class="src-var">$transaction_template_id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a66"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/TransactionTemplate.html#methodset_data">set_data</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a67"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a68"></a> </div></li>
<li><div class="src-line"><a name="a69"></a> <span class="src-comm">/*</span></div></li>
<li><div class="src-line"><a name="a70"></a><span class="src-comm"> * -----------------------------</span></div></li>
<li><div class="src-line"><a name="a71"></a><span class="src-comm"> * Instance methods</span></div></li>
<li><div class="src-line"><a name="a72"></a><span class="src-comm"> * -----------------------------</span></div></li>
<li><div class="src-line"><a name="a73"></a><span class="src-comm"> */</span></div></li>
<li><div class="src-line"><a name="a74"></a> </div></li>
<li><div class="src-line"><a name="a75"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a76"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@see</span><span class="src-doc"> PersistentObject::set_id()</span></div></li>
<li><div class="src-line"><a name="a77"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a78"></a> <span class="src-key">protected </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodset_id">set_id</a><span class="src-sym">(</span><span class="src-var">$id</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a79"></a> <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodcheck_transaction_template_id">check_transaction_template_id</a><span class="src-sym">(</span><span class="src-var">$id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a80"></a> <span class="src-id">parent</span><span class="src-sym">::</span><a href="../swam/Transaction.html#methodset_id">set_id</a><span class="src-sym">(</span><span class="src-var">$id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a81"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a82"></a> </div></li>
<li><div class="src-line"><a name="a83"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a84"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@see</span><span class="src-doc"> ITransaction::set_date($data)</span></div></li>
<li><div class="src-line"><a name="a85"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a86"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodset_date">set_date</a><span class="src-sym">(</span><span class="src-var">$date</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a87"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$date</span><span class="src-sym">) </span>&& <span class="src-sym">(</span><span class="src-var">$date </span>!= <span class="src-str">'0'</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a88"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/TransactionException.html">TransactionException</a></span><span class="src-sym">(</span><a href="http://www.php.net/_">_</a><span class="src-sym">(</span><span class="src-str">'Please enter the day of the transaction.'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a89"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a90"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodis_int">is_int</a><span class="src-sym">(</span><span class="src-var">$date</span><span class="src-sym">) </span>|| <span class="src-sym">(</span><span class="src-var">$date </span><= <span class="src-num">0</span><span class="src-sym">) </span>|| <span class="src-sym">(</span><span class="src-var">$date </span>> <span class="src-num">31</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a91"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/TransactionException.html">TransactionException</a></span><span class="src-sym">(</span><span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodsafe_sprintf">safe_sprintf</a><span class="src-sym">(</span><a href="http://www.php.net/_">_</a><span class="src-sym">(</span><span class="src-str">'The day of the transaction is invalid: %s.'</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$date</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a92"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a93"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">data</span><span class="src-sym">[</span><span class="src-str">'date'</span><span class="src-sym">] </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodnormalize_date">normalize_date</a><span class="src-sym">(</span><span class="src-var">$date</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a94"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a95"></a> </div></li>
<li><div class="src-line"><a name="a96"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a97"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@see</span><span class="src-doc"> ITransaction::set_data()</span></div></li>
<li><div class="src-line"><a name="a98"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a99"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodset_data">set_data</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a100"></a> <span class="src-var">$name </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'name'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a101"></a> <span class="src-var">$account </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_object">get_object</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'account'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a102"></a> <span class="src-var">$amount </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'amount'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a103"></a> <span class="src-var">$locale_amount </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'locale_amount'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a104"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$amount</span><span class="src-sym">) </span>&& <span class="src-sym">!</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$locale_amount</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a105"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/IllegalArgumentException.html">IllegalArgumentException</a></span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a106"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a107"></a> <span class="src-var">$is_debit </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'is_debit'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a108"></a> <span class="src-var">$mean_of_payment_code </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'mean_of_payment_code'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a109"></a> <span class="src-var">$date </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'date'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a110"></a> <span class="src-var">$comment </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'comment'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a111"></a> <span class="src-var">$is_valid </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodget_string">get_string</a><span class="src-sym">(</span><span class="src-var">$data</span><span class="src-sym">, </span><span class="src-str">'is_valid'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a112"></a> </div></li>
<li><div class="src-line"><a name="a113"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_name">set_name</a><span class="src-sym">(</span><span class="src-var">$name</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a114"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_account">set_account</a><span class="src-sym">(</span><span class="src-var">$account</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a115"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$amount</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a116"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_locale_amount">set_locale_amount</a><span class="src-sym">(</span><span class="src-var">$locale_amount</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a117"></a> <span class="src-sym">} </span><span class="src-key">else </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a118"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_amount">set_amount</a><span class="src-sym">(</span><span class="src-var">$amount</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a119"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a120"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_is_debit">set_is_debit</a><span class="src-sym">(</span><span class="src-var">$is_debit</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a121"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_mean_of_payment_code">set_mean_of_payment_code</a><span class="src-sym">(</span><span class="src-var">$mean_of_payment_code</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a122"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/TransactionTemplate.html#methodset_date">set_date</a><span class="src-sym">(</span><span class="src-var">$date</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a123"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_comment">set_comment</a><span class="src-sym">(</span><span class="src-var">$comment</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a124"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodset_is_valid">set_is_valid</a><span class="src-sym">(</span><span class="src-var">$is_valid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a125"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a126"></a> </div></li>
<li><div class="src-line"><a name="a127"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a128"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@see</span><span class="src-doc"> IPersistentObject::store()</span></div></li>
<li><div class="src-line"><a name="a129"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> PDOException</span></div></li>
<li><div class="src-line"><a name="a130"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a131"></a> <span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodstore">store</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a132"></a> <span class="src-var">$dbh </span>= <span class="src-id"><a href="../swam/Database.html">Database</a></span><span class="src-sym">::</span><a href="../swam/Database.html#methodinstance">instance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_connection</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a133"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">) </span>== -<span class="src-num">1</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a134"></a> <span class="src-comm">// Transaction template does not exist in the database</span></div></li>
<li><div class="src-line"><a name="a135"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">is_opened</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a136"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/TransactionException.html">TransactionException</a></span><span class="src-sym">(</span><a href="http://www.php.net/_">_</a><span class="src-sym">(</span><span class="src-str">'Cannot add transaction template because the corresponding account is closed.'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a137"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a138"></a> <span class="src-var">$sth </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'INSERT INTO t_transaction_template(name, account_id, amount, is_debit, mean_of_payment_code, date, comment, is_valid) VALUES (?, ?, ?, ?, ?, ?, ?, ?)'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a139"></a> <span class="src-var">$sth</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_name">get_name</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_amount">get_amount</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodis_debit">is_debit</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_mean_of_payment_code">get_mean_of_payment_code</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_date">get_date</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_comment">get_comment</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodis_valid">is_valid</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a140"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/TransactionTemplate.html#methodset_id">set_id</a><span class="src-sym">(</span><span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">lastInsertId</span><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a141"></a> <span class="src-id"><a href="../swam/FileLog.html">FileLog</a></span><span class="src-sym">::</span><a href="../swam/FileLog.html#methodinstance">instance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">info</span><span class="src-sym">(</span><a href="http://www.php.net/sprintf">sprintf</a><span class="src-sym">(</span><span class="src-str">'Added new transaction template (user_id: %s, account_id: %s, transaction_id: %s)'</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_owner</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a142"></a> </div></li>
<li><div class="src-line"><a name="a143"></a> <span class="src-sym">} </span><span class="src-key">else </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a144"></a> <span class="src-comm">// Transaction already exist in the database (except in case of database import)</span></div></li>
<li><div class="src-line"><a name="a145"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">is_opened</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a146"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/TransactionException.html">TransactionException</a></span><span class="src-sym">(</span><a href="http://www.php.net/_">_</a><span class="src-sym">(</span><span class="src-str">'Cannot modify the transaction template because the corresponding account is closed.'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a147"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a148"></a> <span class="src-var">$sth </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'INSERT OR REPLACE INTO t_transaction_template(transaction_template_id, name, account_id, amount, is_debit, mean_of_payment_code, date, comment, is_valid) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a149"></a> <span class="src-var">$sth</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_name">get_name</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_amount">get_amount</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodis_debit">is_debit</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_mean_of_payment_code">get_mean_of_payment_code</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_date">get_date</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_comment">get_comment</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodis_valid">is_valid</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a150"></a> <span class="src-id"><a href="../swam/FileLog.html">FileLog</a></span><span class="src-sym">::</span><a href="../swam/FileLog.html#methodinstance">instance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">info</span><span class="src-sym">(</span><a href="http://www.php.net/sprintf">sprintf</a><span class="src-sym">(</span><span class="src-str">'Stored transaction template (user_id: %s, account_id: %s, transaction_id: %s)'</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_owner</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a151"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a152"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a153"></a> </div></li>
<li><div class="src-line"><a name="a154"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a155"></a><span class="src-doc"> * Deletes this transaction template from the database. If the</span></div></li>
<li><div class="src-line"><a name="a156"></a><span class="src-doc"> * transaction template has not been saved into the database yet,</span></div></li>
<li><div class="src-line"><a name="a157"></a><span class="src-doc"> * this function does nothing.</span></div></li>
<li><div class="src-line"><a name="a158"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a159"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@see</span><span class="src-doc"> IPersistentObject::remove()</span></div></li>
<li><div class="src-line"><a name="a160"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> PDOException</span></div></li>
<li><div class="src-line"><a name="a161"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a162"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodremove">remove</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a163"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">) </span>!= -<span class="src-num">1</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a164"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">is_opened</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a165"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../swam/TransactionException.html">TransactionException</a></span><span class="src-sym">(</span><a href="http://www.php.net/_">_</a><span class="src-sym">(</span><span class="src-str">'Cannot remove the transaction template because the corresponding account is closed.'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a166"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a167"></a> </div></li>
<li><div class="src-line"><a name="a168"></a> <span class="src-var">$dbh </span>= <span class="src-id"><a href="../swam/Database.html">Database</a></span><span class="src-sym">::</span><a href="../swam/Database.html#methodinstance">instance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_connection</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a169"></a> <span class="src-var">$sth </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'DELETE FROM t_transaction_template WHERE transaction_template_id=?'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a170"></a> <span class="src-var">$sth</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a171"></a> <span class="src-id"><a href="../swam/FileLog.html">FileLog</a></span><span class="src-sym">::</span><a href="../swam/FileLog.html#methodinstance">instance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">info</span><span class="src-sym">(</span><a href="http://www.php.net/sprintf">sprintf</a><span class="src-sym">(</span><span class="src-str">'Removed transaction template (user_id: %s, account_id: %s, transaction_template_id: %s)'</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_owner</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/Transaction.html#methodget_account">get_account</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">get_id</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_id">get_id</a><span class="src-sym">(</span><span class="src-sym">)))</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a172"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a173"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a174"></a> </div></li>
<li><div class="src-line"><a name="a175"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a176"></a><span class="src-doc"> * Returns a new transaction from this transaction template.</span></div></li>
<li><div class="src-line"><a name="a177"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a178"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">Transaction </span></div></li>
<li><div class="src-line"><a name="a179"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> TransactionException if the transaction cannot be created.</span></div></li>
<li><div class="src-line"><a name="a180"></a><span class="src-doc"> * </span><span class="src-doc-tag">@exception</span><span class="src-doc"> PDOException</span></div></li>
<li><div class="src-line"><a name="a181"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a182"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../swam/TransactionTemplate.html#methodapply">apply</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a183"></a> <span class="src-var">$transaction_data </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../swam/PersistentObject.html#methodget_data">get_data</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a184"></a> <span class="src-var">$today </span>= <a href="http://www.php.net/getdate">getdate</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a185"></a> <span class="src-var">$month </span>= <span class="src-id"><a href="../swam/Utils.html">Utils</a></span><span class="src-sym">::</span><a href="../swam/Utils.html#methodnormalize_date">normalize_date</a><span class="src-sym">(</span><span class="src-var">$today</span><span class="src-sym">[</span><span class="src-str">'mon'</span><span class="src-sym">]</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a186"></a> <span class="src-var">$transaction_data</span><span class="src-sym">[</span><span class="src-str">'date'</span><span class="src-sym">] </span>= <span class="src-var">$today</span><span class="src-sym">[</span><span class="src-str">'year'</span><span class="src-sym">] </span>. <span class="src-str">'-' </span>. <span class="src-var">$month </span>. <span class="src-str">'-' </span>. <span class="src-var">$transaction_data</span><span class="src-sym">[</span><span class="src-str">'date'</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a187"></a> <span class="src-key">return </span><span class="src-key">new </span><span class="src-id"><a href="../swam/Transaction.html">Transaction</a></span><span class="src-sym">(</span><span class="src-var">$transaction_data</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a188"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a189"></a><span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a190"></a> </div></li>
<li><div class="src-line"><a name="a191"></a><span class="src-php">?></span></div></li>
</ol></div>
</div>
<p class="notes" id="credit">
Documentation generated on Thu, 20 Aug 2009 01:04:19 +0200 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.1</a>
</p>
</body>
</html>