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

MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-serviceMore...

+ Collaboration diagram for MqContextC_SendApi_Basics_JV_API:

Functions

native void jvmqmsgque.MqContextC.SendEND (String token, long timeout)
  Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service
 
void jvmqmsgque.MqContextC.SendEND (String token)
  Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service
 
native void jvmqmsgque.MqContextC.SendEND_AND_CALLBACK (String token, MqServiceIF callback, long timeout)
  Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback
 
void jvmqmsgque.MqContextC.SendEND_AND_CALLBACK (String token, MqServiceIF callback)
  Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback
 
native void jvmqmsgque.MqContextC.SendEND_AND_SUB (String token, MqServiceIF callback, long timeout)
  Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback
 
void jvmqmsgque.MqContextC.SendEND_AND_SUB (String token, MqServiceIF callback)
  Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback
 
native void jvmqmsgque.MqContextC.SendEND_AND_TRANSACTION (String token, String callback, long timeout)
  Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call
 
void jvmqmsgque.MqContextC.SendEND_AND_TRANSACTION (String token, String callback)
  Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call
 
native void jvmqmsgque.MqContextC.SendEND_AND_WAIT (String token, long timeout)
  Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…
 
void jvmqmsgque.MqContextC.SendEND_AND_WAIT (String token)
  Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…
 
native void jvmqmsgque.MqContextC.SendSTART ()
  Java: ctx.SendSTART() C-API
initialize the send-data-package. …
 
native void jvmqmsgque.MqContextC.SendSYNC ()
  Java: ctx.SendSYNC() C-API
garantee that all pending asynchronous-service-calls are processed. …
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND (JNIEnv *env, jobject self, jstring token, jlong timeout)
  Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1CALLBACK (JNIEnv *env, jobject self, jstring token, jobject callback, jlong timeout)
  Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1SUB (JNIEnv *env, jobject self, jstring token, jobject callback, jlong timeout)
  Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1TRANSACTION (JNIEnv *env, jobject self, jstring token, jstring callback, jlong timeout)
  Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1WAIT (JNIEnv *env, jobject self, jstring token, jlong timeout)
  Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendSTART (JNIEnv *env, jobject self)
  Java: ctx.SendSTART() C-API
initialize the send-data-package. …
 
JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendSYNC (JNIEnv *env, jobject self)
  Java: ctx.SendSYNC() C-API
garantee that all pending asynchronous-service-calls are processed. …
 

Detailed Description

MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service

calling a remote service and wait timeout seconds for an result. If timeout == 0 it is an asynchronous-service-call and if the timeout > 0 it is a synchronous-service-call.

service-call blocking timeout
synchronous yes timeout > 0
asynchronous no timeout == 0

blocking mean waiting max timeout seconds to finishing the service-call:

If an error was raised on the server during the service-processing… the following error-handling will be available

  1. on a synchronous-service-call the error will be the result of the service-call
  2. on a asynchronous-service-call with callback the error will be the result of the callback
  3. on a asynchronous-service-call without callback the error will be send asynchronous from the server to the client . On the client the error will be raised on the NEXT event-handlng-command or as background-error if the MqSetupS::BgError function was defined.
Parameters
[in]mkrtthe MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]ctxthe MqContextS instance to work on
[in]tokenthe MqContextC SERVICE API to identify the service
[in]timeoutin seconds until a timeout-error is raised (possible values like ProcessEvent) (MK_TIMEOUT_DEFAULT=0)
Exceptions
MkExceptionC→ The default-exception from the Programming-Language-Micro-Kernel (PLMK)
See also
MqSendSYNC

calling a remote service and wait timeout seconds for an result. If timeout == 0 it is an asynchronous-service-call and if the timeout > 0 it is a synchronous-service-call.

service-call blocking timeout
synchronous yes timeout > 0
asynchronous no timeout == 0

blocking mean waiting max timeout seconds to finishing the service-call:

