abs.api.DispatchInbox Maven / Gradle / Ivy

package abs.api;

import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Future;

/**
 * A dispatch inbox maintains an in-memory mapping of separate inboxes
 * for each recipient. It delegates posting of an envelope to the proper
 * inbox and creates them on-the-fly.
 *
 * @author Behrooz Nobakht
 * @since 1.0
 */
public class DispatchInbox extends AbstractInbox {

	private final ConcurrentMap inboxes;
	private final ExecutorService executor;

	/**
	 * 
	 * Constructor for DispatchInbox.
	 * 
	 *
	 * @param executor
	 *            a {@link java.util.concurrent.ExecutorService} object.
	 */
	public DispatchInbox(ExecutorService executor) {
		this.executor = executor;
		this.inboxes = new ConcurrentHashMap<>(8192);
	}

	@Override
	public  Future post(Envelope envelope, Object receiver) {
		Inbox inbox = getInbox(envelope.to());
		inbox.post(envelope, receiver);
		return envelope.response();
	}

	/**
	 * 
	 * getInbox.
	 * 
	 *
	 * @param owner
	 *            a {@link abs.api.Reference} object.
	 * @return a {@link abs.api.Inbox} object.
	 */
	protected Inbox getInbox(Reference owner) {
		Inbox inbox = inboxes.get(owner);
		if (inbox != null) {
			return inbox;
		}
		inbox = new QueueInbox(getExecutor());
		inbox.bind(context);
		inboxes.put(owner, inbox);
		return inbox;
	}

	/**
	 * 
	 * Getter for the field executor.
	 * 
	 *
	 * @return a {@link java.util.concurrent.ExecutorService} object.
	 */
	protected ExecutorService getExecutor() {
		return executor;
	}

}