theLink 10.0 NHI1 - theKernel - theLink - theConfig - theSq3Lite - theCompiler - theBrain - theGuard
c - tcl - cs - py - rb - jv - cc
Loading...
Searching...
No Matches
MqContextC_Link_JV_API

MqContextC - setup and manage a client-server-linkMore...

+ Collaboration diagram for MqContextC_Link_JV_API:

Functions

native MqContextC jvmqmsgque.MqContextC.LinkGetParent ()
  Java: MqContextC ctx.LinkGetParent() C-API
get the initial parent-context from a client/server link …
 
native void jvmqmsgque.MqContextC.LinkConnect ()
  Java: ctx.LinkConnect() C-API
re-connect a client-server-link after a server crash or a network downtime …
 
native void jvmqmsgque.MqContextC.LinkCreate (MkBufferListC args)
  Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link
 
native void jvmqmsgque.MqContextC.LinkCreateChild (MqContextC parent, MkBufferListC args)
  Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link
 
void jvmqmsgque.MqContextC.LinkCreateChild (MqContextC parent, String... args)
  Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link
 
void jvmqmsgque.MqContextC.LinkCreateChild (MqContextC parent)
  Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link
 
void jvmqmsgque.MqContextC.LinkCreate (String... args)
  Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link
 
void jvmqmsgque.MqContextC.LinkCreate ()
  Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link
 
native void jvmqmsgque.MqContextC.LinkDelete ()
  Java: ctx.LinkDelete() C-API
close the client-server-link
 
native int jvmqmsgque.MqContextC.LinkGetCtxId ()
  Java: int ctx.LinkGetCtxId() C-API
get an identifier which is unique per parent-or-child-context
 
native String jvmqmsgque.MqContextC.LinkGetTargetIdent ()
  Java: String ctx.LinkGetTargetIdent() C-API
get the ident of the link-target
 
native boolean jvmqmsgque.MqContextC.LinkIsConnected ()
  Java: boolean ctx.LinkIsConnected() C-API
is the context connected? …
 
native boolean jvmqmsgque.MqContextC.LinkIsParent ()
  Java: boolean ctx.LinkIsParent() C-API
is the context a parent-context? …
 
native void jvmqmsgque.MqContextC.LinkShutdown ()
  Java: ctx.LinkShutdown() C-API
shutdown the communication with a server
 
JNIEXPORT jobject JNICALL Java_jvmqmsgque_MqContextC_LinkGetParent (JNIEnv *env, jobject self)
  Java: MqContextC ctx.LinkGetParent() C-API
get the initial parent-context from a client/server link …
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkConnect (JNIEnv *env, jobject self)
  Java: ctx.LinkConnect() C-API
re-connect a client-server-link after a server crash or a network downtime …
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkCreate (JNIEnv *env, jobject self, jobject args)
  Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkCreateChild (JNIEnv *env, jobject self, jobject parent, jobject args)
  Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkDelete (JNIEnv *env, jobject self)
  Java: ctx.LinkDelete() C-API
close the client-server-link
 
JNIEXPORT jint JNICALL Java_jvmqmsgque_MqContextC_LinkGetCtxId (JNIEnv *env, jobject self)
  Java: int ctx.LinkGetCtxId() C-API
get an identifier which is unique per parent-or-child-context
 
JNIEXPORT jstring JNICALL Java_jvmqmsgque_MqContextC_LinkGetTargetIdent (JNIEnv *env, jobject self)
  Java: String ctx.LinkGetTargetIdent() C-API
get the ident of the link-target
 
JNIEXPORT jboolean JNICALL Java_jvmqmsgque_MqContextC_LinkIsConnected (JNIEnv *env, jobject self)
  Java: boolean ctx.LinkIsConnected() C-API
is the context connected? …
 
JNIEXPORT jboolean JNICALL Java_jvmqmsgque_MqContextC_LinkIsParent (JNIEnv *env, jobject self)
  Java: boolean ctx.LinkIsParent() C-API
is the context a parent-context? …
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkShutdown (JNIEnv *env, jobject self)
  Java: ctx.LinkShutdown() C-API
