Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Merge branches 'master' and 'master' of github.com:simgrid/simgrid
[simgrid.git] / src / bindings / java / org / simgrid / msg / Task.java
index 26dc2b0..a82ce2f 100644 (file)
@@ -1,5 +1,4 @@
-/* Copyright (c) 2006-2015. The SimGrid Team.
- * All rights reserved.                                                     */
+/* Copyright (c) 2006-2016. The SimGrid Team. All rights reserved.          */
 
 /* This program is free software; you can redistribute it and/or modify it
  * under the terms of the license (GNU LGPL) which comes with this package. */
@@ -49,7 +48,14 @@ public class Task {
         *                              This value has to be ≥ 0.
         */ 
        public Task(String name, double flopsAmount, double bytesAmount) {
+               if (flopsAmount<0)
+                       throw new IllegalArgumentException("Task flopsAmount (" + flopsAmount + ") cannot be negative");
+               if (bytesAmount<0)
+                       throw new IllegalArgumentException("Task bytesAmount (" + bytesAmount + ") cannot be negative");
+                       
                create(name, flopsAmount, bytesAmount);
+               
+               this.name = name;
                this.messageSize = bytesAmount;
        }
        /**
@@ -67,7 +73,17 @@ public class Task {
         *                      the destination of the communications.
         */ 
        public Task(String name, Host[]hosts, double[]flopsAmount, double[]bytesAmount) {
+               if (flopsAmount == null)
+                       throw new IllegalArgumentException("Parallel task flops amounts is null");
+               if (bytesAmount == null)
+                       throw new IllegalArgumentException("Parallel task bytes amounts is null");
+               if (hosts == null)
+                       throw new IllegalArgumentException("Host list is null");
+               if (name == null)
+                       throw new IllegalArgumentException("Parallel task name is null");
+               
                parallelCreate(name, hosts, flopsAmount, bytesAmount);
+               this.name = name;
        }
 
        /**
@@ -85,8 +101,7 @@ public class Task {
         */
        private final native void create(String name,
                        double flopsAmount,
-                       double bytesAmount)
-                                       throws IllegalArgumentException;                
+                       double bytesAmount);
        /**
         * The natively implemented method to create a MSG parallel task.
         *
@@ -100,8 +115,7 @@ public class Task {
        private final native void parallelCreate(String name,
                        Host[]hosts,
                        double[]flopsAmount,
-                       double[]bytesAmount)
-                                       throws NullPointerException, IllegalArgumentException;
+                       double[]bytesAmount);
        /* *                   * *
         * * Getters / Setters * *
         * *                   * */
@@ -167,6 +181,7 @@ public class Task {
        public native void cancel();
 
        /** Deletes a task once the garbage collector reclaims it */
+       @Override
        protected void finalize() throws Throwable{
                nativeFinalize();
                bind=0; // to avoid segfaults if the impossible happens yet again making this task surviving its finalize()
@@ -197,7 +212,7 @@ public class Task {
         * @throws HostFailureException 
         * @throws TransferFailureException 
         */
-       public void send(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException, NativeException {
+       public void send(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
                send(mailbox, -1);
        } 
 
@@ -206,12 +221,13 @@ public class Task {
         *
         * @param mailbox where to send the message
         * @param timeout
-        * @exception  NativeException if the retrieval fails.
         * @throws TimeoutException 
         * @throws HostFailureException 
         * @throws TransferFailureException 
         */
-       public native void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException, NativeException;
+       public void send(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException {
+               sendBounded(mailbox, timeout, -1);
+       }
 
        /** Sends the task on the specified mailbox (capping the sending rate to \a maxrate) 
         *
@@ -222,7 +238,7 @@ public class Task {
         * @throws TimeoutException
         */
        public void sendBounded(String mailbox, double maxrate) throws TransferFailureException, HostFailureException, TimeoutException {
-               sendBounded(mailbox,-1,maxrate);
+               sendBounded(mailbox, -1, maxrate);
        }
 
 
@@ -255,49 +271,26 @@ public class Task {
         * @return a Comm handler
         */
        public static native Comm irecv(String mailbox);
-       /**
-        * Retrieves next task from the mailbox identified by the specified name
-        *
-        * @param mailbox
-        * @return a Task
-        */
-
-       public static Task receive(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
-               return receive(mailbox, -1.0, null);
-       }
-
-       /**
-        * Retrieves next task on the mailbox identified by the specified name (wait at most \a timeout seconds)
-        *
-        * @param mailbox
-        * @param timeout
-        * @return a Task
-        */
-       public static Task receive(String mailbox, double timeout) throws  TransferFailureException, HostFailureException, TimeoutException {
-               return receive(mailbox, timeout, null);
-       }
 
        /**
-        * Retrieves next task sent by a given host on the mailbox identified by the specified alias 
+        * Retrieves next task on the mailbox identified by the specified alias 
         *
         * @param mailbox
-        * @param host
         * @return a Task
         */
 
-       public static Task receive(String mailbox, Host host) throws TransferFailureException, HostFailureException, TimeoutException {
-               return receive(mailbox, -1.0, host);
+       public static Task receive(String mailbox) throws TransferFailureException, HostFailureException, TimeoutException {
+               return receive(mailbox, -1.0);
        }
 
        /**
-        * Retrieves next task sent by a given host on the mailbox identified by the specified alias (wait at most \a timeout seconds)
+        * Retrieves next task on the mailbox identified by the specified alias (wait at most \a timeout seconds)
         *
         * @param mailbox
         * @param timeout 
-        * @param host
         * @return a Task
         */
-       public static native Task receive(String mailbox, double timeout, Host host) throws TransferFailureException, HostFailureException, TimeoutException;
+       public static native Task receive(String mailbox, double timeout) throws TransferFailureException, HostFailureException, TimeoutException;
 
        /**
         * Starts listening for receiving a task from an asynchronous communication with a capped rate
@@ -313,7 +306,7 @@ public class Task {
         */
 
        public static Task receiveBounded(String mailbox, double rate) throws TransferFailureException, HostFailureException, TimeoutException {
-               return receiveBounded(mailbox, -1.0, null, rate);
+               return receiveBounded(mailbox, -1.0, rate);
        }
 
        /**
@@ -323,32 +316,7 @@ public class Task {
         * @param timeout
         * @return a Task
         */
-       public static Task receiveBounded(String mailbox, double timeout, double rate) throws  TransferFailureException, HostFailureException, TimeoutException {
-               return receiveBounded(mailbox, timeout, null, rate);
-       }
-
-       /**
-        * Retrieves next task sent by a given host on the mailbox identified by the specified alias with a capped rate
-        *
-        * @param mailbox
-        * @param host
-        * @return a Task
-        */
-
-       public static Task receiveBounded(String mailbox, Host host, double rate) throws TransferFailureException, HostFailureException, TimeoutException {
-               return receiveBounded(mailbox, -1.0, host, rate);
-       }
-
-       /**
-        * Retrieves next task sent by a given host on the mailbox identified by the specified alias (wait at most \a timeout seconds)
-        * with a capped rate
-        *
-        * @param mailbox
-        * @param timeout 
-        * @param host
-        * @return a Task
-        */
-       public static native Task receiveBounded(String mailbox, double timeout, Host host, double rate) throws TransferFailureException, HostFailureException, TimeoutException;
+       public static native Task receiveBounded(String mailbox, double timeout, double rate) throws TransferFailureException, HostFailureException, TimeoutException;