ACLs are used to manage permissions for folders and documents. Each ACL contains one or more Access Control Entries (ACE). Each ACE contains a principal, permission(s), and propagation direction. To add a new permission for an object such as a folder, we use the addAcl method on the object. To be able to use this method, we have to first check if the repository supports managing permissions, as follows:
public void addPermissionToFolder(Session session, Folder folder) {
// Check if the repo supports ACLs
RepositoryInfo repoInfo = session.getRepositoryInfo();
if (!repoInfo.getCapabilities().getAclCapability().equals(
CapabilityAcl.MANAGE)) {
logger.warn("Repository does not allow ACL management" +
" [repoName=" + repoInfo.getProductName() +
"][repoVersion=" + repoInfo.getProductVersion() + "]");
} else {
// Check that we got the folder, if not don't
// assign new permission to it
if (folder != null) {
...