conformance.rmi

Class StubTest

java.lang.Object

test.Test

conformance.rmi.StubTest

public class StubTest
extends Test

Performs basic tests on the public interface of Stub.

These tests are best performed after SkeletonTest.

The tests performed are:

• Stubs cannot be created for classes.
• Stubs cannot be created for non-remote interfaces.
• Stubs cannot be created with null arguments to Stub.create.
• Stubs connect to the address with which they are created.
• Stubs correctly implement equals and hashCode.
• Stubs implement the toString method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	StubTest.ConnectionCheckThread Thread listening for a connection.

Field Summary

Fields

Modifier and Type	Field and Description
private java.net.InetSocketAddress	address Socket address used for the creation of stubs.
private boolean	listening When false, the connection check test is complete.
static java.lang.String	notice Test notice.
static java.lang.Class[]	prerequisites Prerequisites.
private Skeleton<TestInterface>	skeleton Dummy skeleton used during the construction of stubs.
private java.net.ServerSocket	socket Server socket used by the listening thread for the connection check.

Constructor Summary

Constructors

Constructor and Description
StubTest()

Method Summary

Modifier and Type	Method and Description
protected void	clean() Stops the dummy skeleton and testing server.
private void	ensureClassRejected() Ensures that a Stub cannot be created from a class rather than an interface.
private void	ensureLocalMethods() Ensures that stubs for the same skeleton are equal and have the same hash code, and stubs have a string representation.
private void	ensureNonRemoteInterfaceRejected() Ensures that a Stub cannot be created from a non-remote interface.
private void	ensureNullPointerExceptions() Ensures that both Stub.create methods throw NullPointerException when given null for any parameters.
private void	ensureStubConnects() Checks that a stub connects to the server for which it was created.
private void	ensureUnknownHostRejected() Ensures that a stub cannot be created from a skeleton whose address has not been determined.
protected void	initialize() Initializes the test.
protected void	perform() Performs the test.

Methods inherited from class test.Test

cleanupFailure, cleanupSuccess, failure, success, task, task

Methods inherited from class java.lang.Object

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

Field Detail

notice

public static final java.lang.String notice

Test notice.

See Also:

Constant Field Values

prerequisites

public static final java.lang.Class[] prerequisites

Prerequisites.

address

private java.net.InetSocketAddress address

Socket address used for the creation of stubs.

skeleton

private Skeleton<TestInterface> skeleton

Dummy skeleton used during the construction of stubs.

socket

private java.net.ServerSocket socket

Server socket used by the listening thread for the connection check.

listening

private boolean listening

When false, the connection check test is complete.

Constructor Detail

StubTest

public StubTest()

Method Detail

initialize

protected void initialize()
                   throws TestFailed

Initializes the test.

This method creates the listening socket and dummy skeleton used in the test.

Overrides:

initialize in class Test

Throws:

TestFailed

perform

protected void perform()
                throws TestFailed

Performs the test.

Specified by:

perform in class Test

Throws:

TestFailed

ensureStubConnects

private void ensureStubConnects()
                         throws TestFailed

Checks that a stub connects to the server for which it was created.

Throws:

TestFailed - If the stub does not connect.

clean

protected void clean()

Stops the dummy skeleton and testing server.

Overrides:

clean in class Test

ensureUnknownHostRejected

private void ensureUnknownHostRejected()
                                throws TestFailed

Ensures that a stub cannot be created from a skeleton whose address has not been determined.

This method should be used before the test skeleton is started.

Throws:

TestFailed - If IllegalStateException is not thrown.

ensureClassRejected

private void ensureClassRejected()
                          throws TestFailed

Ensures that a Stub cannot be created from a class rather than an interface.

Throws:

TestFailed - If a Stub is created from a class, or if an unexpected exception occurs.

ensureNonRemoteInterfaceRejected

private void ensureNonRemoteInterfaceRejected()
                                       throws TestFailed

Ensures that a Stub cannot be created from a non-remote interface.

Throws:

TestFailed - If a Stub is created from a non-remote interface, or if an unexpected exception occurs.

ensureNullPointerExceptions

private void ensureNullPointerExceptions()
                                  throws TestFailed

Ensures that both Stub.create methods throw NullPointerException when given null for any parameters.

Throws:

TestFailed - If null is given as a parameter but the correct exception is not thrown.

ensureLocalMethods

private void ensureLocalMethods()
                         throws TestFailed

Ensures that stubs for the same skeleton are equal and have the same hash code, and stubs have a string representation.

Throws:

TestFailed - If the test fails.