/*
* #%L
* Alfresco Repository
* %%
* Copyright (C) 2005 - 2016 Alfresco Software Limited
* %%
* This file is part of the Alfresco software.
* If the software was purchased under a paid Alfresco license, the terms of
* the paid license agreement will prevail. Otherwise, the software is
* provided under the following open source license terms:
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see .
* #L%
*/
package org.alfresco.repo.doclink;
import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;
import javax.transaction.Status;
import javax.transaction.UserTransaction;
import junit.framework.TestCase;
import org.alfresco.error.AlfrescoRuntimeException;
import org.alfresco.model.ApplicationModel;
import org.alfresco.model.ContentModel;
import org.alfresco.repo.security.authentication.AuthenticationUtil;
import org.alfresco.repo.security.authentication.AuthenticationUtil.RunAsWork;
import org.alfresco.repo.security.permissions.AccessDeniedException;
import org.alfresco.service.ServiceRegistry;
import org.alfresco.service.cmr.model.FileFolderService;
import org.alfresco.service.cmr.repository.DeleteLinksStatusReport;
import org.alfresco.service.cmr.repository.DocumentLinkService;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.NodeService;
import org.alfresco.service.cmr.security.PermissionService;
import org.alfresco.service.cmr.security.PersonService;
import org.alfresco.service.cmr.site.SiteService;
import org.alfresco.service.cmr.site.SiteVisibility;
import org.alfresco.service.namespace.QName;
import org.alfresco.service.transaction.TransactionService;
import org.alfresco.util.ApplicationContextHelper;
import org.alfresco.util.GUID;
import org.springframework.context.ApplicationContext;
/**
* Test cases for {@link DocumentLinkServiceImpl}.
*
* @author Ana Bozianu
* @since 5.1
*/
public class DocumentLinkServiceImplTest extends TestCase
{
private static final ApplicationContext ctx = ApplicationContextHelper.getApplicationContext();
private static final String TEST_USER = DocumentLinkServiceImplTest.class.getSimpleName() + "_testuser";
private UserTransaction txn;
private TransactionService transactionService;
private DocumentLinkService documentLinkService;
private PermissionService permissionService;
private PersonService personService;
private SiteService siteService;
private FileFolderService fileFolderService;
private NodeService nodeService;
// nodes the test user has read/write permission to
private NodeRef site1File1;
private NodeRef site1File2; // do not create links of this file
private NodeRef site1Folder1;
private NodeRef site1Folder2;
private NodeRef site1Folder3;
// nodes the test user has no permission to
private NodeRef site2File;
private NodeRef site2Folder1;
private NodeRef site2Folder2;
private NodeRef linkOfFile1Site2;
private String site1File1Name = GUID.generate();
private String site1Folder1Name = GUID.generate();;
@Override
public void setUp() throws Exception
{
// Set up the services
ServiceRegistry serviceRegistry = (ServiceRegistry) ctx.getBean("ServiceRegistry");
transactionService = serviceRegistry.getTransactionService();
documentLinkService = serviceRegistry.getDocumentLinkService();
permissionService = serviceRegistry.getPermissionService();
personService = serviceRegistry.getPersonService();
siteService = serviceRegistry.getSiteService();
fileFolderService = serviceRegistry.getFileFolderService();
nodeService = serviceRegistry.getNodeService();
// Start the transaction
txn = transactionService.getUserTransaction();
txn.begin();
// Authenticate
AuthenticationUtil.setFullyAuthenticatedUser(AuthenticationUtil.getAdminUserName());
/* Create the test user */
Map props = new HashMap();
props.put(ContentModel.PROP_USERNAME, TEST_USER);
personService.createPerson(props);
/*
* Create the working test root 1 to which the user has read/write
* permission
*/
NodeRef site1 = siteService.createSite("site1", GUID.generate(), "myTitle", "myDescription", SiteVisibility.PUBLIC).getNodeRef();
permissionService.setPermission(site1, TEST_USER, PermissionService.ALL_PERMISSIONS, true);
site1Folder1 = fileFolderService.create(site1, site1Folder1Name, ContentModel.TYPE_FOLDER).getNodeRef();
site1File1 = fileFolderService.create(site1Folder1, site1File1Name, ContentModel.TYPE_CONTENT).getNodeRef();
site1File2 = fileFolderService.create(site1Folder1, GUID.generate(), ContentModel.TYPE_CONTENT).getNodeRef();
site1Folder2 = fileFolderService.create(site1, GUID.generate(), ContentModel.TYPE_FOLDER).getNodeRef();
site1Folder3 = fileFolderService.create(site1, GUID.generate(), ContentModel.TYPE_FOLDER).getNodeRef();
// create a link of site1File1 in site1Folder3 to test regular deletion
documentLinkService.createDocumentLink(site1File2, site1Folder3);
/* Create the working test root 2 to which the user has no permission */
NodeRef site2 = siteService.createSite("site2", GUID.generate(), "myTitle", "myDescription", SiteVisibility.PRIVATE).getNodeRef();
permissionService.setPermission(site2, TEST_USER, PermissionService.ALL_PERMISSIONS, false);
site2File = fileFolderService.create(site2, GUID.generate(), ContentModel.TYPE_CONTENT).getNodeRef();
site2Folder1 = fileFolderService.create(site2, GUID.generate(), ContentModel.TYPE_FOLDER).getNodeRef();
site2Folder2 = fileFolderService.create(site2, GUID.generate(), ContentModel.TYPE_FOLDER).getNodeRef();
// Create a link of site1File1 in site2Folder2 to test the deletion
// without permission
linkOfFile1Site2 = documentLinkService.createDocumentLink(site1File2, site2Folder2);
}
@Override
protected void tearDown() throws Exception
{
try
{
if (txn.getStatus() != Status.STATUS_ROLLEDBACK && txn.getStatus() != Status.STATUS_COMMITTED)
{
txn.rollback();
}
}
catch (Throwable e)
{
e.printStackTrace();
}
}
/**
* Tests the creation of a file link
*
* @throws Exception
*/
public void testCreateFileLink() throws Exception
{
// create a link of file site1File1_1 in folder site1Folder2
NodeRef linkNodeRef = documentLinkService.createDocumentLink(site1File1, site1Folder2);
assertNotNull(linkNodeRef);
// test if the link node is listed as a child of site1Folder2
NodeRef linkNodeRef2 = fileFolderService.searchSimple(site1Folder2, site1File1Name);
assertNotNull(linkNodeRef2);
assertEquals(linkNodeRef, linkNodeRef2);
// check the type of the link
assertEquals(nodeService.getType(linkNodeRef), ApplicationModel.TYPE_FILELINK);
// check if the link destination is site1File1_1
NodeRef linkDestination = documentLinkService.getLinkDestination(linkNodeRef);
assertNotNull(linkDestination);
assertEquals(linkDestination, site1File1);
}
/**
* Tests the creation of a folder link
*
* @throws Exception
*/
public void testCreateFolderLink() throws Exception
{
// create a link of file site1File1_1 in folder site1Folder2
NodeRef linkNodeRef = documentLinkService.createDocumentLink(site1Folder1, site1Folder2);
assertNotNull(linkNodeRef);
// test if the link node is listed as a child of site1Folder2
NodeRef linkNodeRef2 = fileFolderService.searchSimple(site1Folder2, site1Folder1Name);
assertNotNull(linkNodeRef2);
assertEquals(linkNodeRef, linkNodeRef2);
// check the type of the link
assertEquals(nodeService.getType(linkNodeRef), ApplicationModel.TYPE_FOLDERLINK);
// check if the link destination is site1File1_1
NodeRef linkDestination = documentLinkService.getLinkDestination(linkNodeRef);
assertNotNull(linkDestination);
assertEquals(linkDestination, site1Folder1);
}
/**
* Tests the behavior of createDocumentLink when providing null arguments
*
* @throws Exception
*/
public void testCreateDocumentWithNullArguments() throws Exception
{
try
{
documentLinkService.createDocumentLink(null, null);
fail("null arguments must generate AlfrescoRuntimeException.");
}
catch (AlfrescoRuntimeException e)
{
// Expected
}
}
/**
* Test the behavior of createDocumentLink when provided a file as a
* destination
*
* @throws Exception
*/
public void testInvalidDestination() throws Exception
{
try
{
documentLinkService.createDocumentLink(site1Folder2, site1File1);
fail("invalid destination argument must generate IllegalArgumentException.");
}
catch (IllegalArgumentException e)
{
// Expected
}
}
/**
* Tests the creation of a document link when the user doesn't have read
* permission on the source node
*
* @throws Exception
*/
public void testCreateDocLinkWithoutReadPermissionOnSource() throws Exception
{
try
{
AuthenticationUtil.runAs(new RunAsWork()
{
@Override
public Void doWork() throws Exception
{
documentLinkService.createDocumentLink(site2File, site1Folder2);
return null;
}
}, TEST_USER);
fail("no read permission on the source node must generate AccessDeniedException.");
}
catch (AccessDeniedException ex)
{
// Expected
}
}
/**
* Tests the creation of a document link when the user doesn't have write
* permission on the destination node
*
* @throws Exception
*/
public void testCreateDocLinkWithoutWritePermissionOnDestination() throws Exception
{
try
{
AuthenticationUtil.runAs(new RunAsWork()
{
@Override
public Void doWork() throws Exception
{
documentLinkService.createDocumentLink(site1File1, site2Folder1);
return null;
}
}, TEST_USER);
fail("no write permission on the destination node must generate AccessDeniedException.");
}
catch (AccessDeniedException ex)
{
// Expected
}
}
/**
* Tests the deletion of a document's links, with and without write
* permissions
*
* @throws Exception
*/
public void testDeleteLinks() throws Exception
{
DeleteLinksStatusReport report = AuthenticationUtil.runAs(new RunAsWork()
{
@Override
public DeleteLinksStatusReport doWork() throws Exception
{
return documentLinkService.deleteLinksToDocument(site1File2);
}
}, TEST_USER);
// check if the service found 2 links of the document
assertEquals(report.getTotalLinksFoundCount(), 2);
// check if the service successfully deleted one
assertEquals(report.getDeletedLinksCount(), 1);
// check if the second one failed with access denied
Throwable ex = report.getErrorDetails().get(linkOfFile1Site2);
assertNotNull(ex);
assertEquals(ex.getClass(), AccessDeniedException.class);
}
}