TestServiceManager (Services (Spring) 0.3.0 Test API)

java.lang.Object
- test.de.iip_ecosphere.platform.services.spring.TestServiceManager

@SpringBootTest(classes=TestServiceManager.Config.class)
 @TestPropertySource(locations="classpath:iipecosphere.yml")
 @ContextConfiguration(initializers=TestServiceManager.Initializer.class)
 @Import(value=de.iip_ecosphere.platform.services.spring.SpringCloudServiceSetup.class)
public class TestServiceManager
extends Object

Tests . We assume that the test artifacts are prepared for MQTT v3.

Author:: Holger Eichelberger, SSE

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private class`	`TestServiceManager.ArtifactAsserter` Artifact asserter interface.
`static class`	`TestServiceManager.Config` Configures the context, in particular through instances that are not loaded automatically by Spring in tests.
`static class`	`TestServiceManager.Initializer`
`private static class`	`TestServiceManager.ServiceImpl` A fake service implementation for testing.

Field Summary

Fields
Modifier and Type	Field and Description
`private static de.iip_ecosphere.platform.support.Server`	`aasServer`
`private static de.iip_ecosphere.platform.support.ServerAddress`	`BROKER`
`private de.iip_ecosphere.platform.services.spring.SpringCloudServiceSetup`	`config`
`private static de.iip_ecosphere.platform.support.Server`	`implServer`
`private List<String>`	`netKeyToRelease`
`private static de.iip_ecosphere.platform.support.iip_aas.ActiveAasBase.NotificationMode`	`oldM`
`private static de.iip_ecosphere.platform.support.iip_aas.AasPartRegistry.AasSetup`	`oldSetup`
`private static Predicate<Object>`	`POSITIVE_GAUGE_VALUE` A predicate testing whether the value of a JSON gauge is positive.
`private static de.iip_ecosphere.platform.support.Server`	`server`
`private List<de.iip_ecosphere.platform.support.Server>`	`serversToRelease`

Constructor Summary

Constructors
Constructor and Description

TestServiceManager()

Constructors
Constructor and Description
`TestServiceManager()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private static void`	`assertFileExists(File file)` Asserts that `file` exists.
`private void`	`assertMetrics(String[] ids, Map<String,Predicate<Object>> expected)` Asserts the existence of selected AAS metrics and/or their values.
`private static void`	`assertReceiverLog()` Asserts the receiver log.
`private void`	`doTestStartStop(String descriptorName, TestServiceManager.ArtifactAsserter asserter, boolean fakeServer)` Implements the tests for a start-stop scenario with different descriptors/related asserters.
`static void`	`init()` Initializes the test by starting an embedded AMQP server.
`private void`	`releaseFakeServiceCommandServers()` Release the servers created in `startFakeServiceCommandServers(ServiceManager, String[])`.
`static void`	`shutdown()` Shuts down client and test server.
`private void`	`startFakeServiceCommandServers(de.iip_ecosphere.platform.services.ServiceManager mgr, String[] ids)` Starts fake service command servers to test the integration of `ServiceStub`.
`void`	`testEnsembleStartStop()` Tests a simple start-stop cycle of the in one process as an ensemble.
`void`	`testSetup()` Tests known/default values in setup.
`void`	`testSimpleStartStop()` Tests a simple start-stop cycle of the with two processes.
`private void`	`testWithZipArchive(boolean useClasspath)` Tests service start/stop with the ZIP artifact containing explicit dependency JARs.
`void`	`testWithZipArchiveAndClasspath()` Tests service start/stop with the ZIP artifact containing explicit dependency JARs and classpath file usage enabled.
`void`	`testWithZipArchiveNoClasspath()` Tests service start/stop with the ZIP artifact containing explicit dependency JARs and no classpath file enabled.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - POSITIVE_GAUGE_VALUE
```
private static final Predicate<Object> POSITIVE_GAUGE_VALUE
```
    A predicate testing whether the value of a JSON gauge is positive.
  - BROKER
```
private static final de.iip_ecosphere.platform.support.ServerAddress BROKER
```
  - server
```
private static de.iip_ecosphere.platform.support.Server server
```
  - oldM
```
private static de.iip_ecosphere.platform.support.iip_aas.ActiveAasBase.NotificationMode oldM
```
  - oldSetup
```
private static de.iip_ecosphere.platform.support.iip_aas.AasPartRegistry.AasSetup oldSetup
```
  - implServer
```
private static de.iip_ecosphere.platform.support.Server implServer
```
  - aasServer
```
private static de.iip_ecosphere.platform.support.Server aasServer
```
  - config
```
@Autowired
private de.iip_ecosphere.platform.services.spring.SpringCloudServiceSetup config
```
  - netKeyToRelease
```
private List<String> netKeyToRelease
```
  - serversToRelease
```
private List<de.iip_ecosphere.platform.support.Server> serversToRelease
```
- Constructor Detail
  - TestServiceManager
```
public TestServiceManager()
```
- Method Detail
  - init
```
public static void init()
```
    Initializes the test by starting an embedded AMQP server. Requires the Qpid configuration file in src/test. We do not rely on MQTT here, because Moquette is not stable enough and Hivemq requires JDK 11.
  - shutdown
```
public static void shutdown()
```
    Shuts down client and test server.
  - testSimpleStartStop
```
public void testSimpleStartStop()
                         throws ExecutionException,
                                IOException
