ondrej-bouda / ivory

src/Ivory/Type/CompositeType.php

Indentation +214 added lines, -214 removed lines

@@ -20,223 +20,223 @@
  */
 abstract class CompositeType implements INamedType, ITotallyOrderedType
 {
-	/** @var IType[] ordered map: attribute name => attribute type */
-	private $attributes = [];
-	/** @var int[] map: attribute name => position of the attribute within the composite type */
-	private $attNameMap = [];
-
-
-	public function __construct()
-	{
-	}
-
-	/**
-	 * Defines a new attribute of this composite type.
-	 *
-	 * @param string $attName
-	 * @param IType $attType
-	 */
-	public function addAttribute($attName, IType $attType)
-	{
-		if ((string)$attName == '') {
-			$typeName = "{$this->getSchemaName()}.{$this->getName()}";
-			$msg = "No attribute name given when adding attribute to composite type $typeName";
-			throw new \InvalidArgumentException($msg);
-		}
-		if (isset($this->attributes[$attName])) {
-			$typeName = "{$this->getSchemaName()}.{$this->getName()}";
-			throw new \RuntimeException("Attribute '$attName' already defined on composite type $typeName");
-		}
-		$this->attributes[$attName] = $attType;
-		$this->attNameMap[$attName] = count($this->attNameMap);
-	}
-
-	/**
-	 * @return IType[] ordered map: attribute name => attribute type
-	 */
-	public function getAttributes()
-	{
-		return $this->attributes;
-	}
-
-	/**
-	 * @param string $attName name of an attribute, previously defined by {@link addAttribute()}
-	 * @return int|null zero-based position of the given attribute, or <tt>null</tt> if no such attribute is defined
-	 */
-	public function getAttPos($attName)
-	{
-		return (isset($this->attNameMap[$attName]) ? $this->attNameMap[$attName] : null);
-	}
-
-	public function parseValue($str)
-	{
-		if ($str === null) {
-			return null;
-		}
-		if ($str == '()' && !$this->attributes) {
-			return Composite::fromList($this, []);
-		}
-
-		$strLen = strlen($str);
-		if ($str[0] != '(' || $str[$strLen - 1] != ')') {
-			throw new \InvalidArgumentException('Invalid value for a composite type - not enclosed in parentheses');
-		}
-		$strOffset = 1;
-
-		$attRegex = '~
+    /** @var IType[] ordered map: attribute name => attribute type */
+    private $attributes = [];
+    /** @var int[] map: attribute name => position of the attribute within the composite type */
+    private $attNameMap = [];
+
+
+    public function __construct()
+    {
+    }
+
+    /**
+     * Defines a new attribute of this composite type.
+     *
+     * @param string $attName
+     * @param IType $attType
+     */
+    public function addAttribute($attName, IType $attType)
+    {
+        if ((string)$attName == '') {
+            $typeName = "{$this->getSchemaName()}.{$this->getName()}";
+            $msg = "No attribute name given when adding attribute to composite type $typeName";
+            throw new \InvalidArgumentException($msg);
+        }
+        if (isset($this->attributes[$attName])) {
+            $typeName = "{$this->getSchemaName()}.{$this->getName()}";
+            throw new \RuntimeException("Attribute '$attName' already defined on composite type $typeName");
+        }
+        $this->attributes[$attName] = $attType;
+        $this->attNameMap[$attName] = count($this->attNameMap);
+    }
+
+    /**
+     * @return IType[] ordered map: attribute name => attribute type
+     */
+    public function getAttributes()
+    {
+        return $this->attributes;
+    }
+
+    /**
+     * @param string $attName name of an attribute, previously defined by {@link addAttribute()}
+     * @return int|null zero-based position of the given attribute, or <tt>null</tt> if no such attribute is defined
+     */
+    public function getAttPos($attName)
+    {
+        return (isset($this->attNameMap[$attName]) ? $this->attNameMap[$attName] : null);
+    }
+
+    public function parseValue($str)
+    {
+        if ($str === null) {
+            return null;
+        }
+        if ($str == '()' && !$this->attributes) {
+            return Composite::fromList($this, []);
+        }
+
+        $strLen = strlen($str);
+        if ($str[0] != '(' || $str[$strLen - 1] != ')') {
+            throw new \InvalidArgumentException('Invalid value for a composite type - not enclosed in parentheses');
+        }
+        $strOffset = 1;
+
+        $attRegex = '~
 		              "(?:[^"\\\\]|""|\\\\.)*"      # either a double-quoted string (backslashes used for escaping, or
 		                                            # double quotes doubled for a single double-quote character),
                       |                             # or an unquoted string of characters which do not confuse the
                       (?:[^"()\\\\,]|\\\\.)+        # parser or are backslash-escaped
 		             ~x';
-		preg_match_all($attRegex, $str, $matches, PREG_PATTERN_ORDER | PREG_OFFSET_CAPTURE, $strOffset);
-		$atts = [];
-		foreach ($matches[0] as list($att, $attOffset)) {
-			for (; $strOffset < $attOffset; $strOffset++) {
-				if ($str[$strOffset] == ',') {
-					$atts[] = null;
-				}
-				else {
-					$msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
-					throw new \InvalidArgumentException($msg);
-				}
-			}
-			$cont = ($att[0] == '"' ? substr($att, 1, -1) : $att);
-			$atts[] = preg_replace(['~\\\\(.)~', '~""~'], ['$1', '"'], $cont);
-			$strOffset += strlen($att);
-			if (!($str[$strOffset] == ',' || ($str[$strOffset] == ')' && $strOffset == $strLen - 1))) {
-				$msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
-				throw new \InvalidArgumentException($msg);
-			}
-			$strOffset++;
-		}
-		for (; $strOffset < $strLen; $strOffset++) {
-			if ($str[$strOffset] == ',' || ($str[$strOffset] == ')' && $strOffset == $strLen - 1)) {
-				$atts[] = null;
-			}
-			else {
-				$msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
-				throw new \InvalidArgumentException($msg);
-			}
-		}
-
-		/** @var IType[] $types */
-		$types = array_values($this->attributes);
-		if ($types) {
-			if (count($atts) != count($types)) {
-				throw new \InvalidArgumentException(sprintf(
-					'Invalid number of composite value attributes - expecting %d, parsed %d',
-					count($types), count($atts)
-				));
-			}
-			else {
-				$values = [];
-				foreach ($atts as $i => $v) {
-					$values[] = $types[$i]->parseValue($v);
-				}
-			}
-		}
-		else {
-			$values = $atts;
-		}
-
-		return Composite::fromList($this, $values);
-	}
-
-	public function serializeValue($val)
-	{
-		if ($val === null) {
-			return 'NULL';
-		}
-		elseif ($val instanceof Composite) {
-			/** @var IType[] $types */
-			$types = array_values($val->getType()->getAttributes());
-			if ($types) {
-				$itemList = $val->toList();
-				if (count($itemList) != count($types)) {
-					throw new \InvalidArgumentException(sprintf(
-						'Invalid number of composite value attributes - expecting %d, given %d',
-						count($types), count($itemList)
-					));
-				}
-				$items = [];
-				foreach ($itemList as $i => $v) {
-					$items[] = $types[$i]->serializeValue($v);
-				}
-				return self::serializeItems($items);
-			}
-			else {
-				$values = $val->toList();
-			}
-		}
-		elseif (is_array($val)) {
-			$values = $val;
-		}
-		else {
-			$message = "Value '$val' is not valid for type {$this->getSchemaName()}.{$this->getName()}";
-			throw new \InvalidArgumentException($message);
-		}
-
-		$items = [];
-		foreach ($values as $v) {
-			$items[] = ($v === null ? 'NULL' : "'" . strtr((string)$v, ["'" => "''"]) . "'");
-		}
-		return self::serializeItems($items);
-	}
-
-	private static function serializeItems($items)
-	{
-		$res = '(' . implode(',', $items) . ')';
-		if (count($items) < 2) {
-			$res = 'ROW' . $res;
-		}
-		return $res;
-	}
-
-	public function compareValues($a, $b)
-	{
-		if ($a === null || $b === null) {
-			return null;
-		}
-
-		if (!$a instanceof Composite) {
-			throw new IncomparableException('$a is not a ' . Composite::class);
-		}
-		if (!$b instanceof Composite) {
-			throw new IncomparableException('$b is not a ' . Composite::class);
-		}
-		if ($a->getType() !== $b->getType()) {
-			throw new IncomparableException('Different composite types');
-		}
-		$t = $a->getType();
-		if ($t->attributes) {
-			foreach ($t->attributes as $att => $type) {
-				if ($type instanceof ITotallyOrderedType) {
-					$xComp = $type->compareValues($a[$att], $b[$att]);
-					if ($xComp) {
-						return $xComp;
-					}
-				}
-				else {
-					throw new UnsupportedException("The composite {$this->getSchemaName()}.{$this->getName()} attribute $att type $type is not totally ordered.");
-				}
-			}
-			return 0;
-		}
-		else {
-			$al = $a->toList();
-			$bl = $b->toList();
-			if (count($al) != count($bl)) {
-				throw new IncomparableException('Unequal number of composite components');
-			}
-			foreach ($al as $i => $av) {
-				$bv = $bl[$i];
-				$xComp = strcmp((string)$av, (string)$bv);
-				if ($xComp) {
-					return $xComp;
-				}
-			}
-			return 0;
-		}
-	}
+        preg_match_all($attRegex, $str, $matches, PREG_PATTERN_ORDER | PREG_OFFSET_CAPTURE, $strOffset);
+        $atts = [];
+        foreach ($matches[0] as list($att, $attOffset)) {
+            for (; $strOffset < $attOffset; $strOffset++) {
+                if ($str[$strOffset] == ',') {
+                    $atts[] = null;
+                }
+                else {
+                    $msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
+                    throw new \InvalidArgumentException($msg);
+                }
+            }
+            $cont = ($att[0] == '"' ? substr($att, 1, -1) : $att);
+            $atts[] = preg_replace(['~\\\\(.)~', '~""~'], ['$1', '"'], $cont);
+            $strOffset += strlen($att);
+            if (!($str[$strOffset] == ',' || ($str[$strOffset] == ')' && $strOffset == $strLen - 1))) {
+                $msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
+                throw new \InvalidArgumentException($msg);
+            }
+            $strOffset++;
+        }
+        for (; $strOffset < $strLen; $strOffset++) {
+            if ($str[$strOffset] == ',' || ($str[$strOffset] == ')' && $strOffset == $strLen - 1)) {
+                $atts[] = null;
+            }
+            else {
+                $msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
+                throw new \InvalidArgumentException($msg);
+            }
+        }
+
+        /** @var IType[] $types */
+        $types = array_values($this->attributes);
+        if ($types) {
+            if (count($atts) != count($types)) {
+                throw new \InvalidArgumentException(sprintf(
+                    'Invalid number of composite value attributes - expecting %d, parsed %d',
+                    count($types), count($atts)
+                ));
+            }
+            else {
+                $values = [];
+                foreach ($atts as $i => $v) {
+                    $values[] = $types[$i]->parseValue($v);
+                }
+            }
+        }
+        else {
+            $values = $atts;
+        }
+
+        return Composite::fromList($this, $values);
+    }
+
+    public function serializeValue($val)
+    {
+        if ($val === null) {
+            return 'NULL';
+        }
+        elseif ($val instanceof Composite) {
+            /** @var IType[] $types */
+            $types = array_values($val->getType()->getAttributes());
+            if ($types) {
+                $itemList = $val->toList();
+                if (count($itemList) != count($types)) {
+                    throw new \InvalidArgumentException(sprintf(
+                        'Invalid number of composite value attributes - expecting %d, given %d',
+                        count($types), count($itemList)
+                    ));
+                }
+                $items = [];
+                foreach ($itemList as $i => $v) {
+                    $items[] = $types[$i]->serializeValue($v);
+                }
+                return self::serializeItems($items);
+            }
+            else {
+                $values = $val->toList();
+            }
+        }
+        elseif (is_array($val)) {
+            $values = $val;
+        }
+        else {
+            $message = "Value '$val' is not valid for type {$this->getSchemaName()}.{$this->getName()}";
+            throw new \InvalidArgumentException($message);
+        }
+
+        $items = [];
+        foreach ($values as $v) {
+            $items[] = ($v === null ? 'NULL' : "'" . strtr((string)$v, ["'" => "''"]) . "'");
+        }
+        return self::serializeItems($items);
+    }
+
+    private static function serializeItems($items)
+    {
+        $res = '(' . implode(',', $items) . ')';
+        if (count($items) < 2) {
+            $res = 'ROW' . $res;
+        }
+        return $res;
+    }
+
+    public function compareValues($a, $b)
+    {
+        if ($a === null || $b === null) {
+            return null;
+        }
+
+        if (!$a instanceof Composite) {
+            throw new IncomparableException('$a is not a ' . Composite::class);
+        }
+        if (!$b instanceof Composite) {
+            throw new IncomparableException('$b is not a ' . Composite::class);
+        }
+        if ($a->getType() !== $b->getType()) {
+            throw new IncomparableException('Different composite types');
+        }
+        $t = $a->getType();
+        if ($t->attributes) {
+            foreach ($t->attributes as $att => $type) {
+                if ($type instanceof ITotallyOrderedType) {
+                    $xComp = $type->compareValues($a[$att], $b[$att]);
+                    if ($xComp) {
+                        return $xComp;
+                    }
+                }
+                else {
+                    throw new UnsupportedException("The composite {$this->getSchemaName()}.{$this->getName()} attribute $att type $type is not totally ordered.");
+                }
+            }
+            return 0;
+        }
+        else {
+            $al = $a->toList();
+            $bl = $b->toList();
+            if (count($al) != count($bl)) {
+                throw new IncomparableException('Unequal number of composite components');
+            }
+            foreach ($al as $i => $av) {
+                $bv = $bl[$i];
+                $xComp = strcmp((string)$av, (string)$bv);
+                if ($xComp) {
+                    return $xComp;
+                }
+            }
+            return 0;
+        }
+    }
 }

