RequestClient.java

/* This code is part of Freenet. It is distributed under the GNU General
 * Public License, version 2 (or at your option any later version). See
 * http://www.gnu.org/ for further details of the GPL. */
package freenet.node;

/**
 * Must be implemented by any client object returned by SendableRequest.getClient().
 * Mostly this is for scheduling, but it does have one key purpose: to identify whether
 * a request is persistent or not.
 *
 * Use a {@link RequestClientBuilder} to conveniently build {@code RequestClient}s.
 *
 * @author toad
 */
public interface RequestClient {
	
	/**
	 * Is this request persistent? **Must not change!**
	 */
	public boolean persistent();
	
	/** Send the request with the real time flag enabled? Real-time requests are given 
	 * a higher priority in data transfers, but fewer of them are accepted. They are 
	 * optimised for latency rather than throughput, and are expected to be bursty rather
	 * than continual.
	 * **Must not change!**
	 */
	public boolean realTimeFlag();

}