test.de.iip_ecosphere.platform.connectors

Class AbstractInformationModelConnectorTest<D>

java.lang.Object

test.de.iip_ecosphere.platform.connectors.AbstractInformationModelConnectorTest<D>

Type Parameters:

D - the internal data type of the connector under test

All Implemented Interfaces:

MachineCommandInputTranslator.InputCustomizer, MachineDataOutputTranslator.OutputCustomizer

public abstract class AbstractInformationModelConnectorTest<D>
extends Object
implements MachineCommandInputTranslator.InputCustomizer, MachineDataOutputTranslator.OutputCustomizer

Implements a re-usable information model connector test.

Author:

Holger Eichelberger, SSE

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractInformationModelConnectorTest.Step

Field Summary

Fields

Modifier and Type	Field and Description
private Class<? extends D>	dataType
private static org.slf4j.Logger	LOGGER

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractInformationModelConnectorTest(Class<? extends D> dataType) Creates an instance and sets the internal data type.

Method Summary

Modifier and Type	Method and Description
protected abstract void	afterActions(de.iip_ecosphere.platform.connectors.Connector<D,Object,MachineData,MachineCommand> connector) Do additional actions after testing.
protected abstract void	assertAdditionalProperties(AbstractInformationModelConnectorTest.Step step, MachineData received) Asserts additional properties for the given step of testing.
protected void	block(AtomicInteger count, int receptions) Blocks until a certain number of (accumulated) receptions is reached or fails after 4s.
protected abstract de.iip_ecosphere.platform.connectors.Connector<D,Object,MachineData,MachineCommand>	createConnector(de.iip_ecosphere.platform.connectors.types.ProtocolAdapter<D,Object,MachineData,MachineCommand> adapter) Creates the connector to be tested.
protected abstract Class<? extends de.iip_ecosphere.platform.connectors.ConnectorDescriptor>	getConnectorDescriptor() Returns the connector descriptor for createConnector(ProtocolAdapter).
protected abstract de.iip_ecosphere.platform.connectors.ConnectorParameter	getConnectorParameter() Returns the connector parameters for Connector.connect(ConnectorParameter).
void	testConnector(boolean withNotifications) Tests the connector.

Methods inherited from class java.lang.Object

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

Methods inherited from interface test.de.iip_ecosphere.platform.connectors.MachineCommandInputTranslator.InputCustomizer

additionalFromActions, getQNameOperationStartMachine, getQNameOperationStopMachine, getQNameVarLotSize, getTopLevelModelPartName

Methods inherited from interface test.de.iip_ecosphere.platform.connectors.MachineDataOutputTranslator.OutputCustomizer

getQNameVarLotSize, getQNameVarPowerConsumption, getTopLevelModelPartName, getVendor, initializeModelAccess

Field Detail

LOGGER

private static final org.slf4j.Logger LOGGER

dataType

private Class<? extends D> dataType

Constructor Detail

AbstractInformationModelConnectorTest

protected AbstractInformationModelConnectorTest(Class<? extends D> dataType)

Creates an instance and sets the internal data type.

Parameters:

dataType - the internal data type

Method Detail

getConnectorDescriptor

protected abstract Class<? extends de.iip_ecosphere.platform.connectors.ConnectorDescriptor> getConnectorDescriptor()

Returns the connector descriptor for createConnector(ProtocolAdapter).

Returns:

the connector descriptor

assertAdditionalProperties

protected abstract void assertAdditionalProperties(AbstractInformationModelConnectorTest.Step step,
                                                   MachineData received)

Asserts additional properties for the given step of testing.

Parameters:

step - the testing step

received - the received machine data from the connector

afterActions

protected abstract void afterActions(de.iip_ecosphere.platform.connectors.Connector<D,Object,MachineData,MachineCommand> connector)

Do additional actions after testing.

Parameters:

connector - the connector instance

createConnector

protected abstract de.iip_ecosphere.platform.connectors.Connector<D,Object,MachineData,MachineCommand> createConnector(de.iip_ecosphere.platform.connectors.types.ProtocolAdapter<D,Object,MachineData,MachineCommand> adapter)

Creates the connector to be tested.

Parameters:

adapter - the protocol adapter to use

Returns:

the connector instance to test

getConnectorParameter

protected abstract de.iip_ecosphere.platform.connectors.ConnectorParameter getConnectorParameter()

Returns the connector parameters for Connector.connect(ConnectorParameter).

Returns:

the connector parameters

testConnector

public void testConnector(boolean withNotifications)
                   throws IOException

Tests the connector.

Parameters:

withNotifications - operate with/without notifications (for testing)

Throws:

IOException - in case that creating the connector fails

block

protected void block(AtomicInteger count,
                     int receptions)

Blocks until a certain number of (accumulated) receptions is reached or fails after 4s.

Parameters:

count - the counter

receptions - the expected number of receptions