/** * Runs the given task if Engine has a capacity to start new plan as specified by * {@value #MAX_CONCURRENT_PLANS} configuration parameter. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * This method returns immediately and does not block. It returns {@code true} if Plan was successfully started. * @param task the task to run * @param planClass string that identifies a "class" of the Plan * @return true if Plan was started */ public boolean tryRun(final Task<?> task, final String planClass) { if (tryAcquirePermit(planClass)) { runWithPermit(task, planClass); return true; } else { return false; } }
/** * Runs the given task. Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * <p> * This method blocks until Engine has a capacity to run the task. Engine's capacity is * specified by a {@value #MAX_CONCURRENT_PLANS} configuration property. Use * {@link EngineBuilder#setEngineProperty(String, Object)} to set this property. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * * @param task the task to run * @param planClass string that identifies a "class" of the Plan. Plan class ends up in a ParSeq * Trace and can be used to group traces into "classes" when traces are statistically analyzed. */ public void blockingRun(final Task<?> task, final String planClass) { try { acquirePermit(planClass); runWithPermit(task, planClass); } catch (InterruptedException e) { Thread.currentThread().interrupt(); } }
/** * Runs the given task if Engine has a capacity to start new plan as specified by * {@value #MAX_CONCURRENT_PLANS} configuration parameter within specified amount of time. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * If Engine does not have capacity to start the task, this method will block up to specified amount of * time waiting for other concurrently running Plans to complete. If there is no capacity to start the task * within specified amount of time this method will return false. It returns {@code true} if Plan was successfully started. * @param task the task to run * @param planClass string that identifies a "class" of the Plan * @param timeout amount of time to wait for Engine's capacity to run the task * @param unit * @return true if Plan was started within the given waiting time and the current thread has not * been {@linkplain Thread#interrupt interrupted}. */ public boolean tryRun(final Task<?> task, final String planClass, final long timeout, final TimeUnit unit) throws InterruptedException { if (tryAcquirePermit(planClass, timeout, unit)) { runWithPermit(task, planClass); return true; } else { return false; } }
/** * Runs the given task if Engine has a capacity to start new plan as specified by * {@value #MAX_CONCURRENT_PLANS} configuration parameter. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * This method returns immediately and does not block. It returns {@code true} if Plan was successfully started. * @param task the task to run * @param planClass string that identifies a "class" of the Plan * @return true if Plan was started */ public boolean tryRun(final Task<?> task, final String planClass) { if (tryAcquirePermit(planClass)) { runWithPermit(task, planClass); return true; } else { return false; } }
/** * Runs the given task. Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * <p> * This method blocks until Engine has a capacity to run the task. Engine's capacity is * specified by a {@value #MAX_CONCURRENT_PLANS} configuration property. Use * {@link EngineBuilder#setEngineProperty(String, Object)} to set this property. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * * @param task the task to run * @param planClass string that identifies a "class" of the Plan. Plan class ends up in a ParSeq * Trace and can be used to group traces into "classes" when traces are statistically analyzed. */ public void blockingRun(final Task<?> task, final String planClass) { try { acquirePermit(planClass); runWithPermit(task, planClass); } catch (InterruptedException e) { Thread.currentThread().interrupt(); } }
/** * Runs the given task if Engine has a capacity to start new plan as specified by * {@value #MAX_CONCURRENT_PLANS} configuration parameter within specified amount of time. * For the sake of backwards compatibility default value for a {@value #MAX_CONCURRENT_PLANS} is * {@value #DEFUALT_MAX_CONCURRENT_PLANS} which essentially means "unbounded capacity". * Task passed in as a parameter becomes a root on a new Plan. * All tasks created and started as a consequence of a root task will belong to that plan and will share a Trace. * If Engine does not have capacity to start the task, this method will block up to specified amount of * time waiting for other concurrently running Plans to complete. If there is no capacity to start the task * within specified amount of time this method will return false. It returns {@code true} if Plan was successfully started. * @param task the task to run * @param planClass string that identifies a "class" of the Plan * @param timeout amount of time to wait for Engine's capacity to run the task * @param unit * @return true if Plan was started within the given waiting time and the current thread has not * been {@linkplain Thread#interrupt interrupted}. */ public boolean tryRun(final Task<?> task, final String planClass, final long timeout, final TimeUnit unit) throws InterruptedException { if (tryAcquirePermit(planClass, timeout, unit)) { runWithPermit(task, planClass); return true; } else { return false; } }