net.corda.core.node.services

Interface NetworkMapCache

All Superinterfaces:

NetworkMapCacheBase

public NetworkMapCache
extends NetworkMapCacheBase

A network map contains lists of nodes on the network along with information about their identity keys, services they provide and host names or IP addresses where they can be connected to. The cache wraps around a map fetched from an authoritative service, and adds easy lookup of the data stored within it. Generally it would be initialised with a specified network map service, which it fetches data from and then subscribes to updates of.

Constructor Detail

NetworkMapCache

public NetworkMapCache()

Method Detail

getNodeByLegalIdentity

@Nullable
NodeInfo getNodeByLegalIdentity(@NotNull
                                          AbstractParty party)

Look up the node info for a specific party. Will attempt to de-anonymise the party if applicable; if the party is anonymised and the well known party cannot be resolved, it is impossible ot identify the node and therefore this returns null. Notice that when there are more than one node for a given party (in case of distributed services) first service node found will be returned. See also: NetworkMapCache.getNodesByLegalIdentityKey.

Parameters:

party - party to retrieve node information for.

Returns:

the node for the identity, or null if the node could not be found. This does not necessarily mean there is no node for the party, only that this cache is unaware of it.

See Also:

NetworkMapCache.getNodesByLegalIdentityKey