Using Tango servers without DB for unit testing
Intended audience: advanced developers, Programming language: java
Problem overview
One wants to test own server using full tango stack. This test must not be related to any environment and be performed together with other tests.
Detailed cases
Useful for benchmarking. Testing without setting up the whole Tango infrastructure.
Solution overview
It is possible to start Tango server without db: see Device server without database
Java:
Below is how one can integrate it into JUnit framework
1 public class ServerTest {
2
3 public static final String NO_DB_GIOP_PORT = "12345";//any random non-occupied port
4 public static final String NO_DB_INSTANCE = "test_server";
5 public static final String NO_DB_DEVICE_NAME = "test/junit/" +NO_DB_INSTANCE;
6 //our server will run in a dedicated thread
7 private final ExecutorService server = Executors.newSingleThreadExecutor(new ThreadFactory() {
8 @Override
9 public Thread newThread(Runnable r) {
10 Thread thread = new Thread(r);
11 thread.setName("My fancy Tango server");
12 thread.setDaemon(true);
13 return thread;
14 }
15 });
16
17 @Before
18 public void before() throws InterruptedException {
19 System.setProperty("OAPort", NO_DB_GIOP_PORT);
20
21 final CountDownLatch latch = new CountDownLatch(1);
22 server.submit(new Runnable() {
23 @Override
24 public void run() {
25 ServerManager.getInstance().start(new String[]{NO_DB_INSTANCE, "-nodb", "-dlist", NO_DB_DEVICE_NAME}, TestServer.class);//TestServer - is our Tango server we want to test against
26 latch.countDown();
27 }
28 });
29 //make sure server has been started before leaving method
30 latch.await();
31 }
32
33 @After
34 public void after() {
35 server.shutdownNow();
36 }
37
38
39 @Test
40 public void testGetClientId() throws Exception {
41 TangoProxy proxy = TangoProxies.newDeviceProxyWrapper("tango://localhost:" + NO_DB_GIOP_PORT + "/" + NO_DB_DEVICE_NAME + "#dbase=no");
42
43 assertSame(DeviceState.ON,proxy.readAttribute("State"));
44 }
45 }
It is also possible to use 3rd party Tango server to test against. Suppose our Tango server uses other Tango server to perform its tasks (Data aggregation, state monitoring etc). In this case 3rd party binary can be added to the project. This binary can be then launched from within JUnit test:
1 //this test cases uses precompiled TangoTest stored in {PRJ_ROOT}/exec/tango/<win64|debian> folder
2 public class TangoTestProxyWrapperTest {
3 public static final String TANGO_DEV_NAME = "test/local/0";
4 public static final int TANGO_PORT = 16547;
5 public static final String TEST_TANGO = "tango://localhost:" + TANGO_PORT + "/" + TANGO_DEV_NAME + "#dbase=no";
6 public static final String X64 = "x64";
7 public static final String LINUX = "linux";
8 public static final String WINDOWS_7 = "windows 7";
9 public static final String AMD64 = "amd64";
10
11 private static Process PRC;
12
13 @BeforeClass
14 public static void beforeClass() throws Exception {
15 String crtDir = System.getProperty("user.dir");
16 //TODO define executable according to current OS
17 String os = System.getProperty("os.name");
18 String arch = System.getProperty("os.arch");
19 StringBuilder bld = new StringBuilder(crtDir);
20 //TODO other platforms or rely on the environmet
21 if (LINUX.equalsIgnoreCase(os) && AMD64.equals(arch))
22 bld.append("/exec/tango/debian/").append("TangoTest");
23 else if (WINDOWS_7.equalsIgnoreCase(os) && AMD64.equals(arch))
24 bld.append("\\exec\\tango\\win64\\").append("TangoTest");
25 else
26 throw new RuntimeException(String.format("Unsupported platform: name=%s arch=%s", os, arch));
27
28 PRC = new ProcessBuilder(bld.toString(), "test", "-ORBendPoint", "giop:tcp::" + TANGO_PORT, "-nodb", "-dlist", TANGO_DEV_NAME)
29 .start();
30
31 //drain slave's out stream
32 new Thread(new Runnable() {
33 @Override
34 public void run() {
35 char bite;
36 try {
37 while ((bite = (char) PRC.getInputStream().read()) > -1) {
38 System.out.print(bite);
39 }
40 } catch (IOException ignore) {
41 }
42 }
43 }).start();
44
45 //drains slave's err stream
46 new Thread(new Runnable() {
47 @Override
48 public void run() {
49 char bite;
50 try {
51 while ((bite = (char) PRC.getErrorStream().read()) > -1) {
52 System.err.print(bite);
53 }
54 } catch (IOException ignore) {
55 }
56 }
57 }).start();
58 }
59
60 @AfterClass
61 public static void afterClass() throws Exception {
62 PRC.destroy();
63 }
64
65 //this test directly writes/reads to/from TangoTest double_scalar_w
66 @Test
67 public void testWriteReadAttribute_Double() throws Exception {
68 TangoProxy instance = TangoProxies.newDeviceProxyWrapper(TEST_TANGO);
69
70 instance.writeAttribute("double_scalar_w", 0.1984D);
71
72 double result = instance.<Double>readAttribute("double_scalar_w");
73
74 assertEquals(0.1984D, result);
75 }
76
77 //in other test case one can create instance of his own server (see previous code snippet)
78
79 }
CPP:
//TODO
Python:
//TODO