Home /Modules/telephony-skya/Communication.sleela

Communication.sleela

telephony-skya/sleela/Communication.sleela · 66 line(s) · sleela

/*
 * telephony-skya/sleela/Communication.sleela
 * SLeeLa โ€” Skya Telephony โ€” emblematic loadable module.
 *
 * Communication is the MESSAGE-exchange layer of a Skya node: the act of
 * reaching a peer, sending a datum, and receiving the answer coherently. Where
 * Servers stands ready and Network describes reach, Communication performs the
 * client-side exchange and keeps a simple, honest tally of what was sent and
 * received so a program can tell whether a conversation actually completed.
 *
 * It is a NATURAL / LOADABLE MODULE carrying the common module contract
 * (`load()` / `loaded()` / `moduleName()` / `describe()`). It uses the same
 * portable VM socket primitives as SkyaClient (`connect`/`sockwrite`/
 * `sockread`/`sockclose`) across the explicit SLeeLa VM/OS bridge.
 */
#sleela 2.1
// Skya telephony โ€” message exchange (loadable module / natural).
class Communication {

  static final String MODULE = "Communication";

  int loadedFlag;
  int sent;            // messages sent
  int received;        // non-empty answers received
  int failures;        // reaches that could not connect

  void load() { loadedFlag = 1; sent = 0; received = 0; failures = 0; }
  boolean loaded() { return loadedFlag == 1; }
  String moduleName() { return MODULE; }

  // Reach `host:port`, send `message`, return the answer ("" on failure or
  // empty answer). Keeps the send/receive tally honest.
  String exchange(String host, int port, String message) {
    int sock = connect(host, port);
    if (sock < 0) { failures = failures + 1; return ""; }
    sockwrite(sock, message);
    sent = sent + 1;
    String response = sockread(sock);
    sockclose(sock);
    if (response != null && response.length() > 0) {
      received = received + 1;
      return response;
    }
    return "";
  }

  // A simple PING exchange: reach a node and confirm it answers.
  boolean ping(String host, int port) {
    String r = exchange(host, port, "PING SKYA/1");
    return r.length() > 0;
  }

  // Was every send answered? (A coherent conversation: nothing sent went
  // unanswered and nothing failed to connect.)
  boolean coherent() { return failures == 0 && sent == received; }

  int sentCount() { return sent; }
  int receivedCount() { return received; }
  int failureCount() { return failures; }

  String describe() {
    return MODULE + " sent=" + sent + " received=" + received
         + " failures=" + failures + " coherent=" + coherent();
  }
}