If an error was raised on the server during the service-processing… the following error-handling will be available

  1. on a synchronous-service-call the error will be the result of the service-call
  2. on a asynchronous-service-call with callback the error will be the result of the callback
  3. on a asynchronous-service-call without callback the error will be send asynchronous from the server to the client . On the client the error will be raised on the NEXT event-handlng-command or as background-error if the MqSetupS::BgError function was defined.
Parameters
[in]mkrtthe MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]ctxthe MqContextS instance to work on
[in]tokenthe MqContextC SERVICE API to identify the service
[in]timeoutin seconds until a timeout-error is raised (possible values like ProcessEvent) (MK_TIMEOUT_DEFAULT=0)
Exceptions
MkExceptionC→ The default-exception from the Programming-Language-Micro-Kernel (PLMK)
See also
MqSendSYNC

Function Documentation

◆ Java_jvmqmsgque_MqContextC_SendEND()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND ( JNIEnv * env,
jobject self,
jstring token,
jlong timeout )

Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service

Definition at line 2000 of file MqContextC_jv.c.

2000 {
2001 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2002 JavaErrorCheck;
2003 MkRtSetup_X(hdl);
2004 MQ_TOK token_ptr = (token?(*env)->GetStringUTFChars(env,token,NULL):NULL);
2005 JavaErrorCheck;
2006 enum MkErrorE errVal = MqSendEND(hdl, token_ptr, timeout);
2007 MkErrorC_Check(hdl, errVal)
2008 if (token_ptr) (*env)->ReleaseStringUTFChars(env,token,token_ptr);
2009error:
2010 return;
2011}
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) …
#define MqSendEND(...)
MK_STRN MQ_TOK
MqContextC - a char[4+1] or hex[8+1] string used to unique identify a service …
PUBLIC data structure for the jvmqmsgque-specific-data

◆ Java_jvmqmsgque_MqContextC_SendEND_1AND_1CALLBACK()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1CALLBACK ( JNIEnv * env,
jobject self,
jstring token,
jobject callback,
jlong timeout )

Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback

Definition at line 2014 of file MqContextC_jv.c.

2014 {
2015 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2016 JavaErrorCheck;
2017 MkRtSetup_X(hdl);
2018 MQ_TOK token_ptr = (token?(*env)->GetStringUTFChars(env,token,NULL):NULL);
2019 JavaErrorCheck;
2020 MK_CBP callback_ptr = MK(ProcCreate)(MK_RT_CALL env, callback, NULL, NS(MID_callback), true);
2021 JavaErrorCheck;
2022 enum MkErrorE errVal = MqSendEND_AND_CALLBACK(hdl, token_ptr, NS(ServiceCall), callback_ptr, NS(ServiceFree), timeout);
2023 MkErrorC_Check(hdl, errVal)
2024 if (token_ptr) (*env)->ReleaseStringUTFChars(env,token,token_ptr);
2025error:
2026 return;
2027}
MK_PTRB * MK_CBP
#define MK_RT_CALL
#define MqSendEND_AND_CALLBACK(...)

◆ Java_jvmqmsgque_MqContextC_SendEND_1AND_1SUB()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1SUB ( JNIEnv * env,
jobject self,
jstring token,
jobject callback,
jlong timeout )

Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback

Definition at line 2030 of file MqContextC_jv.c.

2030 {
2031 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2032 JavaErrorCheck;
2033 MkRtSetup_X(hdl);
2034 MQ_TOK token_ptr = (token?(*env)->GetStringUTFChars(env,token,NULL):NULL);
2035 JavaErrorCheck;
2036 MK_CBP callback_ptr = MK(ProcCreate)(MK_RT_CALL env, callback, NULL, NS(MID_callback), true);
2037 JavaErrorCheck;
2038 enum MkErrorE errVal = MqSendEND_AND_SUB(hdl, token_ptr, NS(ServiceCall), callback_ptr, NS(ServiceFree), timeout);
2039 MkErrorC_Check(hdl, errVal)
2040 if (token_ptr) (*env)->ReleaseStringUTFChars(env,token,token_ptr);
2041error:
2042 return;
2043}
#define MqSendEND_AND_SUB(...)

