com.nomagic.magicdraw.tests

Class MagicDrawTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

com.nomagic.magicdraw.tests.NamedTestCase

com.nomagic.magicdraw.tests.MagicDrawTestCase

All Implemented Interfaces:

junit.framework.Test

@OpenApi
public abstract class MagicDrawTestCase
extends com.nomagic.magicdraw.tests.NamedTestCase

Base class for all JUnit Test Cases which should be run in started MagicDraw Application. Starts new MagicDraw application before each test. Provides methods for opening, saving, closing, and comparing projects.

Constructor Summary

Constructors

Constructor and Description
MagicDrawTestCase() Default test case initialization for executing test* methods.
MagicDrawTestCase(java.lang.String method) Creates MagicDrawTestCase for executing specific test method.
MagicDrawTestCase(java.lang.String method, java.lang.String testName) Creates MagicDrawTestCase of specific name for executing specific test method.

Method Summary

Modifier and Type	Method and Description
protected void	checkMemoryLeaks() Force memory leaks test execution.
void	closeAllProjects() Close all currently opened MagicDraw projects with performing memory leaks test.
void	closeProject(Project project) Close opened MagicDraw project.
protected ProjectsComparator	createProjectComparator(java.lang.String logText) Creates project comparator with default model and diagram comparators implementation.
static java.io.File	getFileWithExtension(java.io.File projectFile, java.lang.String extension) Computes test case specific properties file according given project file.
protected org.apache.log4j.Logger	getLogger() Gets logger for Test related output logging.
static java.io.File	getPropertiesFile(java.io.File projectFile) Computes test case specific properties file according given project file.
protected java.util.List<java.lang.String>	getRequiredPlugins() Is used to specify plug-ins required by test case.
protected java.lang.String	getRequiredPluginsDescription() Formats textual message about available plug-ins status(loaded/enabled).
static java.io.File	getXmlFile(java.io.File projectFile) Computes test case specific properties file according given project file.
static void	invokeAndWaitOnDispatcher(java.lang.Runnable r) Executes runnable on dispatcher thread and waits till runnable is done.
boolean	isDoNotUseSilentMode() Check if silent mode is not used for starting MagicDraw.
boolean	isFailed() Check if test has failed because of JUnit assertion or any other exception.
protected boolean	isMemoryTestReady() Check if memory leaks test might be performed.
protected boolean	isRequiredPluginsLoaded() Check if all plug-ins required by this test case are loaded and enabled.
static Project	loadProject(java.lang.String file) Opens MagicDraw project by absolute project file name.
static Project	loadProject(java.lang.String projectPath, boolean failIfProjectHasErrors) Opens MagicDraw project by absolute project file name.
static Project	loadProject(java.lang.String projectPath, boolean failIfProjectHasErrors, boolean loadAllDiagrams) Opens MagicDraw project by absolute project file name.
protected Project	openProject(java.lang.String projectFile) Opens MagicDraw project by its absolute file name.
protected Project	openProject(java.lang.String projectFile, boolean loadAllDiagram) Opens MagicDraw project by its absolute file name.
protected void	saveProject(Project project, java.io.File file) Save opened MagicDraw project to specific file.
void	setDoNotUseSilentMode(boolean doNotUseSilentMode) Specify if MagicDraw should show GUI modal dialogs during startup and features testing.
void	setMemoryTestReady(boolean memoryTestReady) Specify if memory leaks test is ready, so it might be performed at the end of the test.
void	setRunOnEventDispatcher(boolean runOnEventDispatcher) Sets if test case should be executed on event dispatching thread.
void	setRunOnEventDispather(boolean runOnEventDispatcher) Deprecated. spelling error in name, use set #setRunOnEventDispatcher
void	setSkipMemoryTest(boolean skipMemoryTest) Set to true in order to skip memory leaks test.
protected void	setUpTest() Override to prepare test case after MagicDraw application started.
protected void	tearDownTest() Tear down test case after it execution.

Methods inherited from class com.nomagic.magicdraw.tests.NamedTestCase

getFullTestName, getMethodName, getTestName, getTestNamePrefix, isOverridingTestName, runTest, setMethodName, setTestName

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, setName, setUp, tearDown, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MagicDrawTestCase

