All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class guinea.logic.Test

java.lang.Object
   |
   +----guinea.logic.Test

public class Test

extends Object

implements PropertyLoader, Runnable

Variable Index

· currentItem

· currentItemIndex

· defaultPlayerClassName

· defaultSubjectUI

The default subject UI block used for testing.

· disableWhenDone

Disable subject UI when subject is done with item or timeout has expired.

· doneCond

Used to wait until all subject are done.

· enableDoneWhenAnswers

Enable DONE-button only after answers to all questions has been given.

· enableQuestionsAfterPlaying

Answering to questions is allowed only after all samples have been listened to.

· FILETYPE_PROPERTIES

Save data using textual property files.

· FILETYPE_SERIALIZED

Save data using java's serialization system.

· items

List of test items in this test.

· itemsFile

The the file that contains item properties.

· itemsFilename

The name of the file that contains item properties.

· itemsProps

The properties used to contruct the item objects.

· itemStartTime

· itemTemplates

· itemTimeout

The timeout of item in milliseconds.

· itemWarningTimeout

If the time to answer is limited, a warning is given before the time expires.

· listenedSamples

During an item, set to true when all item samples (or sample sequence) has been played.

· MCLL

MCLL level of test.

· MCLLmax

Maximum MCLL that subject can set.

· MCLLmin

Minimum MCLL that subject can set.

· numSwitches

· player

The sound player.

· playerProps

The properties that contain the parameters of the player.

· playlist

The playlist as a vector.

· playlistFile

The file that contains the play list.

· playlistFilename

The name of the file that contains the play list.

· progressStatusMonitorID

The monitor object ID of the test progress monitor object.

· requireAllAnswers

Requires that answer gives answers to all questions.

· resultsFile

The results file.

· resultsFilename

The file name of results file.

· resultsFileType

File type of saving files.

· resultsSaved

Shows whether result file has already been written out.

· samples

List of samples for this test.

· sampleSequence

The fixed sample sequence to play to subjects.

· samplesFile

The file that contains sample information.

· samplesFilename

The name of the file that contains sample information.

· samplesProps

The properties used to contruct the sample objects.

· sampleSwitching

· SEQUENCE_FIXED

Sample sequence is fixed.

· SEQUENCE_FORCED

Sample sequence is forced (same as fixed). Deprecated.

· SEQUENCE_FREE

Subject can play samples freely.

· sequenceType

Type of sequence, free or forced.

· sessionID

ID of the current session.

· sessionLog

· showProgressStatus

Whether to show test progress status information to the subjects.

· subjects

List of subjects participating in this test session.

· subjectSetsMCLL

If set to true, the subject sets the MCL level before proceeding to the actual items.

· SWITCHING_NORMAL

· SWITCHING_PARALLEL

· testDirectory

The directory of the test.

· testInProgress

Is the test in progress right now.

· testThread

The thread that runs the test.

· timeoutOccured

Used in the test to indicate that at least one of subject's answering time has expired.

· TIMINGSTART_AFTER_ITEMRUN

Item duration timing start after the item/sequence has been run.

· TIMINGSTART_BEFORE_ITEMRUN

Item duration timing start before the item/sequence is run.

· trainingMode

Is training mode on (true), results are not saved.

· uiFile

The file that contains UI properties.

· uiFilename

The name of the file that contains UI properties.

· uiProps

The properties used to contruct an UI interface object.

· whenTimingStarts

Tells when to start the timing of the duration of item.

Constructor Index

· Test()

Method Index

· addItem(String, Item)

· addSubject(String)

Add a test subject to the test.

· addSubject(String, SubjectUI)

Add a test subject to the test with a specific subject UI block.

· endItem()

Finish current item.

· endItemSamples()

Unload and remove sample objects that were needed with this item.

· endItemUI()

· endPlayer()

· endTest()

· getDefaultItemTemplate()

Get or construct a default test item template for use with this test.

· getDefaultPlayerClassName()

· getItem(int)

Get test item.

· getItem(String)

Get test item.

· getItemBinding(int)

· getItemBinding(Item)

· getItemBinding(String)

· getItemClassName()

Get the default class name of the test item used by this test.

· getItemIndex(Item)

Get the index of a test item.

· getItemIndex(String)

Get the index of a test item.

· getItemsFile()

· getItemsFilename()

· getItemTemplates()

Get a table (dictionary) of test item templates that are used in the test.

· getItemTimeout()

Get the current value of item timeout

· getItemWarningTimeout()

Get the current value of warning timeout

· getNumItems()

Get the number of items in the test.

· getPlayer()

· getPlaylistFile()

· getPlaylistFilename()

Get the name of the playlist file.

· getProgressStatusInfo()

Get the test progress status info to show to the subject.

