org.assertj.swing.fixture

Interface ItemGroupFixture<S>

Type Parameters:

S - used to simulate "self types." For more information please read "Emulating 'self types' using Java Generics to simplify fluent API implementation."

All Known Implementing Classes:

JComboBoxFixture, JListFixture

public interface ItemGroupFixture<S>

Supports functional testing of Components that contains or display a group of items.

Author:

Alex Ruiz, Yvonne Wang

Method Summary

Methods

Modifier and Type	Method and Description
S	clearSelection() Clears the selection in this fixture's Component.
String[]	contents()
S	requireItemCount(int expected) Verifies that this fixture's Component has the expected number of items
S	requireNoSelection() Verifies that this fixture's Component does not have a selection.
S	requireSelection(int index) Verifies that the index of the selected item in this fixture's Component is equal to the given value.
S	requireSelection(Pattern pattern) Verifies that the value of the selected item in this fixture's Component matches the given regular expression pattern.
S	requireSelection(String value) Verifies that the value of the selected item in this fixture's Component matches the given value.
S	selectItem(int index) Simulates a user selecting an item in this fixture's Component.
S	selectItem(Pattern pattern) Simulates a user selecting an item in this fixture's Component.
S	selectItem(String value) Simulates a user selecting an item in this fixture's Component.
Object	valueAt(int index) Returns the value of an item in the Component managed by this fixture.

Method Detail

contents

@Nonnull
String[] contents()

Returns:

the String representation of the elements in this fixture's Component.

clearSelection

@Nonnull
S clearSelection()

Clears the selection in this fixture's Component.

Returns:

this fixture.

selectItem

@Nonnull
S selectItem(int index)

Simulates a user selecting an item in this fixture's Component.

Parameters:

index - the index of the item to select.

Returns:

this fixture.

selectItem

@Nonnull
S selectItem(@Nullable
                   String value)

Simulates a user selecting an item in this fixture's Component.

Parameters:

value - the value of the item to select. It can be a regular expression.

Returns:

this fixture.

selectItem

@Nonnull
S selectItem(@Nonnull
                   Pattern pattern)

Simulates a user selecting an item in this fixture's Component. The text of the item to select must match the given regular expression pattern.

Parameters:

pattern - the regular expression pattern to match.

Returns:

this fixture.

Throws:

NullPointerException - if the given regular expression pattern is null.

valueAt

@Nullable
Object valueAt(int index)

Returns the value of an item in the Component managed by this fixture. If the value is not meaningful, this method will return null.

Parameters:

index - the index of the item to return.

Returns:

the value of the item under the given index, or null if nothing meaningful.

requireSelection

@Nonnull
S requireSelection(@Nullable
                         String value)

Verifies that the value of the selected item in this fixture's Component matches the given value.

Parameters:

value - the value to match. It can be a regular expression.

Returns:

this fixture.

Throws:

AssertionError - if the selected item does not match the given value.

requireSelection

@Nonnull
S requireSelection(@Nonnull
                         Pattern pattern)

Verifies that the value of the selected item in this fixture's Component matches the given regular expression pattern.

Parameters:

pattern - the regular expression pattern to match.

Returns:

this fixture.

Throws:

NullPointerException - if the given regular expression pattern is null.

AssertionError - if the selected item does not match the given regular expression pattern.

requireSelection

@Nonnull
S requireSelection(int index)

Verifies that the index of the selected item in this fixture's Component is equal to the given value.

Parameters:

index - the expected selection index.

Returns:

this fixture.

Throws:

AssertionError - if the selection index is not equal to the given value.

requireNoSelection

@Nonnull
S requireNoSelection()

Verifies that this fixture's Component does not have a selection.

Returns:

this fixture.

Throws:

AssertionError - if this fixture's Component has a selection.

requireItemCount

@Nonnull
S requireItemCount(int expected)

Verifies that this fixture's Component has the expected number of items

Parameters:

expected - the expected number of items.

Returns:

this fixture.

Throws:

AssertionError - if the number of items in this fixture's Component is not equal to the expected one.