Updated doc tag to reflect UNL rewrites in 'hub' project.
[core.git] / inc / classes / main / container / socket / class_SocketContainer.php
index 379a7cc14eddde40845edb847f31247a91cfd057..0cec344805f03281375e562dea965a510a6b41a0 100644 (file)
@@ -4,7 +4,7 @@
  *
  * @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.shipsimu.org
  *
@@ -49,7 +49,7 @@ class SocketContainer extends BaseContainer implements Registerable {
                unset($packageData[NetworkPackage::PACKAGE_DATA_SIGNATURE]);
 
                // Debug message
-               //* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->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);
@@ -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) {