The protocol handler was mostly not correct as a listener was really used here.
[core.git] / inc / classes / main / container / socket / class_SocketContainer.php
index 13dbfb4cf344d78c3677a23a105e51f0cd9dd1b5..c78a56f232dc8c6dfa1681dcc1da30e4083078e4 100644 (file)
@@ -2,11 +2,11 @@
 /**
  * A Socket Container class
  *
- * @author             Roland Haeder <webmaster@ship-simu.org>
+ * @author             Roland Haeder <webmaster@shipsimu.org>
  * @version            0.0.0
- * @copyright  Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2012 Core Developer Team
+ * @copyright  Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2014 Core Developer Team
  * @license            GNU GPL 3.0 or any newer version
- * @link               http://www.ship-simu.org
+ * @link               http://www.shipsimu.org
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -36,11 +36,11 @@ class SocketContainer extends BaseContainer implements Registerable {
         * Creates an instance of this Container class and prepares it for usage
         *
         * @param       $socketResource         A valid socket resource
-        * @param       $protocolInstance       A ProtocolHandler instance
+        * @param       $listenerInstance       A Listenable instance
         * @param       $packageData            Raw package data
         * @return      $containerInstance      An instance of this Container class
         */
-       public static final function createSocketContainer ($socketResource, ProtocolHandler $protocolInstance = NULL, array $packageData = array()) {
+       public static final function createSocketContainer ($socketResource, Listenable $listenerInstance = NULL, array $packageData = array()) {
                // Get a new instance
                $containerInstance = new SocketContainer();
 
@@ -49,13 +49,13 @@ class SocketContainer extends BaseContainer implements Registerable {
                unset($packageData[NetworkPackage::PACKAGE_DATA_SIGNATURE]);
 
                // Debug message
-               //* NOISY-DEBUG: */ $containerInstance->debugOutput(__METHOD__ . ':socketResource=' . $socketResource . ',packageData='.print_r($packageData,true));
+               //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('SOCKET-CONTAINER[' . __METHOD__ . ':' . __LINE__ . ']:socketResource=' . $socketResource . ',packageData='.print_r($packageData, TRUE));
 
                // Set the resource ...
                $containerInstance->setSocketResource($socketResource);
 
                // ..., protocol instance ...
-               $containerInstance->setProtocolInstance($protocolInstance);
+               $containerInstance->setListenerInstance($listenerInstance);
 
                // ... and package data
                $containerInstance->setPackageData($packageData);
@@ -65,20 +65,21 @@ class SocketContainer extends BaseContainer implements Registerable {
        }
 
        /**
-        * Checks whether the given address (IP) matches with the one from the socket resource
+        * Checks whether the given Universal Node Locator matches with the one from package data
         *
-        * @param       $addressPort    The address:port (IP to check
-        * @return      $matches                Whether $address matches with the one from socket resource
+        * @param       $unlInstance    An instance of a LocateableNode class
+        * @return      $matches                Whether $address matches with the one from package data
         */
-       public final function ifAddressMatches ($addressPort) {
+       public final function ifAddressMatches (LocateableNode $unlInstance) {
                // Get current package data
                $packageData = $this->getPackageData();
 
                // Debug message
-               //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('SOCKET-CONTAINER: addressPort=' . $addressPort . ',packageData=' . print_r($packageData, true));
+               //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('SOCKET-CONTAINER: unlInstance=' . print_r($unlInstance, TRUE) . ',packageData=' . print_r($packageData, TRUE));
 
                // So, does both match?
-               $matches = ((isset($packageData[NetworkPackage::PACKAGE_DATA_RECIPIENT])) && ($packageData[NetworkPackage::PACKAGE_DATA_RECIPIENT] === $addressPort));
+               die(__METHOD__ . ': Unfinished.' . PHP_EOL);
+               $matches = ((isset($packageData[NetworkPackage::PACKAGE_DATA_RECIPIENT])) && ($packageData[NetworkPackage::PACKAGE_DATA_RECIPIENT] === $unlInstance));
 
                // Return result
                return $matches;
@@ -87,7 +88,7 @@ class SocketContainer extends BaseContainer implements Registerable {
        /**
         * Checks whether the given socket matches with stored
         *
-        * @param       $addressPort    The address:port (IP to check
+        * @param       $unlInstance    An instance of a LocateableNode class
         * @return      $matches                Whether given socket matches
         */
        public final function ifSocketResourceMatches ($socketResource) {