Braces +10 added lines, -20 removed lines

@@ -95,8 +95,7 @@ 
 			for (; $strOffset < $attOffset; $strOffset++) {
 				if ($str[$strOffset] == ',') {
 					$atts[] = null;
-				}
-				else {
+				} else {
 					$msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
 					throw new \InvalidArgumentException($msg);
 				}
@@ -113,8 +112,7 @@ 
 		for (; $strOffset < $strLen; $strOffset++) {
 			if ($str[$strOffset] == ',' || ($str[$strOffset] == ')' && $strOffset == $strLen - 1)) {
 				$atts[] = null;
-			}
-			else {
+			} else {
 				$msg = "Invalid value for a composite type - expecting ',' instead of '{$str[$strOffset]}' at offset $strOffset";
 				throw new \InvalidArgumentException($msg);
 			}
@@ -128,15 +126,13 @@ 
 					'Invalid number of composite value attributes - expecting %d, parsed %d',
 					count($types), count($atts)
 				));
-			}
-			else {
+			} else {
 				$values = [];
 				foreach ($atts as $i => $v) {
 					$values[] = $types[$i]->parseValue($v);
 				}
 			}
-		}
-		else {
+		} else {
 			$values = $atts;
 		}
 
@@ -147,8 +143,7 @@ 
 	{
 		if ($val === null) {
 			return 'NULL';
-		}
-		elseif ($val instanceof Composite) {
+		} elseif ($val instanceof Composite) {
 			/** @var IType[] $types */
 			$types = array_values($val->getType()->getAttributes());
 			if ($types) {
@@ -164,15 +159,12 @@ 
 					$items[] = $types[$i]->serializeValue($v);
 				}
 				return self::serializeItems($items);
-			}
-			else {
+			} else {
 				$values = $val->toList();
 			}
-		}
-		elseif (is_array($val)) {
+		} elseif (is_array($val)) {
 			$values = $val;
-		}
-		else {
+		} else {
 			$message = "Value '$val' is not valid for type {$this->getSchemaName()}.{$this->getName()}";
 			throw new \InvalidArgumentException($message);
 		}