shutdown the communication with a server
 

Detailed Description

MqContextC - setup and manage a client-server-link

The client-server-link connect two context, a client-parent-context and a server-parent-context. The link can be local (connect two context on the same host) or can be remote (connect two context on different hosts). On-Top the parent-context multiple child-context are allowed.

  !on remote host!                                  !on local host!

      server1---------x                     x----------server2
         |            |                     |             |
         |     child-context-1       child-context-2      |
         |            |                     |             |                      server
 parent-context-1-----x                     x-----parent-context-2
         |                                                |
 (MqConfigS::server)                 (example: MqConfigS::server --fork --uds … --file …)
         |                                                |
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
         |                                                |
      (--tcp)                                  (--pipe, --uds, --tcp)
         |                                                |
 parent-context-1-----x                     x-----parent-context-2
         |            |                     |             |                      client
         |     child-context-1       child-context-2      |
         |            |                     |             |
         x------------x--------client-------x-------------x

                           !on local host!

Definition of a "client-context"

Definition of a "server-context"

client --tcp --host REMOTE_HOST --port REMOTE_PORT ... or
client --uds --file MYFILE ...

Definition of a "parent-context"

Definition of a "child-context"

The client-server-link connect two context, a client-parent-context and a server-parent-context. The link can be local (connect two context on the same host) or can be remote (connect two context on different hosts). On-Top the parent-context multiple child-context are allowed.

  !on remote host!                                  !on local host!

      server1---------x                     x----------server2
         |            |                     |             |
         |     child-context-1       child-context-2      |
         |            |                     |             |                      server
 parent-context-1-----x                     x-----parent-context-2
         |                                                |
 (MqConfigS::server)                 (example: MqConfigS::server --fork --uds … --file …)
         |                                                |
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
         |                                                |
      (--tcp)                                  (--pipe, --uds, --tcp)
         |                                                |
 parent-context-1-----x                     x-----parent-context-2
         |            |                     |             |                      client
         |     child-context-1       child-context-2      |
         |            |                     |             |
         x------------x--------client-------x-------------x

                           !on local host!

Definition of a "client-context"

Definition of a "server-context"

client --tcp --host REMOTE_HOST --port REMOTE_PORT ... or
client --uds --file MYFILE ...

Definition of a "parent-context"

Definition of a "child-context"

Function Documentation

◆ Java_jvmqmsgque_MqContextC_LinkConnect()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkConnect ( JNIEnv * env,
jobject self )

Java: ctx.LinkConnect() C-API
re-connect a client-server-link after a server crash or a network downtime …

Definition at line 894 of file MqContextC_jv.c.

894 {
895 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
896 JavaErrorCheck;
897 MkRtSetup_X(hdl);
898 enum MkErrorE errVal = MqLinkConnect(hdl);
899 MkErrorC_Check(hdl, errVal)
900error:
901 return;
902}
MkErrorE
#define MkRtSetup_X(x)
struct MqContextS * MQ_CTX
class-shortcut for struct MqContextS *, all shortcut using the XX_YYY syntax (only for public API) …
PUBLIC data structure for the jvmqmsgque-specific-data

◆ Java_jvmqmsgque_MqContextC_LinkCreate()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkCreate ( JNIEnv * env,
jobject self,
jobject args )

Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link

Definition at line 905 of file MqContextC_jv.c.

905 {
906 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
907 JavaErrorCheck;
908 MkRtSetup_X(hdl);
909 MK_BAC args_hdl = (MK_BAC)pObj2Hdl__null_allow(env,args);
910 JavaErrorCheck;
911 enum MkErrorE errVal = MqLinkCreate(hdl, args_hdl);
912 MkErrorC_Check(hdl, errVal)
913error:
914 return;
915}
struct MkBufferListS * MK_BAC

◆ Java_jvmqmsgque_MqContextC_LinkCreateChild()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkCreateChild ( JNIEnv * env,
jobject self,
jobject parent,
jobject args )

Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link

Definition at line 918 of file MqContextC_jv.c.

