1 /* Functions related to the java task instances. */
3 /* Copyright (c) 2007, 2009, 2010. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
16 * This function returns a global reference to the java task instance
17 * specified by the parameter jtask.
19 * @param jtask The original java task instance.
20 * @param env The environment of the current thread.
22 * @return The global reference to the original java task
25 jobject jtask_new_global_ref(jobject jtask, JNIEnv * env);
28 * This function delete a global reference to a java task instance.
30 * @param The global refernce to delete.
31 * @param env The environment of the current thread.
33 void jtask_delete_global_ref(jobject jtask, JNIEnv * env);
36 * This function associated a native task to a java task instance.
38 * @param jtask The java task instance.
39 * @param task The native task to bind.
40 * @param env The environment of the current thread.
42 * @exception If the class Task is not found the function throws
43 * the ClassNotFoundException. If the field bind of
44 * this class is not found the function throws the exception
45 * NotSuchFieldException.
47 void jtask_bind(jobject jtask, m_task_t task, JNIEnv * env);
50 * This function returns a native task from a java task instance.
52 * @param jtask The java task object from which get the native task.
53 * @param env The environment of the current thread.
55 * @return The function returns the native task associated to the
58 * @exception If the class Task is not found the function throws
59 * the ClassNotFoundException. If the field bind of
60 * this class is not found the function throws the exception
61 * NotSuchFieldException.
63 m_task_t jtask_to_native_task(jobject jtask, JNIEnv * env);
66 * This function tests if a java task instance is valid.
67 * A java task object is valid if it is bind to a native
70 * @param jtask The java task to test the validity.
71 * @param env The environment of the current thread.
73 * @return If the java task is valid the function returns true.
74 * Otherwise the function returns false.
76 jboolean jtask_is_valid(jobject jtask, JNIEnv * env);
78 #endif /* !MSG_JTASK_H */