src/bindings/java/jmsg_task.cpp

   1 /* Functions related to the java task instances.                            */
   2
   3 /* Copyright (c) 2007-2021. The SimGrid Team. All rights reserved.          */
   4
   5 /* This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the license (GNU LGPL) which comes with this package. */
   7
   8 #include "simgrid/Exception.hpp"
   9 #include "simgrid/s4u/Host.hpp"
  10 #include "src/kernel/context/Context.hpp"
  11
  12 #include "jmsg.hpp"
  13 #include "jmsg_host.h"
  14 #include "jmsg_process.h"
  15 #include "jmsg_task.h"
  16 #include "jxbt_utilities.hpp"
  17
  18 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(java);
  19
  20 static jmethodID jtask_method_Comm_constructor;
  21
  22 static jfieldID jtask_field_Task_bind;
  23 static jfieldID jtask_field_Task_name;
  24 static jfieldID jtask_field_Task_messageSize;
  25 static jfieldID jtask_field_Comm_bind;
  26 static jfieldID jtask_field_Comm_taskBind;
  27 static jfieldID jtask_field_Comm_receiving;
  28
  29 void jtask_bind(jobject jtask, msg_task_t task, JNIEnv * env)
  30 {
  31   env->SetLongField(jtask, jtask_field_Task_bind, (intptr_t)task);
  32 }
  33
  34 msg_task_t jtask_to_native(jobject jtask, JNIEnv* env)
  35 {
  36   return (msg_task_t)(intptr_t)env->GetLongField(jtask, jtask_field_Task_bind);
  37 }
  38
  39 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_nativeInit(JNIEnv *env, jclass cls) {
  40   jclass jtask_class_Comm = env->FindClass("org/simgrid/msg/Comm");
  41   jclass jtask_class_Task = env->FindClass("org/simgrid/msg/Task");
  42   xbt_assert(jtask_class_Comm && jtask_class_Task,
  43              "Native initialization of msg/Comm or msg/Task failed. Please report that bug");
  44
  45   jtask_method_Comm_constructor = env->GetMethodID(jtask_class_Comm, "<init>", "()V");
  46   jtask_field_Task_bind = jxbt_get_jfield(env, jtask_class_Task, "bind", "J");
  47   jtask_field_Task_name = jxbt_get_jfield(env, jtask_class_Task, "name", "Ljava/lang/String;");
  48   jtask_field_Task_messageSize = jxbt_get_jfield(env, jtask_class_Task, "messageSize", "D");
  49   jtask_field_Comm_bind = jxbt_get_jfield(env, jtask_class_Comm, "bind", "J");
  50   jtask_field_Comm_taskBind = jxbt_get_jfield(env, jtask_class_Comm, "taskBind", "J");
  51   jtask_field_Comm_receiving = jxbt_get_jfield(env, jtask_class_Comm, "receiving", "Z");
  52   xbt_assert(jtask_field_Task_bind && jtask_field_Comm_bind && jtask_field_Comm_taskBind &&
  53                  jtask_field_Comm_receiving && jtask_method_Comm_constructor,
  54              "Native initialization of msg/Task failed. Please report that bug");
  55 }
  56
  57 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_create(JNIEnv * env, jobject jtask, jstring jname,
  58                                       jdouble jflopsAmount, jdouble jbytesAmount)
  59 {
  60   jstring_wrapper task_name(env, jname);
  61   msg_task_t task = MSG_task_create(task_name, jflopsAmount, jbytesAmount, jtask);
  62
  63   /* bind & store the task */
  64   jtask_bind(jtask, task, env);
  65 }
  66
  67 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_parallelCreate(JNIEnv * env, jobject jtask, jstring jname,
  68                                          jobjectArray jhosts, jdoubleArray jcomputeDurations_arg,
  69                                          jdoubleArray jmessageSizes_arg)
  70 {
  71   int host_count = env->GetArrayLength(jhosts);
  72
  73   jdouble* jcomputeDurations = env->GetDoubleArrayElements(jcomputeDurations_arg, nullptr);
  74   auto* hosts                = new msg_host_t[host_count];
  75   auto* computeDurations     = new double[host_count];
  76   for (int index = 0; index < host_count; index++) {
  77     jobject jhost           = env->GetObjectArrayElement(jhosts, index);
  78     hosts[index] = jhost_get_native(env, jhost);
  79     computeDurations[index] = jcomputeDurations[index];
  80   }
  81   env->ReleaseDoubleArrayElements(jcomputeDurations_arg, jcomputeDurations, 0);
  82
  83   jdouble* jmessageSizes = env->GetDoubleArrayElements(jmessageSizes_arg, nullptr);
  84   auto* messageSizes     = new double[host_count * host_count];
  85   for (int index = 0; index < host_count * host_count; index++) {
  86     messageSizes[index] = jmessageSizes[index];
  87   }
  88   env->ReleaseDoubleArrayElements(jmessageSizes_arg, jmessageSizes, 0);
  89
  90   /* get the C string from the java string */
  91   jstring_wrapper name(env, jname);
  92   msg_task_t task  = MSG_parallel_task_create(name, host_count, hosts, computeDurations, messageSizes, jtask);
  93
  94   /* associate the java task object and the native task */
  95   jtask_bind(jtask, task, env);
  96
  97   delete[] hosts;
  98   delete[] computeDurations;
  99   delete[] messageSizes;
 100 }
 101
 102 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_cancel(JNIEnv * env, jobject jtask)
 103 {
 104   msg_task_t ptask = jtask_to_native(jtask, env);
 105
 106   if (not ptask) {
 107     jxbt_throw_notbound(env, "task", jtask);
 108     return;
 109   }
 110
 111   msg_error_t rv = MSG_task_cancel(ptask);
 112   xbt_assert(rv == MSG_OK, "MSG_task_cancel() unexpectedly failed with error code %d. Please report this bug", rv);
 113 }
 114
 115 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_execute(JNIEnv * env, jobject jtask)
 116 {
 117   msg_task_t task = jtask_to_native(jtask, env);
 118
 119   if (not task) {
 120     jxbt_throw_notbound(env, "task", jtask);
 121     return;
 122   }
 123   msg_error_t rv;
 124   if (not simgrid::ForcefulKillException::try_n_catch([&rv, &task]() { rv = MSG_task_execute(task); })) {
 125     jxbt_throw_by_name(env, "org/simgrid/msg/ProcessKilledError", "Process killed");
 126   }
 127
 128   if (env->ExceptionOccurred())
 129     return;
 130   if (rv != MSG_OK) {
 131     jmsg_throw_status(env, rv);
 132   }
 133 }
 134
 135 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_setBound(JNIEnv * env, jobject jtask, jdouble bound)
 136 {
 137   msg_task_t task = jtask_to_native(jtask, env);
 138
 139   if (not task) {
 140     jxbt_throw_notbound(env, "task", jtask);
 141     return;
 142   }
 143   MSG_task_set_bound(task, bound);
 144 }
 145
 146 JNIEXPORT jstring JNICALL Java_org_simgrid_msg_Task_getName(JNIEnv * env, jobject jtask) {
 147   const_msg_task_t task = jtask_to_native(jtask, env);
 148
 149   if (not task) {
 150     jxbt_throw_notbound(env, "task", jtask);
 151     return nullptr;
 152   }
 153
 154   return env->NewStringUTF(MSG_task_get_name(task));
 155 }
 156
 157 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_getSender(JNIEnv * env, jobject jtask) {
 158   const_msg_task_t task = jtask_to_native(jtask, env);
 159
 160   if (not task) {
 161     jxbt_throw_notbound(env, "task", jtask);
 162     return nullptr;
 163   }
 164
 165   auto const* process = MSG_task_get_sender(task);
 166   if (process == nullptr) {
 167     return nullptr;
 168   }
 169   return (jobject)jprocess_from_native(process);
 170 }
 171
 172 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_getSource(JNIEnv * env, jobject jtask)
 173 {
 174   const_msg_task_t task = jtask_to_native(jtask, env);
 175
 176   if (not task) {
 177     jxbt_throw_notbound(env, "task", jtask);
 178     return nullptr;
 179   }
 180
 181   auto const* host = MSG_task_get_source(task);
 182   if (host == nullptr) {
 183     return nullptr;
 184   }
 185   if (not host->extension(JAVA_HOST_LEVEL)) {
 186     jxbt_throw_jni(env, "MSG_task_get_source() failed");
 187     return nullptr;
 188   }
 189
 190   return (jobject) host->extension(JAVA_HOST_LEVEL);
 191 }
 192
 193 JNIEXPORT jdouble JNICALL Java_org_simgrid_msg_Task_getFlopsAmount(JNIEnv * env, jobject jtask)
 194 {
 195   const_msg_task_t ptask = jtask_to_native(jtask, env);
 196
 197   if (not ptask) {
 198     jxbt_throw_notbound(env, "task", jtask);
 199     return -1;
 200   }
 201   return (jdouble)MSG_task_get_flops_amount(ptask);
 202 }
 203
 204 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_setName(JNIEnv *env, jobject jtask, jobject jname) {
 205   msg_task_t task = jtask_to_native(jtask, env);
 206
 207   if (not task) {
 208     jxbt_throw_notbound(env, "task", jtask);
 209     return;
 210   }
 211   jstring_wrapper name(env, static_cast<jstring>(jname));
 212
 213   env->SetObjectField(jtask, jtask_field_Task_name, jname);
 214   MSG_task_set_name(task, name);
 215
 216 }
 217
 218 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_setPriority(JNIEnv * env, jobject jtask, jdouble priority)
 219 {
 220   msg_task_t task = jtask_to_native(jtask, env);
 221
 222   if (not task) {
 223     jxbt_throw_notbound(env, "task", jtask);
 224     return;
 225   }
 226   MSG_task_set_priority(task, priority);
 227 }
 228
 229 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_setFlopsAmount (JNIEnv *env, jobject jtask, jdouble computationAmount)
 230 {
 231   msg_task_t task = jtask_to_native(jtask, env);
 232
 233   if (not task) {
 234     jxbt_throw_notbound(env, "task", jtask);
 235     return;
 236   }
 237   MSG_task_set_flops_amount(task, computationAmount);
 238 }
 239
 240 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_setBytesAmount (JNIEnv *env, jobject jtask, jdouble dataSize)
 241 {
 242   msg_task_t task = jtask_to_native(jtask, env);
 243
 244   if (not task) {
 245     jxbt_throw_notbound(env, "task", jtask);
 246     return;
 247   }
 248   env->SetDoubleField(jtask, jtask_field_Task_messageSize, dataSize);
 249   MSG_task_set_bytes_amount(task, dataSize);
 250 }
 251
 252 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_sendBounded(JNIEnv * env,jobject jtask, jstring jalias,
 253                                                              jdouble jtimeout,jdouble maxrate)
 254 {
 255   msg_task_t task = jtask_to_native(jtask, env);
 256   if (not task) {
 257     jxbt_throw_notbound(env, "task", jtask);
 258     return;
 259   }
 260
 261   /* Add a global ref into the Ctask so that the receiver can use it */
 262   MSG_task_set_data(task, env->NewGlobalRef(jtask));
 263
 264   jstring_wrapper alias(env, jalias);
 265   msg_error_t res   = MSG_task_send_with_timeout_bounded(task, alias, jtimeout, maxrate);
 266
 267   if (res != MSG_OK)
 268     jmsg_throw_status(env, res);
 269 }
 270
 271 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_receive(JNIEnv* env, jclass cls, jstring jalias, jdouble jtimeout)
 272 {
 273   msg_task_t task = nullptr;
 274
 275   jstring_wrapper alias(env, jalias);
 276   msg_error_t rv;
 277   if (not simgrid::ForcefulKillException::try_n_catch(
 278           [&rv, &task, &alias, &jtimeout]() { rv = MSG_task_receive_with_timeout(&task, alias, (double)jtimeout); })) {
 279     jxbt_throw_by_name(env, "org/simgrid/msg/ProcessKilledError", "Process killed");
 280   }
 281   if (env->ExceptionOccurred())
 282     return nullptr;
 283   if (rv != MSG_OK) {
 284     jmsg_throw_status(env, rv);
 285     return nullptr;
 286   }
 287   auto jtask_global = (jobject)MSG_task_get_data(task);
 288
 289   /* Convert the global ref into a local ref so that the JVM can free the stuff */
 290   jobject jtask_local = env->NewLocalRef(jtask_global);
 291   env->DeleteGlobalRef(jtask_global);
 292   MSG_task_set_data(task, nullptr);
 293
 294   return (jobject) jtask_local;
 295 }
 296
 297 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_irecv(JNIEnv * env, jclass cls, jstring jmailbox) {
 298   jclass comm_class = env->FindClass("org/simgrid/msg/Comm");
 299   if (not comm_class)
 300     return nullptr;
 301
 302   //pointer to store the task object pointer.
 303   auto* task = new msg_task_t(nullptr);
 304   /* There should be a cache here */
 305
 306   jobject jcomm = env->NewObject(comm_class, jtask_method_Comm_constructor);
 307   if (not jcomm) {
 308     jxbt_throw_jni(env, "Can't create a Comm object.");
 309     return nullptr;
 310   }
 311
 312   jstring_wrapper mailbox(env, jmailbox);
 313   msg_comm_t comm     = MSG_task_irecv(task, mailbox);
 314
 315   env->SetLongField(jcomm, jtask_field_Comm_bind, (jlong) (uintptr_t)(comm));
 316   env->SetLongField(jcomm, jtask_field_Comm_taskBind, (jlong) (uintptr_t)(task));
 317   env->SetBooleanField(jcomm, jtask_field_Comm_receiving, JNI_TRUE);
 318
 319   return jcomm;
 320 }
 321
 322 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_receiveBounded(JNIEnv* env, jclass cls, jstring jalias,
 323                                                                    jdouble jtimeout, jdouble rate)
 324 {
 325   msg_task_t task = nullptr;
 326
 327   jstring_wrapper alias(env, jalias);
 328   msg_error_t res   = MSG_task_receive_with_timeout_bounded(&task, alias, jtimeout, rate);
 329   if (env->ExceptionOccurred())
 330     return nullptr;
 331   if (res != MSG_OK) {
 332     jmsg_throw_status(env, res);
 333     return nullptr;
 334   }
 335   auto jtask_global = (jobject)MSG_task_get_data(task);
 336
 337   /* Convert the global ref into a local ref so that the JVM can free the stuff */
 338   jobject jtask_local = env->NewLocalRef(jtask_global);
 339   env->DeleteGlobalRef(jtask_global);
 340   MSG_task_set_data(task, nullptr);
 341
 342   return (jobject) jtask_local;
 343 }
 344
 345 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_irecvBounded(JNIEnv * env, jclass cls, jstring jmailbox,
 346                                                                  jdouble rate)
 347 {
 348   jclass comm_class = env->FindClass("org/simgrid/msg/Comm");
 349   if (not comm_class)
 350     return nullptr;
 351
 352   // pointer to store the task object pointer.
 353   auto* task = new msg_task_t(nullptr);
 354
 355   jobject jcomm = env->NewObject(comm_class, jtask_method_Comm_constructor);
 356   if (not jcomm) {
 357     jxbt_throw_jni(env, "Can't create a Comm object.");
 358     return nullptr;
 359   }
 360
 361   jstring_wrapper mailbox(env, jmailbox);
 362   msg_comm_t comm     = MSG_task_irecv_bounded(task, mailbox, rate);
 363
 364   env->SetLongField(jcomm, jtask_field_Comm_bind, (jlong) (uintptr_t)(comm));
 365   env->SetLongField(jcomm, jtask_field_Comm_taskBind, (jlong) (uintptr_t)(task));
 366   env->SetBooleanField(jcomm, jtask_field_Comm_receiving, JNI_TRUE);
 367
 368   return jcomm;
 369 }
 370
 371 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_isend(JNIEnv *env, jobject jtask, jstring jmailbox)
 372 {
 373   msg_comm_t comm;
 374
 375   jclass comm_class = env->FindClass("org/simgrid/msg/Comm");
 376
 377   if (not comm_class)
 378     return nullptr;
 379
 380   jobject jcomm       = env->NewObject(comm_class, jtask_method_Comm_constructor);
 381   jstring_wrapper mailbox(env, jmailbox);
 382
 383   msg_task_t task = jtask_to_native(jtask, env);
 384
 385   if (not task) {
 386     env->DeleteLocalRef(jcomm);
 387     jxbt_throw_notbound(env, "task", jtask);
 388         return nullptr;
 389   }
 390
 391   MSG_task_set_data(task, env->NewGlobalRef(jtask));
 392   comm = MSG_task_isend(task,mailbox);
 393
 394   env->SetLongField(jcomm, jtask_field_Comm_bind, (jlong) (uintptr_t)(comm));
 395   env->SetLongField(jcomm, jtask_field_Comm_taskBind, (jlong) (uintptr_t)(nullptr));
 396   env->SetBooleanField(jcomm, jtask_field_Comm_receiving, JNI_FALSE);
 397
 398   return jcomm;
 399 }
 400
 401 JNIEXPORT jobject JNICALL Java_org_simgrid_msg_Task_isendBounded(JNIEnv *env, jobject jtask, jstring jmailbox,
 402                                                                  jdouble maxrate)
 403 {
 404   msg_task_t task;
 405   jobject jcomm;
 406   msg_comm_t comm;
 407
 408   jclass comm_class = env->FindClass("org/simgrid/msg/Comm");
 409   if (not comm_class)
 410     return nullptr;
 411
 412   jcomm = env->NewObject(comm_class, jtask_method_Comm_constructor);
 413   jstring_wrapper mailbox(env, jmailbox);
 414
 415   task = jtask_to_native(jtask, env);
 416
 417   if (not task) {
 418     env->DeleteLocalRef(jcomm);
 419     jxbt_throw_notbound(env, "task", jtask);
 420         return nullptr;
 421   }
 422
 423   MSG_task_set_data(task, env->NewGlobalRef(jtask));
 424   comm = MSG_task_isend_bounded(task,mailbox,maxrate);
 425
 426   env->SetLongField(jcomm, jtask_field_Comm_bind, (jlong) (uintptr_t)(comm));
 427   env->SetLongField(jcomm, jtask_field_Comm_taskBind, (jlong) (uintptr_t)(nullptr));
 428   env->SetBooleanField(jcomm, jtask_field_Comm_receiving, JNI_FALSE);
 429
 430   return jcomm;
 431 }
 432
 433 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_nativeFinalize(JNIEnv * env, jobject jtask)
 434 {
 435   msg_task_t task = jtask_to_native(jtask, env);
 436
 437   if (not task) {
 438     jxbt_throw_notbound(env, "task", jtask);
 439     return;
 440     }
 441
 442     MSG_task_destroy(task);
 443 }
 444
 445 static void msg_task_cancel_on_failed_dsend(void*t) {
 446   auto task       = (msg_task_t)t;
 447   JNIEnv* env     = get_current_thread_env();
 448   if (env) {
 449     auto jtask_global = (jobject)MSG_task_get_data(task);
 450     /* Destroy the global ref so that the JVM can free the stuff */
 451     env->DeleteGlobalRef(jtask_global);
 452     /* Don't free the C data here, to avoid a race condition with the GC also sometimes doing so.
 453      * A rare memleak is seen as preferable to a rare "free(): invalid pointer" failure that
 454      * proves really hard to debug.
 455      */
 456   }
 457   MSG_task_set_data(task, nullptr);
 458 }
 459
 460 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_dsend(JNIEnv * env, jobject jtask, jstring jalias)
 461 {
 462   jstring_wrapper alias(env, jalias);
 463
 464   msg_task_t task = jtask_to_native(jtask, env);
 465
 466   if (not task) {
 467     jxbt_throw_notbound(env, "task", jtask);
 468     return;
 469   }
 470
 471   /* Pass a global ref to the Jtask into the Ctask so that the receiver can use it */
 472   MSG_task_set_data(task, env->NewGlobalRef(jtask));
 473   MSG_task_dsend(task, alias, msg_task_cancel_on_failed_dsend);
 474 }
 475
 476 JNIEXPORT void JNICALL Java_org_simgrid_msg_Task_dsendBounded(JNIEnv * env, jobject jtask, jstring jalias,
 477                                                               jdouble maxrate)
 478 {
 479   jstring_wrapper alias(env, jalias);
 480
 481   msg_task_t task = jtask_to_native(jtask, env);
 482
 483   if (not task) {
 484     jxbt_throw_notbound(env, "task", jtask);
 485     return;
 486   }
 487
 488   /* Pass a global ref to the Jtask into the Ctask so that the receiver can use it */
 489   MSG_task_set_data(task, env->NewGlobalRef(jtask));
 490   MSG_task_dsend_bounded(task, alias, msg_task_cancel_on_failed_dsend, maxrate);
 491 }
 492
 493 JNIEXPORT jboolean JNICALL Java_org_simgrid_msg_Task_listen(JNIEnv * env, jclass cls, jstring jalias)
 494 {
 495   jstring_wrapper alias(env, jalias);
 496   return (jboolean)MSG_task_listen(alias);
 497 }
 498
 499 JNIEXPORT jint JNICALL Java_org_simgrid_msg_Task_listenFrom(JNIEnv * env, jclass cls, jstring jalias)
 500 {
 501   jstring_wrapper alias(env, jalias);
 502   return (jint)MSG_task_listen_from(alias);
 503 }