Discovering cloud names

Starting with XDI2 version 0.8-SNAPSHOT commit 5ce8fad, the same discovery functionality used to discover cloud numbers, endpoint URIs, and public keys, can also be used to discover one or more cloud names for a given cloud number.

See Performing XDI discovery for details and an example how to use the general XDI discovery process.

Interfaces and Classes

• xdi2.discovery.XDIDiscoveryClient
• xdi2.discovery.XDIDiscoveryResult

Graph structure

In order to be able to discover cloud names, the requirements are that 1. the list of cloud names is available at either an XDI discovery service or at the XDI authority's graph, and that 2. public link contracts are set up to allow public access to the list of cloud names. This is usually accomplished when new graphs are provisioned using the BootstrapInterceptor.

The typical structure in an XDI authority's graph that enables discovery of cloud names is as follows:

=!:uuid:1111/$is$ref/=alice
=!:uuid:1111/$is$ref/=alice.example
(=!:uuid:1111/$public)($do/$get)=!:uuid:1111/$is$ref/{}

Manual process

When using an older version of XDI2 that doesn't have built-in support for discovering cloud names, the standard XDI messaging APIs can be used.

For an example, see:

• https://github.com/projectdanube/xdi2-example-client/blob/master/src/main/java/xdi2/example/client/CloudNameDiscovery.java