io.jsync.spi.cluster.AsyncMultiMap Maven / Gradle / Ivy
Show all versions of jsync.io Show documentation
/*
* Copyright (c) 2011-2013 The original author or authors
* ------------------------------------------------------
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Apache License v2.0 which accompanies this distribution.
*
* The Eclipse Public License is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* The Apache License v2.0 is available at
* http://www.opensource.org/licenses/apache2.0.php
*
* You may elect to redistribute this code under either of these licenses.
*/
package io.jsync.spi.cluster;
import io.jsync.AsyncResult;
import io.jsync.Handler;
/**
* An asynchronous multi-map.
*
* A multi-map holds a List of values against each key as opposed to a single value, as with a Map.
*
* The cluster implementation should ensure that any entries placed in the map from any node are available on any
* node of the cluster.
*
* @author Tim Fox
*/
public interface AsyncMultiMap {
/**
* Add a value to the list of values for that key in the map
*
* @param k The key
* @param v The value
* @param completionHandler This will be called when the entry has been added
*/
void add(K k, V v, Handler> completionHandler);
/**
* Get a list of values from the map for the key
*
* @param k The key
* @param resultHandler This will be called with the list of values for the key. The type of the values returned
* must be {@link ChoosableIterable}
*/
void get(K k, Handler>> resultHandler);
/**
* Remove a value from the list of values for that key in the map.
*
* @param k The key
* @param v The value
* @param completionHandler This will be called when the remove is complete
*/
void remove(K k, V v, Handler> completionHandler);
/**
* Remove all the specified values from all keys in the map
*
* @param v The value
* @param completionHandler This will be called when the remove is complete
*/
void removeAllForValue(V v, Handler> completionHandler);
}