124 lines
2.4 KiB
Java
124 lines
2.4 KiB
Java
package org.warp.commonutils.type;
|
|
|
|
import it.unimi.dsi.fastutil.objects.ObjectSet;
|
|
import java.util.Set;
|
|
|
|
/**
|
|
* One to many relationship
|
|
*
|
|
* o ------- o
|
|
* +--- o
|
|
* o ---+--- o
|
|
* +-|- o
|
|
* o -----|- o
|
|
* o ------- o
|
|
* o ---+--- o
|
|
* +--- o
|
|
*
|
|
* @param <T> Source type
|
|
* @param <U> Destination type
|
|
*/
|
|
public interface MultiAssociation<T, U> {
|
|
|
|
/**
|
|
* Link source to dest
|
|
* @param src Source
|
|
* @param dest Destination
|
|
* @return true if linked, false if it was already linked with that destination
|
|
*/
|
|
boolean link(T src, U dest);
|
|
|
|
/**
|
|
* Unlink only if src is linked with dest
|
|
* @param src Source
|
|
* @param dest Destination
|
|
* @return true if unlinked, false if not present
|
|
*/
|
|
boolean unlink(T src, U dest);
|
|
|
|
/**
|
|
* Unlink
|
|
* @param src Source
|
|
* @return previous linked destinations
|
|
*/
|
|
Set<U> unlink(T src);
|
|
|
|
/**
|
|
* Unlink
|
|
* @param dest Destination
|
|
* @return previous linked source
|
|
*/
|
|
Set<T> unlinkFromSource(U dest);
|
|
|
|
/**
|
|
* Check if link exists
|
|
* @param src Source
|
|
* @return true if source is linked with at least 1 destination
|
|
*/
|
|
default boolean hasAnyLink(T src) {
|
|
return !getLinks(src).isEmpty();
|
|
}
|
|
|
|
/**
|
|
* Check if link exists
|
|
* @param dest Destination
|
|
* @return true if destination is linked with at least 1 destination
|
|
*/
|
|
default boolean hasAnyLinkSource(U dest) {
|
|
return !getLinkSources(dest).isEmpty();
|
|
}
|
|
|
|
/**
|
|
* Check if link exists
|
|
* @param src Source
|
|
* @param dest Destination
|
|
* @return true if source and destination are linked together
|
|
*/
|
|
boolean hasLink(T src, U dest);
|
|
|
|
/**
|
|
* Get a link destination
|
|
* @param src Source
|
|
* @return Existing linked destinations
|
|
*/
|
|
Set<U> getLinks(T src);
|
|
|
|
/**
|
|
* Get a link source
|
|
* @param dest Source
|
|
* @return Existing linked sources
|
|
*/
|
|
Set<T> getLinkSources(U dest);
|
|
|
|
/**
|
|
* Delete all links
|
|
*/
|
|
void clear();
|
|
|
|
/**
|
|
* Get the count of existing links
|
|
* @return size
|
|
*/
|
|
int size();
|
|
|
|
/**
|
|
* Get all the sources
|
|
* @return Set of sources
|
|
*/
|
|
ObjectSet<T> getSources();
|
|
|
|
/**
|
|
* Get all the destinations
|
|
* @return Set of destinations
|
|
*/
|
|
ObjectSet<U> getDestinations();
|
|
|
|
static <T, U> MultiAssociation<T, U> synchronize(MultiAssociation<T, U> association) {
|
|
return new SynchronizedMultiAssociation<>(association);
|
|
}
|
|
|
|
static <T, U> MultiAssociation<T, U> synchronize(MultiAssociation<T, U> association, Object lock) {
|
|
return new SynchronizedMultiAssociation<>(association, lock);
|
|
}
|
|
}
|