Package org.alfresco.utility.dsl

Class DSLProtocol<Client>

java.lang.Object

org.alfresco.utility.dsl.DSLWrapper<Client>

org.alfresco.utility.dsl.DSLProtocol<Client>

Type Parameters:

Client -

All Implemented Interfaces:

DSL<Client>

Direct Known Subclasses:

DSLProtocolWithNetworkDrive

public abstract class DSLProtocol<Client>
extends DSLWrapper<Client>
implements DSL<Client>

Extend this class if you want add implementation for a new protocol. See example of CifsWrapper, FtpWrapper

Field Summary

Fields inherited from class org.alfresco.utility.dsl.DSLWrapper

contentService, dataContent, jmxBuilder, LOG

Constructor Summary

Constructors

Constructor	Description
DSLProtocol()

Method Summary

Modifier and Type	Method	Description
Client	and()
DSLAssertion	assertThat()
abstract Client	authenticateUser(UserModel userModel)
String	buildPath(String parent, String... paths)
protected String	buildSiteDocumentLibraryPath(String siteId, String... filesOrFoldersHierarcy)
protected String	buildUserHomePath(String username, String... filesOrFoldersHierarcy)
Client	closeJmxConnection()
abstract Client	disconnect()
String	getCurrentSpace()
UserModel	getCurrentUser()	gets the current test user
abstract String	getDataDictionaryPath()
ContentModel	getLastContentModel()
String	getLastResource()	Returns the last ContentModel resource created within alfresco repository This will return the full path so something like: or -> smb://172.29.100.215/alfresco/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary/ /folder-syKFUjMWgY if CIFS protocol is used
String	getLastResourceWithoutPrefix()	The same as getLastResource() but without the repository prefix So if the lastResource is smb://172.29.100.215/alfresco/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary/ folder-syKFUjMWgY we will return only "/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary//folder-syKFUjMWgY" without "smb://172.29.100.215/alfresco" prefix defined in getPrefixSpace() method
abstract String	getPrefixSpace()
protected abstract String	getProtocolJMXConfigurationStatus()	get the current status true/false of the protocol on test server
String	getProtocolName()
abstract String	getRootPath()
abstract String	getSitesPath()
abstract String	getUserHomesPath()
boolean	isProtocolEnabled()
Client	setCurrentSpace(String currentRepositorySpace)	DSL.getSitesPath(), DSL.getUserHomesPath(), DSL.getDataDictionaryPath(), etc If nothing is specified, the root folder is used
void	setLastContentModel(ContentModel lastContentModel)	The last ContentModel tested from usingResource(ContentModel)
void	setLastResource(String fullPath)	The last resource should be the full path of the last file/folder used in tests
Client	then()
Client	usingAdmin()	Defines the current user to be Admin
abstract Client	usingResource(ContentModel model)	Operations on files or folders If you call this method you can use all assertion within this wrapper
Client	usingRoot()
abstract Client	usingSite(String siteId)	User for changing current site location This method will build the path of the siteId location Example: /Sites//documentLibrary Add implementation for your protocol accordingly
abstract Client	usingSite(SiteModel siteModel)	Defines the current test site to be used based on SiteModel
Client	usingUser(UserModel user)	Defines the current test user that will be used
abstract Client	usingUserHome()
abstract Client	usingUserHome(String username)	Defines the current User Home to be used Example: /User Homes/
Client	waitSeconds(int seconds)
Client	when()

Methods inherited from class org.alfresco.utility.dsl.DSLWrapper

getDataContentService, getTestUser, setTestUser

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DSLProtocol

public DSLProtocol()

Method Details

usingUser

public Client usingUser(UserModel user)
                 throws Exception

Description copied from interface: DSL

Defines the current test user that will be used

Specified by:

usingUser in interface DSL<Client>

Throws:

Exception

usingAdmin

public Client usingAdmin()
                  throws Exception

Description copied from interface: DSL

Defines the current user to be Admin

Specified by:

usingAdmin in interface DSL<Client>

Returns:

Throws:

Exception

getCurrentUser

public UserModel getCurrentUser()

Description copied from interface: DSL

gets the current test user

Specified by:

getCurrentUser in interface DSL<Client>

Returns:

usingRoot

public Client usingRoot()
                 throws Exception

Specified by:

usingRoot in interface DSL<Client>

Returns:

the rootPath

Throws:

Exception

buildSiteDocumentLibraryPath

protected String buildSiteDocumentLibraryPath(String siteId,
 String... filesOrFoldersHierarcy)
                                       throws TestConfigurationException

Parameters:

siteId -

filesOrFoldersHierarcy -

Returns:

the full path of inside /Sites/documentLibrary

Throws:

TestConfigurationException

buildUserHomePath

protected String buildUserHomePath(String username,
 String... filesOrFoldersHierarcy)
                            throws TestConfigurationException

Parameters:

siteId -

filesOrFoldersHierarcy -

Returns:

the full path of inside /User Home/

Throws:

TestConfigurationException

getCurrentSpace

public String getCurrentSpace()
                       throws TestConfigurationException

Specified by:

getCurrentSpace in interface DSL<Client>

Returns:

the current Repository Space, can be: getSitesPath(), getRootPath(), getUserHomesPath(), etc If nothing is specified, the root folder is used

Throws:

TestConfigurationException

setCurrentSpace

public Client setCurrentSpace(String currentRepositorySpace)

Description copied from interface: DSL

DSL.getSitesPath(), DSL.getUserHomesPath(), DSL.getDataDictionaryPath(), etc If nothing is specified, the root folder is used

Specified by:

setCurrentSpace in interface DSL<Client>

closeJmxConnection

public Client closeJmxConnection()
                          throws IOException

Throws:

IOException

getProtocolJMXConfigurationStatus

protected abstract String getProtocolJMXConfigurationStatus()
                                                     throws Exception

get the current status true/false of the protocol on test server

Returns:

Throws:

Exception

isProtocolEnabled

public boolean isProtocolEnabled()
                          throws Exception

Returns:

true/false if current protocl is enabled on server

Throws:

Exception

getLastResource

public String getLastResource()

Returns the last ContentModel resource created within alfresco repository This will return the full path so something like: or -> smb://172.29.100.215/alfresco/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary/ /folder-syKFUjMWgY if CIFS protocol is used

getLastResourceWithoutPrefix

public String getLastResourceWithoutPrefix()

The same as getLastResource() but without the repository prefix So if the lastResource is smb://172.29.100.215/alfresco/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary/ folder-syKFUjMWgY we will return only "/Sites/qcAqgLSMO2OU5txtPMQG/documentLibrary//folder-syKFUjMWgY" without "smb://172.29.100.215/alfresco" prefix defined in getPrefixSpace() method

setLastResource

public void setLastResource(String fullPath)

The last resource should be the full path of the last file/folder used in tests

Parameters:

fullPath -

getProtocolName

public String getProtocolName()

Returns:

the name of the protocol based on the class name

and

public Client and()

then

public Client then()

when

public Client when()

authenticateUser

public abstract Client authenticateUser(UserModel userModel)
                                 throws Exception

Throws:

Exception

disconnect

public abstract Client disconnect()
                           throws Exception

Throws:

Exception

usingSite

public abstract Client usingSite(SiteModel siteModel)
                          throws Exception

Description copied from interface: DSL

Defines the current test site to be used based on SiteModel

Specified by:

usingSite in interface DSL<Client>

Returns:

Throws:

Exception

usingSite

public abstract Client usingSite(String siteId)
                          throws Exception

User for changing current site location This method will build the path of the siteId location Example: /Sites//documentLibrary Add implementation for your protocol accordingly

Specified by:

usingSite in interface DSL<Client>

Parameters:

siteId -

Returns:

Throws:

Exception

usingUserHome

public abstract Client usingUserHome(String username)
                              throws Exception

Description copied from interface: DSL

Defines the current User Home to be used Example: /User Homes/

Specified by:

usingUserHome in interface DSL<Client>

Returns:

Throws:

Exception

usingUserHome

public abstract Client usingUserHome()
                              throws Exception

Specified by:

usingUserHome in interface DSL<Client>

Returns:

the userhome path based on DSL.getCurrentUser()

Throws:

Exception

getRootPath

public abstract String getRootPath()
                            throws TestConfigurationException

Specified by:

getRootPath in interface DSL<Client>

Returns:

the root path

Throws:

TestConfigurationException

getSitesPath

public abstract String getSitesPath()
                             throws TestConfigurationException

Specified by:

getSitesPath in interface DSL<Client>

Returns:

the Sites path Example: /Sites

Throws:

TestConfigurationException

getUserHomesPath

public abstract String getUserHomesPath()
                                 throws TestConfigurationException

Specified by:

getUserHomesPath in interface DSL<Client>

Returns:

user home path Example: /User Homes

Throws:

TestConfigurationException

getDataDictionaryPath

public abstract String getDataDictionaryPath()
                                      throws TestConfigurationException

Specified by:

getDataDictionaryPath in interface DSL<Client>

Returns:

the Data Dictionary path /Data Dictionary

Throws:

TestConfigurationException

getPrefixSpace

public abstract String getPrefixSpace()

usingResource

public abstract Client usingResource(ContentModel model)
                              throws Exception

Operations on files or folders If you call this method you can use all assertion within this wrapper

Specified by:

usingResource in interface DSL<Client>

Parameters:

model -

Returns:

Throws:

Exception

assertThat

public DSLAssertion assertThat()

waitSeconds

public Client waitSeconds(int seconds)

buildPath

public String buildPath(String parent,
 String... paths)

getLastContentModel

public ContentModel getLastContentModel()

setLastContentModel

public void setLastContentModel(ContentModel lastContentModel)

The last ContentModel tested from usingResource(ContentModel)

Parameters:

lastContentModel -