@@ -216,14 +208,12 @@ 
 					if ($xComp) {
 						return $xComp;
 					}
-				}
-				else {
+				} else {
 					throw new UnsupportedException("The composite {$this->getSchemaName()}.{$this->getName()} attribute $att type $type is not totally ordered.");
 				}
 			}
 			return 0;
-		}
-		else {
+		} else {
 			$al = $a->toList();
 			$bl = $b->toList();
 			if (count($al) != count($bl)) {

src/Ivory/Type/EnumType.php

Braces +2 added lines, -4 removed lines

@@ -20,8 +20,7 @@ 
     {
         if ($str === null) {
             return null;
-        }
-        else {
+        } else {
             return $str;
         }
     }
@@ -30,8 +29,7 @@ 
     {
         if ($val === null) {
             return 'NULL';
-        }
-        else {
+        } else {
             if (!isset($this->labelSet[$val])) {
                 $msg = "Value '$val' is not among defined labels of enumeration type {$this->schemaName}.{$this->name}";
                 trigger_error($msg, E_USER_WARNING);

src/Ivory/Type/NamedCompositeType.php

Indentation +6 added lines, -6 removed lines

@@ -10,11 +10,11 @@
  */
 class NamedCompositeType extends CompositeType
 {
-	use NamedDbObject;
+    use NamedDbObject;
 
-	public function __construct($schemaName, $name)
-	{
-		parent::__construct();
-		$this->setName($schemaName, $name);
-	}
+    public function __construct($schemaName, $name)
+    {
+        parent::__construct();
+        $this->setName($schemaName, $name);
+    }
 }

src/Ivory/Type/TotallyOrderedByPhpOperators.php

Braces +2 added lines, -4 removed lines

@@ -12,11 +12,9 @@
         // PHP 7: use the <=> operator as a shorthand
         if ($a < $b) {
             return -1;
-        }
-        elseif ($a == $b) {
+        } elseif ($a == $b) {
             return 0;
-        }
-        else {
+        } else {
             return 1;
         }
     }

src/Ivory/Type/BaseType.php

Indentation +16 added lines, -16 removed lines

@@ -6,24 +6,24 @@
 
 abstract class BaseType implements INamedType
 {
-	use NamedDbObject;
+    use NamedDbObject;
 
-	private $connection;
+    private $connection;
 
-	public function __construct($schemaName, $name, IConnection $connection)
-	{
-		$this->setName($schemaName, $name);
-		$this->connection = $connection;
-	}
+    public function __construct($schemaName, $name, IConnection $connection)
+    {
+        $this->setName($schemaName, $name);
+        $this->connection = $connection;
+    }
 
-	final protected function getConnection()
-	{
-		return $this->connection;
-	}
+    final protected function getConnection()
+    {
+        return $this->connection;
+    }
 
-	protected function throwInvalidValue($str, \Exception $cause = null)
-	{
-		$message = "Value '$str' is not valid for type {$this->schemaName}.{$this->name}";
-		throw new \InvalidArgumentException($message, 0, $cause);
-	}
+    protected function throwInvalidValue($str, \Exception $cause = null)
+    {
+        $message = "Value '$str' is not valid for type {$this->schemaName}.{$this->name}";
+        throw new \InvalidArgumentException($message, 0, $cause);
+    }
 }

src/Ivory/Type/Ivory/IdentifierType.php

Indentation +6 added lines, -6 removed lines

@@ -48,13 +48,13 @@
     }
 
     public function compareValues($a, $b)
-   	{
-   		if ($a === null || $b === null) {
-   			return null;
-   		}
+        {
+            if ($a === null || $b === null) {
+                return null;
+            }
 
-   		return strcmp((string)$a, (string)$b); // FIXME: use the same comparison as StringType
-   	}
+            return strcmp((string)$a, (string)$b); // FIXME: use the same comparison as StringType
+        }
 
     private function needsQuotes($val) : bool
     {

Braces +2 added lines, -4 removed lines

@@ -27,8 +27,7 @@ 
     {
         if ($str === null) {
             return null;
-        }
-        else {
+        } else {
             return $str;
         }
     }
@@ -41,8 +40,7 @@ 
 
         if ($this->needsQuotes($val)) {
             return '"' . str_replace('"', '""', $val) . '"';
-        }
-        else {
+        } else {
             return $val;
         }
     }

src/Ivory/Type/Ivory/QuotedIdentifierType.php

Indentation +6 added lines, -6 removed lines

@@ -38,10 +38,10 @@
     }
 
     public function compareValues($a, $b)
-   	{
-   		if ($a === null || $b === null) {
-   			return null;
-   		}
-   		return strcmp((string)$a, (string)$b); // FIXME: use the same comparison as StringType
-   	}
+        {
+            if ($a === null || $b === null) {
+                return null;
+            }
+            return strcmp((string)$a, (string)$b); // FIXME: use the same comparison as StringType
+        }
 }

Braces +1 added lines, -2 removed lines

@@ -22,8 +22,7 @@
     {
         if ($str === null) {
             return null;
-        }
-        else {
+        } else {
             return $str;
         }
     }

src/Ivory/Type/IRangeCanonicalFuncProvider.php

Indentation +10 added lines, -10 removed lines

@@ -6,14 +6,14 @@
  */
 interface IRangeCanonicalFuncProvider
 {
-	/**
-	 * Provides an implementation of a given canonical function working on a totally ordered type.
-	 *
-	 * @param string $schemaName name of schema the canonical function is defined in
-	 * @param string $funcName name of the canonical function; just the name, without parentheses or arguments
-	 * @param ITotallyOrderedType $subtype subtype for the canonical function to work on
-	 * @return IRangeCanonicalFunc|null the implementation of the range canonical function, or
-	 *                                  <tt>null</tt> if this provider has no matching implementation
-	 */
-	function provideCanonicalFunc($schemaName, $funcName, ITotallyOrderedType $subtype);
+    /**
+     * Provides an implementation of a given canonical function working on a totally ordered type.
+     *
+     * @param string $schemaName name of schema the canonical function is defined in
+     * @param string $funcName name of the canonical function; just the name, without parentheses or arguments
+     * @param ITotallyOrderedType $subtype subtype for the canonical function to work on
+     * @return IRangeCanonicalFunc|null the implementation of the range canonical function, or
+     *                                  <tt>null</tt> if this provider has no matching implementation
+     */
+    function provideCanonicalFunc($schemaName, $funcName, ITotallyOrderedType $subtype);
 }

src/Ivory/Type/IType.php

Indentation +21 added lines, -21 removed lines

@@ -8,26 +8,26 @@
  */
 interface IType
 {
-	/**
-	 * Parses a value of the represented type from its external representation.
-	 *
-	 * The external representation is given by the output function of the PostgreSQL type this object represents.
-	 * In case `null` is given, `null` is returned.
-	 *
-	 * @todo for performance reasons, extend with optional arguments $offset and $len, limiting the part of the string to consider; trimming could thus be implemented as just shifting these positions
-	 * @param string|null $str
-	 * @return mixed the value parsed from <tt>$str</tt>, or <tt>null</tt> if <tt>$str</tt> is <tt>null</tt>
-	 */
-	function parseValue($str);
+    /**
+     * Parses a value of the represented type from its external representation.
+     *
+     * The external representation is given by the output function of the PostgreSQL type this object represents.
+     * In case `null` is given, `null` is returned.
+     *
+     * @todo for performance reasons, extend with optional arguments $offset and $len, limiting the part of the string to consider; trimming could thus be implemented as just shifting these positions
+     * @param string|null $str
+     * @return mixed the value parsed from <tt>$str</tt>, or <tt>null</tt> if <tt>$str</tt> is <tt>null</tt>
+     */
+    function parseValue($str);
 
-	/**
-	 * Serializes a value of the represented type to a string to be pasted in the SQL query.
-	 *
-	 * In case `null` is given, the `'NULL'` string is returned.
-	 *
-	 * @todo unify whether the result shall contain the typecast or not; whether it is necessary depends on the context, so the output of this method shall probably contain no typecasts - the caller should include it, if required
-	 * @param mixed $val
-	 * @return string
-	 */
-	function serializeValue($val);
+    /**
+     * Serializes a value of the represented type to a string to be pasted in the SQL query.
+     *
+     * In case `null` is given, the `'NULL'` string is returned.
+     *
+     * @todo unify whether the result shall contain the typecast or not; whether it is necessary depends on the context, so the output of this method shall probably contain no typecasts - the caller should include it, if required
+     * @param mixed $val
+     * @return string
+     */
+    function serializeValue($val);
 }