vendor/symfony/src/Symfony/Component/Security/Acl/Model/ObjectIdentityInterface.php
changeset 0 7f95f8617b0b
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/vendor/symfony/src/Symfony/Component/Security/Acl/Model/ObjectIdentityInterface.php	Sat Sep 24 15:40:41 2011 +0200
@@ -0,0 +1,49 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Security\Acl\Model;
+
+/**
+ * Represents the identity of an individual domain object instance.
+ *
+ * @author Johannes M. Schmitt <schmittjoh@gmail.com>
+ */
+interface ObjectIdentityInterface
+{
+    /**
+     * We specifically require this method so we can check for object equality
+     * explicitly, and do not have to rely on referencial equality instead.
+     *
+     * Though in most cases, both checks should result in the same outcome.
+     *
+     * Referential Equality: $object1 === $object2
+     * Example for Object Equality: $object1->getId() === $object2->getId()
+     *
+     * @param ObjectIdentityInterface $identity
+     * @return Boolean
+     */
+    function equals(ObjectIdentityInterface $identity);
+
+    /**
+     * Obtains a unique identifier for this object. The identifier must not be
+     * re-used for other objects with the same type.
+     *
+     * @return string cannot return null
+     */
+    function getIdentifier();
+
+    /**
+     * Returns a type for the domain object. Typically, this is the PHP class name.
+     *
+     * @return string cannot return null
+     */
+    function getType();
+}