Implement getAcl method

README.md

@@ -87,7 +87,7 @@ Currently implemented Services
   - [ ] removePolicy
   - [ ] getAppliedPolicies
 - AclSservice
-  - [ ] getACL
+  - [x] getACL
   - [ ] applyACL
 
 

composer.json

@@ -14,6 +14,7 @@
         }
     ],
     "require": {
+        "ext-json": "*",
         "php": ">=7.0.0",
         "dkd/enumeration": "~0.1",
         "dkd/php-populate": "^1",

examples/GetAcl.php

@@ -0,0 +1,89 @@
+<?php
+/**
+ * This example will list the children of the CMIS root folder.
+ * The list is created recursively but is limited to 5 items per level.
+ */
+
+require_once(__DIR__ . '/../vendor/autoload.php');
+if (!is_file(__DIR__ . '/conf/Configuration.php')) {
+    die("Please add your connection credentials to the file \"" . __DIR__ . "/conf/Configuration.php\".\n");
+} else {
+    require_once(__DIR__ . '/conf/Configuration.php');
+}
+
+$httpInvoker = new \GuzzleHttp\Client(
+    [
+        'auth' => [
+            CMIS_BROWSER_USER,
+            CMIS_BROWSER_PASSWORD
+        ]
+    ]
+);
+
+$parameters = [
+    \Dkd\PhpCmis\SessionParameter::BINDING_TYPE => \Dkd\PhpCmis\Enum\BindingType::BROWSER,
+    \Dkd\PhpCmis\SessionParameter::BROWSER_URL => CMIS_BROWSER_URL,
+    \Dkd\PhpCmis\SessionParameter::BROWSER_SUCCINCT => false,
+    \Dkd\PhpCmis\SessionParameter::HTTP_INVOKER_OBJECT => $httpInvoker,
+];
+
+$sessionFactory = new \Dkd\PhpCmis\SessionFactory();
+
+// If no repository id is defined use the first repository
+if (CMIS_REPOSITORY_ID === null) {
+    $repositories = $sessionFactory->getRepositories($parameters);
+    $parameters[\Dkd\PhpCmis\SessionParameter::REPOSITORY_ID] = $repositories[0]->getId();
+} else {
+    $parameters[\Dkd\PhpCmis\SessionParameter::REPOSITORY_ID] = CMIS_REPOSITORY_ID;
+}
+
+$session = $sessionFactory->createSession($parameters);
+
+// Get the root folder of the repository
+$rootFolder = $session->getRootFolder();
+
+echo '+ [ROOT FOLDER]: ' . $rootFolder->getName() . "\n";
+printAcl($rootFolder);
+
+printFolderContent($rootFolder);
+
+function printFolderContent(\Dkd\PhpCmis\Data\FolderInterface $folder, $levelIndention = '  ')
+{
+    $i = 0;
+    foreach ($folder->getChildren() as $children) {
+        echo $levelIndention;
+        $i++;
+        if ($i > 10) {
+            echo "| ...\n";
+            break;
+        }
+
+        if ($children instanceof \Dkd\PhpCmis\Data\FolderInterface) {
+            echo '+ [FOLDER]: ' . $children->getName() . "\n";
+            printAcl($children, $levelIndention);
+        } elseif ($children instanceof \Dkd\PhpCmis\Data\DocumentInterface) {
+            echo '- [DOCUMENT]: ' . $children->getName() . "\n";
+            printAcl($children, $levelIndention);
+        } else {
+            echo '- [ITEM]: ' . $children->getName() . "\n";
+            printAcl($children, $levelIndention);
+        }
+    }
+}
+
+function printAcl(\Dkd\PhpCmis\CmisObject\CmisObjectInterface $item, $levelIndention = '')
+{
+    $acl = $item->getAcl();
+    if ($acl !== null) {
+        foreach ($acl->getAces() as $ace) {
+            printf(
+                "%s    > [ACE]: Principal ID = %s, Permissions = %s\n",
+                $levelIndention,
+                $ace->getPrincipalId(),
+                implode(',', $ace->getPermissions())
+            );
+        }
+    } else {
+        echo $levelIndention . "    > [ACE]: Nothing found. Maybe ACE could not be loaded or does not exist\n";
+    }
+}

src/Bindings/Browser/AclService.php

@@ -11,6 +11,7 @@
  */
 
 use Dkd\PhpCmis\AclServiceInterface;
+use Dkd\PhpCmis\Constants;
 use Dkd\PhpCmis\Data\AclInterface;
 use Dkd\PhpCmis\Data\ExtensionDataInterface;
 use Dkd\PhpCmis\Enum\AclPropagation;
@@ -62,6 +63,8 @@ public function getAcl(
         $onlyBasicPermissions = true,
         ExtensionDataInterface $extension = null
     ) {
-        // TODO: Implement getAcl() method.
+        $url = $this->getObjectUrl($repositoryId, $objectId, Constants::SELECTOR_ACL);
+        $responseData = $this->readJson($url);
+        return $this->getJsonConverter()->convertAcl($responseData);
     }
 }

src/DataObjects/Folder.php

@@ -355,7 +355,7 @@ public function getChildren(OperationContextInterface $context = null)
      *
      * @param integer $depth
      * @param OperationContextInterface|null $context
-     * @return TreeInterface A tree that contains FileableCmisObject objects
+     * @return TreeInterface[] A tree that contains FileableCmisObject objects
      * @see FileableCmisObject FileableCmisObject contained in returned TreeInterface
      */
     public function getDescendants($depth, OperationContextInterface $context = null)

src/Session.php

@@ -752,7 +752,7 @@ public function deleteType($typeId)
      */
     public function getAcl(ObjectIdInterface $objectId, $onlyBasicPermissions)
     {
-        // TODO: Implement getAcl() method.
+        return $this->getBinding()->getAclService()->getAcl($this->getRepositoryId(), $objectId->getId(), $onlyBasicPermissions);
     }
 
     /**