3 * A class for merchants which can trade items
5 * @author Roland Haeder <webmaster@ship-simu.org>
7 * @copyright Copyright (c) 2007, 2008 Roland Haeder, this is free software
8 * @license GNU GPL 3.0 or any newer version
9 * @link http://www.ship-simu.org
11 * This program is free software: you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation, either version 3 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 class Merchant extends BaseFrameworkSystem {
26 private $merchantName = "Namenloser Händler";
28 // Preislite (Objekte wiedermal!)
29 private $priceList = null;
32 private $harborInstance = null;
35 protected function __construct () {
36 // Call parent constructor
37 parent::__construct(__CLASS__);
40 $this->removeSystemArray();
43 // Haendler mit Namen erzeugen
44 public final static function createMerchant ($merchantName, Harbor $harborInstance) {
46 $merchantName = (string) $merchantName;
49 $merchantInstance = new Merchant();
52 if ((defined('DEBUG_MERCHANT')) || (defined('DEBUG_ALL'))) {
53 $merchantInstance->debugOutput(sprintf("[%s:%d] Ein Händler <strong>%s</strong> wird angelegt und soll sich am <strong>%s</strong> niederlassen.",
57 $harborInstance->getHarborName()
61 // Haendlernamen setzen
62 $merchantInstance->setMerchantName($merchantName);
64 // In dem angegebenen Hafen den Haendler ansiedeln
65 $merchantInstance->setHarborInstance($harborInstance);
67 // Preisliste initialisieren
68 $merchantInstance->createPriceList();
70 // Instanz zurueckliefern
71 return $merchantInstance;
74 // Initialize pricing list
75 private function createPriceList () {
76 $this->priceList = new FrameworkArrayObject("FakedPriceList");
79 // Setter for merchant name
80 public final function setMerchantName ($merchantName) {
82 $this->merchantName = (string) $merchantName;
85 // Getter for merchant name
86 public final function getMerchantName () {
87 return $this->merchantName;
90 // Setter for harbor instance
91 public final function setHarborInstance (Harbor $harborInstance) {
92 $this->harborInstance = $harborInstance;
95 // Getter for harbor instance
96 public final function getHarborInstance () {
97 return $this->harborInstance;
100 // Add new item to merchant's price list
101 public function addItemToPriceList (TradeableItem $itemInstance, $price) {
103 $price = (float) $price;
105 // Construct pricing item and add it to the list
106 $this->priceList->append(array(
107 'item' => $itemInstance,
111 // Remove price attribute
112 $itemInstance->removePrice();
115 // Get a price from the merchant's list
116 public final function getPriceFromList (TradeableItem $itemInstance) {
119 // Iterate throw whole list
120 for ($iter = $this->priceList->getIterator(); $iter->valid(); $iter->next()) {
122 $item = $iter->current();
124 // Does this item match? The unique ID may not work...
125 if ($item['item']->itemMatches($itemInstance)) {
126 // Extract price and stop searching
127 $price = $item['price'];
132 // Was the item found?
135 throw new ItemNotInPriceListException($itemInstance, self::EXCEPTION_ITEM_NOT_IN_PRICE_LIST);