Package com.google.common.graph

Class ImmutableNetwork.Builder<N,E>

java.lang.Object

com.google.common.graph.ImmutableNetwork.Builder<N,E>

Enclosing class:

ImmutableNetwork<N,E>

public static class ImmutableNetwork.Builder<N,E>
extends java.lang.Object

A builder for creating ImmutableNetwork instances, especially static final networks. Example:

 static final ImmutableNetwork<City, Train> TRAIN_NETWORK =
     NetworkBuilder.undirected()
         .allowsParallelEdges(true)
         .<City, Train>immutable()
         .addEdge(PARIS, BRUSSELS, Thalys.trainNumber("1111"))
         .addEdge(PARIS, BRUSSELS, RegionalTrain.trainNumber("2222"))
         .addEdge(LONDON, PARIS, Eurostar.trainNumber("3333"))
         .addEdge(LONDON, BRUSSELS, Eurostar.trainNumber("4444"))
         .addNode(REYKJAVIK)
         .build();
 

Builder instances can be reused; it is safe to call build() multiple times to build multiple networks in series. Each new network contains all the elements of the ones created before it.

Since:

28.0

Field Summary

Fields

Modifier and Type	Field	Description
private MutableNetwork<N,E>	mutableNetwork

Constructor Summary

Constructors

Constructor	Description
Builder(NetworkBuilder<N,E> networkBuilder)

Method Summary

Modifier and Type	Method	Description
ImmutableNetwork.Builder<N,E>	addEdge(EndpointPair<N> endpoints, E edge)	Adds edge connecting endpoints.
ImmutableNetwork.Builder<N,E>	addEdge(N nodeU, N nodeV, E edge)	Adds edge connecting nodeU to nodeV.
ImmutableNetwork.Builder<N,E>	addNode(N node)	Adds node if it is not already present.
ImmutableNetwork<N,E>	build()	Returns a newly-created ImmutableNetwork based on the contents of this Builder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mutableNetwork

private final MutableNetwork<N,E> mutableNetwork

Constructor Detail

Builder

Builder(NetworkBuilder<N,E> networkBuilder)

Method Detail

addNode

public ImmutableNetwork.Builder<N,E> addNode(N node)

Adds node if it is not already present.

Nodes must be unique, just as Map keys must be. They must also be non-null.

Returns:

this Builder object

addEdge

public ImmutableNetwork.Builder<N,E> addEdge(N nodeU,
                                                   N nodeV,
                                                   E edge)

Adds edge connecting nodeU to nodeV.

If the network is directed, edge will be directed in this network; otherwise, it will be undirected.

edge must be unique to this network, just as a Map key must be. It must also be non-null.

If nodeU and nodeV are not already present in this network, this method will silently add nodeU and nodeV to the network.

If edge already connects nodeU to nodeV (in the specified order if this network ConfigurableNetwork.isDirected(), else in any order), then this method will have no effect.

Returns:

this Builder object

Throws:

java.lang.IllegalArgumentException - if edge already exists in the network and does not connect nodeU to nodeV

java.lang.IllegalArgumentException - if the introduction of the edge would violate ConfigurableNetwork.allowsParallelEdges() or ConfigurableNetwork.allowsSelfLoops()

addEdge

public ImmutableNetwork.Builder<N,E> addEdge(EndpointPair<N> endpoints,
                                                   E edge)

Adds edge connecting endpoints. In an undirected network, edge will also connect nodeV to nodeU.

If this network is directed, edge will be directed in this network; if it is undirected, edge will be undirected in this network.

If this network is directed, endpoints must be ordered.

edge must be unique to this network, just as a Map key must be. It must also be non-null.

If either or both endpoints are not already present in this network, this method will silently add each missing endpoint to the network.

If edge already connects an endpoint pair equal to endpoints, then this method will have no effect.

Returns:

this Builder object

Throws:

java.lang.IllegalArgumentException - if edge already exists in the network and connects some other endpoint pair that is not equal to endpoints

java.lang.IllegalArgumentException - if the introduction of the edge would violate ConfigurableNetwork.allowsParallelEdges() or ConfigurableNetwork.allowsSelfLoops()

java.lang.IllegalArgumentException - if the endpoints are unordered and the network is directed

build

public ImmutableNetwork<N,E> build()

Returns a newly-created ImmutableNetwork based on the contents of this Builder.