@OpenApi
public MagicDrawTestCase()

Default test case initialization for executing test* methods.

MagicDrawTestCase

@OpenApi
public MagicDrawTestCase(java.lang.String method)

Creates MagicDrawTestCase for executing specific test method.

Parameters:

method - test method name to execute.

MagicDrawTestCase

@OpenApi
public MagicDrawTestCase(java.lang.String method,
                                  java.lang.String testName)

Creates MagicDrawTestCase of specific name for executing specific test method.

Parameters:

method - test method name to execute.

testName - name of created test. All none alpha numerical characters in name will be replaced by underscore character.

Method Detail

setMemoryTestReady

@OpenApi
public void setMemoryTestReady(boolean memoryTestReady)

Specify if memory leaks test is ready, so it might be performed at the end of the test. Set it false if you need to disable memory leaks test performing at the end of the test.

Parameters:

memoryTestReady -

setSkipMemoryTest

@OpenApi
public void setSkipMemoryTest(boolean skipMemoryTest)

Set to true in order to skip memory leaks test. Memory leaks test is always performed by default after MagicDraw project is closed and after each completed test.

Parameters:

skipMemoryTest - true if memory test should be skipped, false otherwise.

setRunOnEventDispather

@OpenApi
 @Deprecated
public void setRunOnEventDispather(boolean runOnEventDispatcher)

Deprecated. spelling error in name, use set #setRunOnEventDispatcher

Sets if test case should be executed on event dispatching thread. MagicDrawTestCase is run on event dispatcher thread by default.

Parameters:

runOnEventDispatcher - True if test case should be executed on event dispatching thread.

setRunOnEventDispatcher

@OpenApi
public void setRunOnEventDispatcher(boolean runOnEventDispatcher)

Sets if test case should be executed on event dispatching thread. MagicDrawTestCase is run on event dispatcher thread by default.

Parameters:

runOnEventDispatcher - True if test case should be executed on event dispatching thread.

setDoNotUseSilentMode

@OpenApi
public void setDoNotUseSilentMode(boolean doNotUseSilentMode)

Specify if MagicDraw should show GUI modal dialogs during startup and features testing. MagicDraw is started up in silent mode by default.

Parameters:

doNotUseSilentMode - provide true value if GUI dialogs need to be shown during MagicDraw testing.

isDoNotUseSilentMode

@OpenApi
public boolean isDoNotUseSilentMode()

Check if silent mode is not used for starting MagicDraw. Silent mode prevents confirmation dialogs pop-up during MagicDraw test. MagicDraw is started up in silent mode by default.

Returns:

True if MagicDraw is started in Not silent mode.

isMemoryTestReady

@OpenApi
protected boolean isMemoryTestReady()

Check if memory leaks test might be performed.

Returns:

True if memory leaks test is ready and might be performed, false otherwise.

getRequiredPlugins

@OpenApi
protected java.util.List<java.lang.String> getRequiredPlugins()

Is used to specify plug-ins required by test case. Should be overridden in specific MagicDrawTestCase implementation. Default implementation returns empty List.

Returns:

List of plug-in IDs required by this test case.

getRequiredPluginsDescription

@OpenApi
protected java.lang.String getRequiredPluginsDescription()

Formats textual message about available plug-ins status(loaded/enabled).

Returns:

String message about required plug-ins status.

isRequiredPluginsLoaded

@OpenApi
protected boolean isRequiredPluginsLoaded()

Check if all plug-ins required by this test case are loaded and enabled.

Returns:

True if all required plug-ins are loaded and enabled, false otherwise.

setUpTest

@OpenApi
protected void setUpTest()
                           throws java.lang.Exception

Override to prepare test case after MagicDraw application started. Test set up should be done here. Do not use default JUnit setUp() instead.

Throws:

java.lang.Exception - from default JUnit setUp()

tearDownTest

@OpenApi
protected void tearDownTest()
                              throws java.lang.Exception

Tear down test case after it execution. This method is called after test method execution completed but MagicDraw Application not closed yet. Test tear down should be done here. Do not use default JUnit tearDown() instead.

Throws:

java.lang.Exception - from default JUnit tearDown()

closeProject

@OpenApi
public void closeProject(Project project)

