Package com.jgalgo.adapt.guava

Class GuavaGraphAdapter<V,​E>

  • Type Parameters:
    V - the vertices type
    E - the edges type
    All Implemented Interfaces:
    Graph<V>, PredecessorsFunction<V>, SuccessorsFunction<V>
    Direct Known Subclasses:
    GuavaMutableGraphAdapter
    public class GuavaGraphAdapter<V,​E>
extends AbstractGraph<V>
    An adapter from a JGAlgo graph to a Guava graph.

    The adapter is constructed with a JGAlgo graph and implements the Guava graph interface, and can be used with any Guava algorithm. The adapter is a live view, so any change in the JGAlgo graph is reflected in the Guava graph and vice versa, but the underlying JGAlgo graph should not be modified directly.

    The basic Guava graph is immutable, so as this adapter. A subclass of this adapter, GuavaMutableGraphAdapter, is a mutable adapter that implements the Guava mutable graph interface.

    Parallel edges are not supported by Guava basic graph, therefore the adapter will throw an UnsupportedOperationException if the underlying JGAlgo graph allows parallel edges. Whether this graph is directed or not, and whether it support self edges or not, is determined by the underlying JGAlgo graph.

    Guava support different element orders for the nodes and the incident edges. This adapter uses the default element order, which is unordered, and cannot be changed as the underlying JGAlgo graph does not support any other order.

    The basic Guava graph only represent connections between nodes, without addressing the edges themselves. The edge generic type E is not reflected in the Guava graph, and is only internally for safe access to the underlying JGAlgo graph.

    Among Guava Graph, ValueGraph and Network, the network is the most similar to JGAlgo graphs, as vertices and edges have unique identifiers, and queries of edges are answered with the edges identifiers. On the other had, the Graph and ValueGraph do not support unique identifiers for the edges, and operations on edges are addressed by a pair of nodes. The ValueGraph does associate a value with each edge, be it does not have to be unique, and it is more similar to weights in JGAlgo graphs.

    For adapting the other way around, from Guava to JGAlgo, only from Guava Network is supported, see GuavaNetworkWrapper.

    Author:
    Barak Ugav
    See Also:
    Graph, Graph, GuavaMutableGraphAdapter

    • Constructor Detail

      • GuavaGraphAdapter

        public GuavaGraphAdapter​(Graph<V,​E> graph)
        Constructs a new adapter from the given JGAlgo graph.
        Parameters:
        graph - the JGAlgo graph
        Throws:
        UnsupportedOperationException - if the graph allows parallel edges