MqContextC_ReadApi_JV_API

MqContextC - extract data from an incoming read-data-package … More...

Collaboration diagram for MqContextC_ReadApi_JV_API:

Topics
	MqContextC_ReadApi_Atom_JV_API
	MqContextC - read a single-data-item outof a read-data-package …
	MqContextC_ReadApi_Block_JV_API
	MqContextC - read a block-of-data outof a read-data-package …
	MqContextC_ReadApi_Misc_JV_API
	MqContextC - various functions to work on a read-data-package …
Object	jvmqmsgque.MqContextC.ReadNEXT ()
List< Object >	jvmqmsgque.MqContextC.ReadLIST ()

Detailed Description

MqContextC - extract data from an incoming read-data-package …

A data-package is read in two different scenarios:

• on a server to serve an incoming service-call from the client
• on a client to process the return-data from a previous service-call

Reading data is a passive-task and the opposite of sending data, which is an active-task. Passive means that the reading process is triggered by an incoming-data-package and not by the software workflow or by the user.
There is a read function and some help functions for each basic type defined in MkBufferC .

Read-Safe

Each service-call has a private read-data-package. This means that during a service-call that is in progress, another service-call can be served without damaging the read-data-package of the current service-call.

Type-Safe

A data-item in a read-data-package is type safe, this mean that every read of a data-item have to match the data-type of the previous write. One exception is available, the cast from and to the string data-type (TYPE=C) is allowed.

Example from server.java → read-safety: Make a nested service-call

class CSV1 implements MqServiceIF {
  public void Callback(MqContextC ctx) {
    // read the input-data from the CSV1-service-call
    // Client → server
    int inI = ctx.ReadI32() + 1;

    // call the CSV2-service at the Client, wait 10sec for timeout
    // server → Client → server
    int retI = ((int)ctx.Send("Wt", 10L, "CSV2:I@I", inI)) + 1;

    // answer the CSV1-service-call with the result from the CSV2-service-call
    // server → Client
    ctx.Send("R", "I", retI);
  }
}

Function Documentation

ReadLIST()

List< Object > jvmqmsgque.MqContextC.ReadLIST

(

)

Definition at line 43 of file MqContextC.java.

                                 {
    return ReadALL().ToList();
  };

ReadNEXT()

Object jvmqmsgque.MqContextC.ReadNEXT

(

)

Definition at line 40 of file MqContextC.java.

                           {
    return ReadBUF().ToObject();
  };