918 {
919 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
920 JavaErrorCheck;
921 MkRtSetup_X(hdl);
922 MQ_CTX parent_hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",parent);
923 JavaErrorCheck;
924 MK_BAC args_hdl = (MK_BAC)pObj2Hdl__null_allow(env,args);
925 JavaErrorCheck;
926 enum MkErrorE errVal = MqLinkCreateChild(hdl, parent_hdl, args_hdl);
927 MkErrorC_Check(hdl, errVal)
928error:
929 return;
930}

◆ Java_jvmqmsgque_MqContextC_LinkDelete()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkDelete ( JNIEnv * env,
jobject self )

Java: ctx.LinkDelete() C-API
close the client-server-link

Definition at line 933 of file MqContextC_jv.c.

933 {
934 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
935 JavaErrorCheck;
936 MkRtSetup_X(hdl);
937 MqLinkDelete(hdl);
938error:
939 return;
940}

◆ Java_jvmqmsgque_MqContextC_LinkGetCtxId()

JNIEXPORT jint JNICALL Java_jvmqmsgque_MqContextC_LinkGetCtxId ( JNIEnv * env,
jobject self )

Java: int ctx.LinkGetCtxId() C-API
get an identifier which is unique per parent-or-child-context

Definition at line 943 of file MqContextC_jv.c.

943 {
944 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
945 JavaErrorCheck;
946 MkRtSetup_X(hdl);
947 MK_NUM __retVal__L = MqLinkGetCtxId(hdl);
948 jint __retVal__S = __retVal__L;
949 return __retVal__S;
950error:
951 return 0;
952}
int32_t MK_NUM

◆ Java_jvmqmsgque_MqContextC_LinkGetParent()

JNIEXPORT jobject JNICALL Java_jvmqmsgque_MqContextC_LinkGetParent ( JNIEnv * env,
jobject self )

Java: MqContextC ctx.LinkGetParent() C-API
get the initial parent-context from a client/server link …

Definition at line 880 of file MqContextC_jv.c.

880 {
881 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
882 JavaErrorCheck;
883 MkRtSetup_X(hdl);
884 MQ_CTX __retVal__L = MqLinkGetParent(hdl);
885 jobject __retVal__S = MQ(MqContextC_ObjNew)(MK_RT_CALL env,__retVal__L);
886 return __retVal__S;
887error:
888 return 0;
889}
#define MK_RT_CALL

◆ Java_jvmqmsgque_MqContextC_LinkGetTargetIdent()

JNIEXPORT jstring JNICALL Java_jvmqmsgque_MqContextC_LinkGetTargetIdent ( JNIEnv * env,
jobject self )

Java: String ctx.LinkGetTargetIdent() C-API
get the ident of the link-target

Definition at line 955 of file MqContextC_jv.c.

955 {
956 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
957 JavaErrorCheck;
958 MkRtSetup_X(hdl);
959 MK_STRN __retVal__L = MqLinkGetTargetIdent(hdl);
960 jstring __retVal__S = JC2O(env,__retVal__L);
961 return __retVal__S;
962error:
963 return 0;
964}
const MK_STRB * MK_STRN

◆ Java_jvmqmsgque_MqContextC_LinkIsConnected()

JNIEXPORT jboolean JNICALL Java_jvmqmsgque_MqContextC_LinkIsConnected ( JNIEnv * env,
jobject self )

Java: boolean ctx.LinkIsConnected() C-API
is the context connected? …

Definition at line 967 of file MqContextC_jv.c.

967 {
968 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
969 JavaErrorCheck;
970 MkRtSetup_X(hdl);
971 MK_BOOL __retVal__L = MqLinkIsConnected(hdl);
972 jboolean __retVal__S = __retVal__L;
973 return __retVal__S;
974error:
975 return 0;
976}
bool MK_BOOL

◆ Java_jvmqmsgque_MqContextC_LinkIsParent()

JNIEXPORT jboolean JNICALL Java_jvmqmsgque_MqContextC_LinkIsParent ( JNIEnv * env,
jobject self )

Java: boolean ctx.LinkIsParent() C-API
is the context a parent-context? …

Definition at line 979 of file MqContextC_jv.c.