◆ Java_jvmqmsgque_MqContextC_SendEND_1AND_1TRANSACTION()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1TRANSACTION ( JNIEnv * env,
jobject self,
jstring token,
jstring callback,
jlong timeout )

Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call

Definition at line 2046 of file MqContextC_jv.c.

2046 {
2047 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2048 JavaErrorCheck;
2049 MkRtSetup_X(hdl);
2050 MQ_TOK token_ptr = (token?(*env)->GetStringUTFChars(env,token,NULL):NULL);
2051 JavaErrorCheck;
2052 MQ_TOK callback_ptr = (callback?(*env)->GetStringUTFChars(env,callback,NULL):NULL);
2053 JavaErrorCheck;
2054 enum MkErrorE errVal = MqSendEND_AND_TRANSACTION(hdl, token_ptr, callback_ptr, timeout);
2055 MkErrorC_Check(hdl, errVal)
2056 if (token_ptr) (*env)->ReleaseStringUTFChars(env,token,token_ptr);
2057 if (callback_ptr) (*env)->ReleaseStringUTFChars(env,callback,callback_ptr);
2058error:
2059 return;
2060}
#define MqSendEND_AND_TRANSACTION(...)

◆ Java_jvmqmsgque_MqContextC_SendEND_1AND_1WAIT()

JNIEXPORT void JNICALL Java_jvmqmsgque_MqContextC_SendEND_1AND_1WAIT ( JNIEnv * env,
jobject self,
jstring token,
jlong timeout )

Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…

Definition at line 2063 of file MqContextC_jv.c.

2063 {
2064 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2065 JavaErrorCheck;
2066 MkRtSetup_X(hdl);
2067 MQ_TOK token_ptr = (token?(*env)->GetStringUTFChars(env,token,NULL):NULL);
2068 JavaErrorCheck;
2069 enum MkErrorE errVal = MqSendEND_AND_WAIT(hdl, token_ptr, timeout);
2070 MkErrorC_Check(hdl, errVal)
2071 if (token_ptr) (*env)->ReleaseStringUTFChars(env,token,token_ptr);
2072error:
2073 return;
2074}
#define MqSendEND_AND_WAIT(...)

◆ Java_jvmqmsgque_MqContextC_SendSTART()

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

Java: ctx.SendSTART() C-API
initialize the send-data-package. …

Definition at line 2077 of file MqContextC_jv.c.

2077 {
2078 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2079 JavaErrorCheck;
2080 MkRtSetup_X(hdl);
2081 enum MkErrorE errVal = MqSendSTART(hdl);
2082 MkErrorC_Check(hdl, errVal)
2083error:
2084 return;
2085}
#define MqSendSTART(...)

◆ Java_jvmqmsgque_MqContextC_SendSYNC()

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

Java: ctx.SendSYNC() C-API
garantee that all pending asynchronous-service-calls are processed. …

Definition at line 2088 of file MqContextC_jv.c.

2088 {
2089 MQ_CTX hdl = (MQ_CTX)pObj2Hdl(env,"MqContextC",self);
2090 JavaErrorCheck;
2091 MkRtSetup_X(hdl);
2092 enum MkErrorE errVal = MqSendSYNC(hdl);
2093 MkErrorC_Check(hdl, errVal)
2094error:
2095 return;
2096}
#define MqSendSYNC(...)

◆ SendEND() [1/2]

void jvmqmsgque.MqContextC.SendEND ( String token)

Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service

Definition at line 895 of file MqContextC.java.