Close opened MagicDraw project. Performs memory leaks test after project is closed, so all references to the elements of the closed project should be disposed before method execution.

Parameters:

project - MagicDraw Project to close.

closeAllProjects

@OpenApi
public void closeAllProjects()

Close all currently opened MagicDraw projects with performing memory leaks test. All references to the elements of the closed projects should be disposed before method execution.

checkMemoryLeaks

@OpenApi
protected void checkMemoryLeaks()

Force memory leaks test execution.

invokeAndWaitOnDispatcher

@OpenApi
public static void invokeAndWaitOnDispatcher(java.lang.Runnable r)

Executes runnable on dispatcher thread and waits till runnable is done.

Parameters:

r - Runnable to execute.

getPropertiesFile

@OpenApi
public static java.io.File getPropertiesFile(java.io.File projectFile)

Computes test case specific properties file according given project file. MagicDraw Project properties file pattern "project_name.properties".

Parameters:

projectFile - project file

Returns:

test case properties file

getXmlFile

@OpenApi
public static java.io.File getXmlFile(java.io.File projectFile)

Computes test case specific properties file according given project file. MagicDraw Project properties file pattern "project_name.xml".

Parameters:

projectFile - project file

Returns:

test case properties file

getFileWithExtension

@OpenApi
public static java.io.File getFileWithExtension(java.io.File projectFile,
                                                         java.lang.String extension)

Computes test case specific properties file according given project file. MagicDraw Project properties file pattern "project_name.[extension]".

Parameters:

projectFile - project file

Returns:

test case properties file

loadProject

@OpenApi
public static Project loadProject(java.lang.String file)

Opens MagicDraw project by absolute project file name.

Parameters:

file - absolute file name of project to open.

Returns:

Opened project.

loadProject

@OpenApi
public static Project loadProject(java.lang.String projectPath,
                                           boolean failIfProjectHasErrors)

Opens MagicDraw project by absolute project file name.

Parameters:

projectPath - absolute file name of project to open.

failIfProjectHasErrors - Specifies if test should fail if loaded project has any model inconsistency errors. Recommended to run with silentMode turned on.

Returns:

Opened project.

loadProject

@OpenApi
public static Project loadProject(java.lang.String projectPath,
                                           boolean failIfProjectHasErrors,
                                           boolean loadAllDiagrams)

Opens MagicDraw project by absolute project file name.

Parameters:

projectPath - absolute file name of project to open.

failIfProjectHasErrors - Specifies if test should fail if loaded project has any model inconsistency errors. Recommended to run with silentMode turned on.

Returns:

Opened project.

getLogger

@OpenApi
protected org.apache.log4j.Logger getLogger()

Gets logger for Test related output logging.

Returns:

log4j Logger for TEST category.

See Also:

Logger

isFailed

@OpenApi
public boolean isFailed()

Check if test has failed because of JUnit assertion or any other exception.

Returns:

True if this test has failed, false otherwise.

createProjectComparator

@OpenApi
protected ProjectsComparator createProjectComparator(@CheckForNull
                                                              java.lang.String logText)

Creates project comparator with default model and diagram comparators implementation. Comparator does not compare projects regarding their modules, author information, and diagram info data.

Parameters:

logText - information message which should be printed to log at the beginning of comparison.

Returns:

new instance of ProjectsComparator with model and diagrams comparators initialized.

openProject

@OpenApi
protected Project openProject(java.lang.String projectFile)

Opens MagicDraw project by its absolute file name. It reopens the project if project is already opened.

Parameters:

projectFile - absolute file name of project to open.

Returns:

opened project or null if project cannot be opened.

openProject

@OpenApi
protected Project openProject(java.lang.String projectFile,
                                       boolean loadAllDiagram)

Opens MagicDraw project by its absolute file name. It reopens the project if project is already opened.

Parameters:

projectFile - absolute file name of project to open.

loadAllDiagram - load content of all diagrams in the opened project

Returns:

opened project or null if project cannot be opened.

saveProject

@OpenApi
protected void saveProject(Project project,
                                    java.io.File file)

Save opened MagicDraw project to specific file. S Save is done ins silent mode without any GUI confirmation messages.

Parameters:

project - MagicDraw opened project to save.

file - File to save project.