KitCAT - Kit for Converged Application Testing

This document describes the KitCAT API for testing converged applications.

See:
Description

Packages

org.echarts.test.sip
org.echarts.test.sip.commands
org.echarts.test.sip.matchers

This document describes the KitCAT API for testing converged applications. KitCAT is a framework that provides building blocks for testing converged applications. Following are important features in KitCAT:

• A simple sequential execution model for the test writer. The test writer does not have to worry about receiving SIP/RTP messages that arrive asynchronously.
• All test endpoints are hosted in one single process. This facilitates coordination among agents within a test case. Agents can share common data within a test case since they run within the same process address space.
• High level primitives to control test agents (e.g. call, answer). These primitives are simple enough for the test writer to express the most common forms of call-control such as initiating a call, answering a call and ending a call.
• A state-machine based approach to specifying agent behavior.
• Assertion primitives to check assertions on agent states and messages sent/received by agents. These assertion primitives are extensible so that the test writer can write custom assertions suited to the application under test.
• Ability to send/receive RTP stream to/from remote peer.
• Ability to send DTMF key sequence specified as a string.

A simple KitCAT test case is shown below, where two agents establish a call through an application server and we then check for media connectivity.

import org.echarts.test.sip.*;
import org.echarts.jain.sip.*;

import static org.echarts.test.sip.CATMatchers.*;
import static org.hamcrest.Matchers.*;
import static org.junit.Assert.*;

public class TwoWay extends org.echarts.test.sip.CATTestCase {
 public void test() throws Exception {
    //init KitCAT with SIP listen port
    init(33333); 

    SIPAgent caller = createAgent("caller");
    SIPAgent callee = createAgent("callee");

    caller.setProxy("myappserver.xyz.com");
    caller.call(callee);
    processSIP(3000);
    assertThat(callee, is (invited()));
    callee.answer();
    processSIP(3000);
    assertThat(caller, is (connectedTo(callee)));

    caller.clearMediaBuffer();
    callee.playAudio("hello.raw");
    processSIP(3000);
    assertThat(caller, has (incomingMedia()));

    processSIP(5000);
    caller.end();
    processSIP(3000);
    assertThat(caller, is (disconnected()));
    assertThat(callee, is (disconnected()));
 }
}

Related Documentation