• Home
• se.l4.vibe
• vibe-api
• 0.2.1
• source code
• TriggerBuilder.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

se.l4.vibe.builder.TriggerBuilder Maven / Gradle / Ivy

package se.l4.vibe.builder;

import java.util.concurrent.TimeUnit;

import se.l4.vibe.event.EventSeverity;
import se.l4.vibe.trigger.TriggerListener;

/**
 * Builder for triggers.
 * 
 * @author Andreas Holstenson
 *
 * @param 
 */
public interface TriggerBuilder
{
	/**
	 * Set that the trigger should also handle the case where the condition
	 * is no longer met.
	 * 
	 * @return
	 */
	TriggerBuilder andWhenNoLongerMet();
	
	/**
	 * Set that the trigger should only trigger once until it is no longer
	 * met. This equivalent of calling {@link #atMostEvery(long, TimeUnit)}
	 * with a high value.
	 * 
	 * @return
	 */
	TriggerBuilder onlyOnce();
	
	/**
	 * Limit the number of times the event is triggered. This time is
	 * normally fetched from the used trigger, but sometimes it may be
	 * desirable to override this with a custom value.
	 * 
	 * @param duration
	 * @param unit
	 * @return
	 */
	TriggerBuilder atMostEvery(long duration, TimeUnit unit);
	
	/**
	 * Indicate that an event should be sent.
	 * 
	 * @param severity
	 * @return
	 */
	B sendEvent(EventSeverity severity);
	
	/**
	 * Handle the trigger with the specified listener.
	 * 
	 * @param listener
	 * @return
	 */
	B handleWith(TriggerListener listener);
}