979 {
980 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
981 JavaErrorCheck;
982 MkRtSetup_X(hdl);
983 MK_BOOL __retVal__L = MqLinkIsParent(hdl);
984 jboolean __retVal__S = __retVal__L;
985 return __retVal__S;
986error:
987 return 0;
988}

◆ Java_jvmqmsgque_MqContextC_LinkShutdown()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_LinkShutdown ( JNIEnv * env,
jobject self )

Java: ctx.LinkShutdown() C-API
shutdown the communication with a server

Definition at line 991 of file MqContextC_jv.c.

991 {
992 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
993 JavaErrorCheck;
994 MkRtSetup_X(hdl);
995 enum MkErrorE errVal = MqLinkShutdown(hdl);
996 MkErrorC_Check(hdl, errVal)
997error:
998 return;
999}

◆ LinkConnect()

native void jvmqmsgque.MqContextC.LinkConnect ( )

Java: ctx.LinkConnect() C-API
re-connect a client-server-link after a server crash or a network downtime …

◆ LinkCreate() [1/3]

void jvmqmsgque.MqContextC.LinkCreate ( )

Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link

Definition at line 366 of file MqContextC.java.

366 {
367 LinkCreate ((MkBufferListC) null);
368 }
+ Here is the caller graph for this function:

◆ LinkCreate() [2/3]

native void jvmqmsgque.MqContextC.LinkCreate ( MkBufferListC args)

Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link

◆ LinkCreate() [3/3]

void jvmqmsgque.MqContextC.LinkCreate ( String... args)

Java: ctx.LinkCreate(?MkBufferListC args = null?) C-API
make ctx to a parent-context and setup a new client-server-link

Definition at line 361 of file MqContextC.java.

361 {
362 LinkCreate (new MkBufferListC(args));
363 }

◆ LinkCreateChild() [1/3]

void jvmqmsgque.MqContextC.LinkCreateChild ( MqContextC parent)

Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link

Definition at line 356 of file MqContextC.java.

356 {
357 LinkCreateChild (parent, (MkBufferListC) null);
358 }

◆ LinkCreateChild() [2/3]

native void jvmqmsgque.MqContextC.LinkCreateChild ( MqContextC parent,
MkBufferListC args )

Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link

+ Here is the caller graph for this function:

◆ LinkCreateChild() [3/3]

void jvmqmsgque.MqContextC.LinkCreateChild ( MqContextC parent,
String... args )

Java: ctx.LinkCreateChild(MqContextC parent, ?MkBufferListC args = null?) C-API
make a context to a child-context on-top of an existing parent-client-server-link

Definition at line 351 of file MqContextC.java.

351 {
352 LinkCreateChild (parent, new MkBufferListC(args));
353 }

◆ LinkDelete()

native void jvmqmsgque.MqContextC.LinkDelete ( )

Java: ctx.LinkDelete() C-API
close the client-server-link

◆ LinkGetCtxId()

native int jvmqmsgque.MqContextC.LinkGetCtxId ( )

Java: int ctx.LinkGetCtxId() C-API
get an identifier which is unique per parent-or-child-context

◆ LinkGetParent()

native MqContextC jvmqmsgque.MqContextC.LinkGetParent ( )

Java: MqContextC ctx.LinkGetParent() C-API
get the initial parent-context from a client/server link …

◆ LinkGetTargetIdent()

native String jvmqmsgque.MqContextC.LinkGetTargetIdent ( )

Java: String ctx.LinkGetTargetIdent() C-API
get the ident of the link-target

◆ LinkIsConnected()

native boolean jvmqmsgque.MqContextC.LinkIsConnected ( )

Java: boolean ctx.LinkIsConnected() C-API
is the context connected? …

◆ LinkIsParent()

native boolean jvmqmsgque.MqContextC.LinkIsParent ( )

Java: boolean ctx.LinkIsParent() C-API
is the context a parent-context? …

◆ LinkShutdown()

native void jvmqmsgque.MqContextC.LinkShutdown ( )

Java: ctx.LinkShutdown() C-API
shutdown the communication with a server