/*
* Copyright (C) 2005-2013 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* 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
* public class YourTestClass
* {
* // Normally we would initialise the spring application context in another rule.
* @ClassRule public static final ApplicationContextInit APP_CONTEXT_RULE = new ApplicationContextInit();
*
* // We pass the rule that creates the spring application context.
* // This rule will give us a tenant with the domain 'testtenant'.
* @Rule public final AlfrescoTenant tenant = new AlfrescoTenant(APP_CONTEXT_RULE, "testtenant");
*
* @Test public void aTestMethod()
* {
tenant.runAsSystem(new TenantRunAsWork() {
@Override
public Void doWork() throws Exception {
// Do something as the tenant system user.
}
});
* }
* }
*
*
* @author Alex Miller
* @see AlfrescoPerson Consider using {@link AlfrescoPerson} instead, which will create tenants as needed when run in a Cloud build.
*/
public class AlfrescoTenant extends AbstractRule
{
public static final String ADMIN_PASSWORD = "password";
private final String tenantName;
/**
* Constructs the rule with a spring ApplicationContext.
* A GUID-generated tenant name will be used for the test tenant.
*
* @param appContext the spring app context (needed to get at Alfresco services).
*/
public AlfrescoTenant(ApplicationContext appContext)
{
this(appContext, GUID.generate());
}
/**
* Constructs the rule with a reference to a {@link ApplicationContextInit rule} which can be used to retrieve the ApplicationContext.
* A GUID-generated tenant name will be used for the test user.
*
* @param appContextRule a rule which can be used to retrieve the spring app context.
*/
public AlfrescoTenant(ApplicationContextInit appContextRule)
{
this(appContextRule, GUID.generate());
}
/**
* Constructs the rule with a spring ApplicationContext.
*
* @param appContext the spring app context (needed to get at Alfresco services).
* @param tenantName the tenantName for the person to be created.
*/
public AlfrescoTenant(ApplicationContext appContext, String tenantName)
{
super(appContext);
this.tenantName = tenantName.toLowerCase();
}
/**
* Constructs the rule with a reference to a {@link ApplicationContextInit rule} which can be used to retrieve the ApplicationContext.
*
* @param appContextRule a rule which can be used to retrieve the spring app context.
* @param tenantName the name for the tenant to be created.
*/
public AlfrescoTenant(ApplicationContextInit appContextRule, String tenantName)
{
super(appContextRule);
this.tenantName = tenantName.toLowerCase();
}
/**
* Create the tenant.
*/
@Override protected void before() throws Throwable
{
final ApplicationContext appCtx = getApplicationContext();
RetryingTransactionHelper transactionHelper = appCtx.getBean("retryingTransactionHelper", RetryingTransactionHelper.class);
final TenantAdminService tenantAdminService = appCtx.getBean("tenantAdminService", TenantAdminService.class);
transactionHelper.doInTransaction(new RetryingTransactionCallback