```
    Tests a simple start-stop cycle of the with two processes. This test requires an actual version of test.simpleStream.spring in target/jars - Maven downloads the artifact in the compile phase.
    
    Throws:
    
    ExecutionException - shall not occur for successful test
    
    IOException - shall not occur for successful test
  - assertFileExists
```
private static final void assertFileExists(File file)
```
    Asserts that file exists.
    
    Parameters:
    
    file - the file
  - testEnsembleStartStop
```
public void testEnsembleStartStop()
                           throws ExecutionException,
                                  IOException
```
    Tests a simple start-stop cycle of the in one process as an ensemble. As testSimpleStartStop(), this test requires an actual version of test.simpleStream.spring.
    
    Throws:
    
    ExecutionException - shall not occur for successful test
    
    IOException - shall not occur for successful test
  - doTestStartStop
```
private void doTestStartStop(String descriptorName,
                             TestServiceManager.ArtifactAsserter asserter,
                             boolean fakeServer)
                      throws ExecutionException,
                             IOException
```
    Implements the tests for a start-stop scenario with different descriptors/related asserters.
    
    Parameters:
    
    descriptorName - the descriptor name
    
    asserter - the asserter related to descriptor-specific properties
    
    fakeServer - fake command servers for services - clashes with services that are based on the service environment
    
    Throws:
    
    ExecutionException - if executing service operations fails
    
    IOException - if accessing metrics fails
  - assertReceiverLog
```
private static void assertReceiverLog()
```
    Asserts the receiver log.
  - assertMetrics
```
private void assertMetrics(String[] ids,
                           Map<String,Predicate<Object>> expected)
                    throws IOException,
                           ExecutionException
```
    Asserts the existence of selected AAS metrics and/or their values.
    
    Parameters:
    
    ids - service ids
    
    expected - the expected metrics as key-predicate pairs, whereby the predicate may be null to indicated that the value shall not be tested
    
    Throws:
    
    IOException - if the AAS cannot be retrieved
    
    ExecutionException - if a property cannot be queried
  - startFakeServiceCommandServers
```
private void startFakeServiceCommandServers(de.iip_ecosphere.platform.services.ServiceManager mgr,
                                            String[] ids)
```
    Starts fake service command servers to test the integration of ServiceStub.
    
    Parameters:
    
    mgr - the service manager
    
    ids - the ids of the services to start
  - releaseFakeServiceCommandServers
```
private void releaseFakeServiceCommandServers()
```
    Release the servers created in startFakeServiceCommandServers(ServiceManager, String[]).
  - testSetup
```
public void testSetup()
```
    Tests known/default values in setup.
  - testWithZipArchiveNoClasspath
```
public void testWithZipArchiveNoClasspath()
                                   throws ExecutionException
```
    Tests service start/stop with the ZIP artifact containing explicit dependency JARs and no classpath file enabled.
    
    Throws:
    
    ExecutionException - shall not occur
  - testWithZipArchiveAndClasspath
```
public void testWithZipArchiveAndClasspath()
                                    throws ExecutionException
```
    Tests service start/stop with the ZIP artifact containing explicit dependency JARs and classpath file usage enabled.
    
    Throws:
    
    ExecutionException - shall not occur
  - testWithZipArchive
```
private void testWithZipArchive(boolean useClasspath)
                         throws ExecutionException
```
    Tests service start/stop with the ZIP artifact containing explicit dependency JARs.
    
    Parameters:
    
    useClasspath - consider classpath file
    
    Throws:
    
    ExecutionException - shall not occur

Class TestServiceManager

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

POSITIVE_GAUGE_VALUE

BROKER

server

oldM

oldSetup

implServer

aasServer

config

netKeyToRelease

serversToRelease

Constructor Detail

TestServiceManager

Method Detail

init

shutdown

testSimpleStartStop

assertFileExists

testEnsembleStartStop

doTestStartStop

assertReceiverLog

assertMetrics

startFakeServiceCommandServers

releaseFakeServiceCommandServers

testSetup

testWithZipArchiveNoClasspath

testWithZipArchiveAndClasspath

testWithZipArchive