· getResultsFile()

· getResultsFilename()

· getSampleSequence()

Get the fixed sample sequence.

· getSamplesFile()

· getSamplesFilename()

· getSampleSwithing()

Get the sample switching type.

· getSequenceType()

Get the type of the sample sequence.

· getSessionID()

· getSubjectItem(String, int)

· getSubjectItem(String, String)

· getTestDirectory()

Get the test directory of this test.

· getTestDirectoryName()

Get the test directory of this test.

· getUIFile()

· getUIFilename()

· initItem()

Initialize current item.

· initItemSamples()

Load and create sample objects for playing.

· initItemUI()

· initPlayer()

Initialize the sound player.

· initTest()

· loadItems()

Load test items from files to the test.

· loadSamples()

· loadTest(String)

Deprecated.

· loadTest(String, String)

Deprecated.

· loadUI()

· loadUI(Properties, String)

Deprecated.

· loadUI(String)

Deprecated.

· loadUI(String, String)

Deprecated.

· loadUIProperties()

· progressCheck()

· progressCheck(String)

· propertyLoad(Properties, String)

· run()

· runItem()

· runSequence()

· runTest()

· saveItemResults()

· saveTestResults()

· serializeResults(String)

· setConfigFile(String)

· setItemsFilename(String)

· setItemTimeout(double)

Set the item timeout.

· setItemWarningTimeout(double)

Set the warning timeout.

· setPlayer(SoundPlayer)

· setPlaylistFile(String)

Set the file name of the playlist file. Deprecated.

· setPlaylistFilename(String)

Set the file name of the playlist file.

· setQuestionsEnabled(boolean)

Enable or disable the question (answer) components for all subjects.

· setResultsFilename(String)

· setSampleSequence(Sequence)

Set the fixed sample sequence.

· setSamplesFilename(String)

· setSampleSwitching(int)

Set the sample switching type.

· setSequenceType(int)

Set the type of the sample sequence.

· setSessionID(String)

· setTestDirectory(File)

Set the test directory.

· setTestDirectory(String)

Set the test directory.

· setUIFilename(String)

· setWarningIndicators(double, double)

Used internally to set the timeout and warning indicators for all subjects.

· setWarningIndicators(int, int)

Used internally to set the timeout and warning indicators for all subjects.

· showProgressStatus(SubjectUI, Object)

Show test progress status to the subject.

· startTest()

· startWarningIndicators()

Variables

 protected transient int currentItemIndex

 protected transient Item currentItem

 protected long itemStartTime

 public static final int SEQUENCE_FIXED

 public static final int SEQUENCE_FORCED

 public static final int SEQUENCE_FREE

 protected int sequenceType

 protected boolean testInProgress

 protected String sessionID

ID of the current session. If no session ID is given, an automatically generated ID is used instead (is will be a string 'S' and the difference, measured in minutes, between the current time and midnight, January 1, 1970 UTC).

 protected BindingVector items

List of test items in this test.

 protected String itemsFilename

The name of the file that contains item properties.

 protected File itemsFile

The the file that contains item properties.

 protected Properties itemsProps

The properties used to contruct the item objects.

 protected Hashtable itemTemplates

 protected String playlistFilename

The name of the file that contains the play list.

 protected File playlistFile

The file that contains the play list.

 protected Vector playlist

The playlist as a vector. It contains the names (IDs) of items that are to be played in this order.

 protected BindingVector subjects

List of subjects participating in this test session.

 protected BindingVector samples

List of samples for this test.

 protected String samplesFilename

The name of the file that contains sample information.

 protected File samplesFile

The file that contains sample information.

 protected Properties samplesProps

The properties used to contruct the sample objects.

 protected boolean disableWhenDone

 protected boolean requireAllAnswers

 protected boolean enableDoneWhenAnswers

 protected boolean enableQuestionsAfterPlaying

 protected transient boolean listenedSamples

 protected Sequence sampleSequence

The fixed sample sequence to play to subjects.

 protected String uiFilename

The name of the file that contains UI properties.

 protected File uiFile

The file that contains UI properties.

 protected Properties uiProps

The properties used to contruct an UI interface object.

 protected SubjectUI defaultSubjectUI

The default subject UI block used for testing. It is loaded from the file 'uiFilename'.

 protected SoundPlayer player

The sound player.

 protected Properties playerProps

The properties that contain the parameters of the player.

 protected transient Thread testThread

The thread that runs the test.

 protected long itemTimeout

 protected long itemWarningTimeout

 protected transient boolean timeoutOccured

 protected boolean trainingMode

 public static final int SWITCHING_NORMAL

 public static final int SWITCHING_PARALLEL

 protected int sampleSwitching

 protected transient int numSwitches

 protected transient KeyCounter doneCond

 protected String resultsFilename