895 {
896 SendEND (token, MkTimeoutE.DEFAULT.get());
897 }
native void SendEND(String token, long timeout)
Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) → C-API MqContextC -...

◆ SendEND() [2/2]

native void jvmqmsgque.MqContextC.SendEND ( String token,
long timeout )

Java: ctx.SendEND(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
MqContextC - finish the send-data-block and call synchronous/asynchronous a remote-service

+ Here is the caller graph for this function:

◆ SendEND_AND_CALLBACK() [1/2]

void jvmqmsgque.MqContextC.SendEND_AND_CALLBACK ( String token,
MqServiceIF callback )

Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback

Definition at line 903 of file MqContextC.java.

903 {
904 SendEND_AND_CALLBACK (token, callback, MkTimeoutE.DEFAULT.get());
905 }
native void SendEND_AND_CALLBACK(String token, MqServiceIF callback, long timeout)
Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE....

◆ SendEND_AND_CALLBACK() [2/2]

native void jvmqmsgque.MqContextC.SendEND_AND_CALLBACK ( String token,
MqServiceIF callback,
long timeout )

Java: ctx.SendEND_AND_CALLBACK(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do not-wait for the result but expect the result on a callback

+ Here is the caller graph for this function:

◆ SendEND_AND_SUB() [1/2]

void jvmqmsgque.MqContextC.SendEND_AND_SUB ( String token,
MqServiceIF callback )

Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback

Definition at line 911 of file MqContextC.java.

911 {
912 SendEND_AND_SUB (token, callback, MkTimeoutE.DEFAULT.get());
913 }
native void SendEND_AND_SUB(String token, MqServiceIF callback, long timeout)
Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE....

◆ SendEND_AND_SUB() [2/2]

native void jvmqmsgque.MqContextC.SendEND_AND_SUB ( String token,
MqServiceIF callback,
long timeout )

Java: ctx.SendEND_AND_SUB(String token, MqServiceIF callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service, do wait for the result and expect multiple sub-results on a callback

+ Here is the caller graph for this function:

◆ SendEND_AND_TRANSACTION() [1/2]

void jvmqmsgque.MqContextC.SendEND_AND_TRANSACTION ( String token,
String callback )

Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call

Definition at line 919 of file MqContextC.java.

919 {
920 SendEND_AND_TRANSACTION (token, callback, MkTimeoutE.DEFAULT.get());
921 }
native void SendEND_AND_TRANSACTION(String token, String callback, long timeout)
Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE....

◆ SendEND_AND_TRANSACTION() [2/2]

native void jvmqmsgque.MqContextC.SendEND_AND_TRANSACTION ( String token,
String callback,
long timeout )

Java: ctx.SendEND_AND_TRANSACTION(String token, String callback, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service to do a longterm-transaction-call

+ Here is the caller graph for this function:

◆ SendEND_AND_WAIT() [1/2]

void jvmqmsgque.MqContextC.SendEND_AND_WAIT ( String token)

Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…

Definition at line 927 of file MqContextC.java.

927 {
928 SendEND_AND_WAIT (token, MkTimeoutE.DEFAULT.get());
929 }
native void SendEND_AND_WAIT(String token, long timeout)
Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?...

◆ SendEND_AND_WAIT() [2/2]

native void jvmqmsgque.MqContextC.SendEND_AND_WAIT ( String token,
long timeout )

Java: ctx.SendEND_AND_WAIT(String token, ?long timeout = MkTimeoutE.DEFAULT.get()?) C-API
finish the send-data-block, call the remote service and wait for result…

+ Here is the caller graph for this function:

◆ SendSTART()

native void jvmqmsgque.MqContextC.SendSTART ( )

Java: ctx.SendSTART() C-API
initialize the send-data-package. …

◆ SendSYNC()

native void jvmqmsgque.MqContextC.SendSYNC ( )

Java: ctx.SendSYNC() C-API
garantee that all pending asynchronous-service-calls are processed. …