The file name of results file. If null, a name will be created.

 protected File resultsFile

The results file. If null, a name will be created.

 public static final int FILETYPE_SERIALIZED

 public static final int FILETYPE_PROPERTIES

 protected int resultsFileType

 protected boolean resultsSaved

 public static final int TIMINGSTART_BEFORE_ITEMRUN

 public static final int TIMINGSTART_AFTER_ITEMRUN

 public int whenTimingStarts

 protected boolean subjectSetsMCLL

 protected Volume MCLLmin

Minimum MCLL that subject can set.

 protected Volume MCLLmax

Maximum MCLL that subject can set.

 protected Volume MCLL

MCLL level of test.

 protected SessionLog sessionLog

 protected boolean showProgressStatus

 protected String progressStatusMonitorID

The monitor object ID of the test progress monitor object.

 protected File testDirectory

The directory of the test. All pathnames are relative to this directory.

 protected String defaultPlayerClassName

Constructors

 public Test()

Methods

 public Item getItem(int index)

Get test item.

Parameters:

index - is the index to the item list

 public Item getItem(String itemID)

Get test item.

Parameters:

itemID - is the ID of item

 public int getItemIndex(String itemID)

Get the index of a test item.

Parameters:

itemID - is a item id.

 public int getItemIndex(Item item)

Get the index of a test item.

Parameters:

item - is a test item.

 public int getNumItems()

Get the number of items in the test.

Returns:

number of items or -1 if items haven't been loaded yet.

 public Binding getItemBinding(int index)

 public Binding getItemBinding(String itemID)

 public Binding getItemBinding(Item item)

 public void addItem(String name,
                     Item item)

 public Subj addSubject(String subjID,
                        SubjectUI ui)

Add a test subject to the test with a specific subject UI block.

Parameters:

subjID - the subject ID of the subject. If null, a new ID is generated (based on the session's ID).

ui - the UI block that is used with this subject.

Returns:

subject's info object.

 public Subj addSubject(String subjID)

Add a test subject to the test. Subject UI block is loaded from UI file.

Parameters:

subjID - the subject ID of the subject. If null, a new ID is generated (based on the session's ID).

Returns:

subject's info object.

 public static SubjectUI loadUI(String uiFilename) throws ClassNotFoundException, InstantiationException, IllegalAccessException, IOException

Note: loadUI() is deprecated. use SubjectUIHelp.loadUI methods.

 public static SubjectUI loadUI(String uiFilename,
                                String defaultUIClassName) throws ClassNotFoundException, InstantiationException, IllegalAccessException, IOException

Note: loadUI() is deprecated. use SubjectUIHelp.loadUI methods.

 public static SubjectUI loadUI(Properties uiProps,
                                String defaultUIClassName) throws ClassNotFoundException, InstantiationException, IllegalAccessException, IOException

Note: loadUI() is deprecated. use SubjectUIHelp.loadUI methods.

 public SubjectUI loadUI() throws ClassNotFoundException, InstantiationException, IllegalAccessException, IOException

 public Properties loadUIProperties() throws IOException

 public Item getSubjectItem(String subjID,
                            String itemID)

 public Item getSubjectItem(String subjID,
                            int itemIndex)

 public void run()

 public Thread startTest()

 public void runTest()

 public void initTest() throws Exception

 protected void initItemUI()

 protected Object getProgressStatusInfo()

Get the test progress status info to show to the subject.

Returns:

a progress status info object.

 protected void showProgressStatus(SubjectUI ui,
                                   Object info)

Show test progress status to the subject.

Parameters:

ui - The subject UI that shows the info.

info - An object containing status info about the test. If null, no status info is shown.

 protected void runItem() throws InterruptedException

 protected void runSequence() throws InterruptedException

 protected void saveItemResults()

 protected void endItemUI()

 public void saveTestResults() throws Exception

 public void endTest()

 protected void initItem() throws Exception

Initialize current item. Loads samples, reset answers, init gui.

Throws: Exception

an exception is thrown if item initialization fails for some reason.

 protected void endItem()

Finish current item. Unload samples, setup GUI, record answers.

 protected void initItemSamples() throws Exception

Load and create sample objects for playing. Information about samples are read from the information about the current item.

Throws: Exception

initialization of samples may throw a exception if something went wrong.

 protected void endItemSamples()

Unload and remove sample objects that were needed with this item.

 public String getDefaultPlayerClassName()

 protected void initPlayer() throws Exception

Initialize the sound player.

Throws: Exception

an exception is thrown if player initialization fails for some reason.

 protected void endPlayer()

 public void setPlayer(SoundPlayer player)

 public SoundPlayer getPlayer()

 protected void serializeResults(String filename)

 public Sequence getSampleSequence()

Get the fixed sample sequence.

Returns:

The fixed sample sequence that is to play to subjects. Returns null if sequence has not been set.

 public void setSampleSequence(Sequence seq)

Set the fixed sample sequence.

Parameters:

seq - The sequence to be used in the test or null to remove fixed sequence.

 public int getSequenceType()

Get the type of the sample sequence.

Returns:

SEQUENCE_FREE for free sequence or SEQUENCE_FIXED for fixed sequence.

 public void setSequenceType(int type)

Set the type of the sample sequence.

Parameters:

type - SEQUENCE_FREE for free sequence or SEQUENCE_FIXED for fixed sequence.

 public int getSampleSwithing()

Get the sample switching type.

Returns:

SWITCHING_PARALLEL or SWITCHING_NORMAL

 public void setSampleSwitching(int type)

Set the sample switching type.

Parameters:

type - SWITCHING_PARALLEL or SWITCHING_NORMAL

 public void setItemTimeout(double seconds)

Set the item timeout. It is the time the subject has available to give his/hers answers.

Parameters:

secondstimeout - in seconds

 public double getItemTimeout()

Get the current value of item timeout

Returns:

timeout in seconds.

 public void setItemWarningTimeout(double seconds)

Set the warning timeout. It is the time before actual timeout when the warning indicator is lit.

Parameters:

seconds - seconds before the timeout to show the warning.

 public double getItemWarningTimeout()

Get the current value of warning timeout

Returns:

warning timeout in seconds.

 protected void setWarningIndicators(int timeout,
                                     int warning)

Used internally to set the timeout and warning indicators for all subjects.

Parameters:

timeout - timeout in milliseconds

warning - warning time in milliseconds

 protected void setWarningIndicators(double timeout,
                                     double warning)

Used internally to set the timeout and warning indicators for all subjects.

Parameters:

timeout - timeout in seconds

warning - warning time in seconds

 protected void startWarningIndicators()

 public void setSessionID(String sessionID)

 public String getSessionID()

 public void setConfigFile(String filename)

 public File getTestDirectory()

Get the test directory of this test.

Returns:

The test directory.

 public String getTestDirectoryName()

Get the test directory of this test.

Returns:

The directory name.

 public void setTestDirectory(String dir)

Set the test directory.

Parameters:

dir - The test directory. If it is a file, its parent directory will be used.

 public void setTestDirectory(File dir)

Set the test directory.

Parameters:

dir - The test directory. If it is a file, its parent directory will be used.

 protected void progressCheck(String error)

 protected void progressCheck()

 public void loadItems() throws Exception

Load test items from files to the test.

Throws: Exception

if something goes wrong in loading.

 public void loadSamples() throws Exception

 protected void setQuestionsEnabled(boolean enabled)

Enable or disable the question (answer) components for all subjects.

 public String getItemClassName()

Get the default class name of the test item used by this test.

Returns:

A class name of test item.

 public Item getDefaultItemTemplate()

Get or construct a default test item template for use with this test. The default implementation creates a template by creating an instance of the default item class got from getItemClassName(). Subclasses may also override this with their own.

Returns:

A test item template or null if class not specified or instantiation failed.

See Also:

getItemClassName

 public Dictionary getItemTemplates()

Get a table (dictionary) of test item templates that are used in the test. The table generally contains at least the 'default' template.

Parameters:

A - dictionary of test item templates.

 public void setUIFilename(String filename)

 public String getUIFilename()

 public File getUIFile()

 public void setItemsFilename(String filename)

 public String getItemsFilename()

 public File getItemsFile()

 public void setSamplesFilename(String filename)

 public String getSamplesFilename()

 public File getSamplesFile()

 public void setResultsFilename(String filename)

 public String getResultsFilename()

 public File getResultsFile()

 public void setPlaylistFilename(String filename)

Set the file name of the playlist file.

Parameters:

playlist - Name of the playlist file.

 public String getPlaylistFilename()

Get the name of the playlist file.

Returns:

The file name of the playlist or null if no playlist has been set.

 public File getPlaylistFile()

 public void setPlaylistFile(String playlist)

Note: setPlaylistFile() is deprecated. Use setPlaylistFilename instead.

Set the file name of the playlist file.

Parameters:

playlist - Name of the playlist file.

See Also:

setPlaylistFilename

 public void propertyLoad(Properties p,
                          String name) throws IllegalArgumentException

 public static Test loadTest(String configFilename) throws Exception

Note: loadTest() is deprecated. use TestHelp.loadTest methods instead.

 public static Test loadTest(String configFilename,
                             String name) throws Exception

Note: loadTest() is deprecated. use TestHelp.loadTest methods instead.

All Packages  Class Hierarchy  This Package  Previous  Next  Index