Overview - Common API - Client API - Admin API - Runtime API
ParticipantRegistry
The ParticipantRegistry is used to manage a set of participants stored on the blockchain.
Do not attempt to create an instance of this class. You must use the getParticipantRegistry method instead.
Details
- Module runtime
Method Summary
| Name | Returns | Description |
|---|---|---|
| add | Promise |
Add the specified participant to this participant registry |
| addAll | Promise |
Add all of the specified participants to this participant registry |
| exists | Promise |
Determines whether a specific participant exists in this participant registry |
| get | Promise |
Get the specified participant in this participant registry using the unique identifier of the participant |
| getAll | Promise |
Get a list of all of the existing participants in this participant registry |
| remove | Promise |
Remove the specified participant from this participant registry |
| removeAll | Promise |
Remove all of the specified participants from this participant registry |
| update | Promise |
Update the specified participant in this participant registry |
| updateAll | Promise |
Update all of the specified participants in this participant registry |
Method Details
getAll
Promise getAll( )
Get a list of all of the existing participants in this participant registry.
Returns
Promise - A promise. The promise is resolved with an array of Resource instances representing all of the participants stored in this participant registry. If the participant registry does not exist, or the current user does not have access to the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
No parameters
Example
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get all of the drivers in the driver participant registry.
return participantRegistry.getAll();
})
.then(function (drivers) {
// Process the array of driver objects.
drivers.forEach(function (driver) {
console.log(driver.driverId);
});
})
.catch(function (error) {
// Add optional error handling here.
});
get
Promise get( string id )
Get the specified participant in this participant registry using the unique identifier of the participant.
Returns
Promise - A promise. The promise is resolved with a Resource instance representing the specified participant in this participant registry. If the specified participant does not exist, or the current user does not have access to the specified participant, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| id | string | Yes | The ID of the participant. |
Example
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the specific driver from the driver participant registry.
return participantRegistry.get('VEHICLE_1');
})
.then(function (driver) {
// Process the the driver object.
console.log(driver.driverId);
})
.catch(function (error) {
// Add optional error handling here.
});
exists
Promise exists( string id )
Determines whether a specific participant exists in this participant registry.
Returns
Promise - A promise. The promise is resolved with a boolean which is true if the specified participant exists in this participant registry, and false if the specified participant does not exist.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| id | string | Yes | The ID of the participant. |
Example
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Determine if the specific driver exists in the driver participant registry.
return participantRegistry.exists('VEHICLE_1');
})
.then(function (exists) {
// Process the the boolean result.
console.log('Driver exists', exists);
})
.catch(function (error) {
// Add optional error handling here.
});
addAll
Promise addAll( participants )
Add all of the specified participants to this participant registry.
Returns
Promise - A promise. The promise is resolved when all of the participants have been added to this participant registry. If the participants cannot be added to this participant registry, or if the participants already exist in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participants | Yes | The participants to add to this participant registry. |
Example
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Create the first driver.
var driver1 = factory.newResource('org.example', 'Driver', 'VEHICLE_1');
driver1.location = 'Southampton';
// Create the second driver.
var driver2 = factory.newResource('org.example', 'Driver', 'VEHICLE_2');
driver2.location = 'GREEN';
// Add the drivers to the driver participant registry.
return participantRegistry.addAll([driver1, driver2]);
})
.catch(function (error) {
// Add optional error handling here.
});
add
Promise add( Resource participant )
Add the specified participant to this participant registry.
Returns
Promise - A promise. The promise is resolved when the participant has been added to this participant registry. If the participant cannot be added to this participant registry, or if the participant already exists in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participant | Resource | Yes | The participants to add to this participant registry. |
Example
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Create the driver.
var driver = factory.newResource('org.example', 'Driver', 'VEHICLE_1');
driver.location = 'Southampton';
// Add the driver to the driver participant registry.
return participantRegistry.add(driver);
})
.catch(function (error) {
// Add optional error handling here.
});
updateAll
Promise updateAll( participants )
Update all of the specified participants in this participant registry.
Returns
Promise - A promise. The promise is resolved when all of the participants have been updated in this participant registry. If the participants cannot be updated in this participant registry, or if the participants do not exist in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participants | Yes | The participants to update in this participant registry. |
Example
// The existing drivers that have come from elsewhere.
var driver1;
var driver2;
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Modify the properties of the first driver.
driver1.location = 'Hursley';
// Modify the properties of the second driver.
driver2.location = 'London';
// Update the drivers in the driver participant registry.
return participantRegistry.updateAll([driver1, driver2]);
})
.catch(function (error) {
// Add optional error handling here.
});
update
Promise update( Resource participant )
Update the specified participant in this participant registry.
Returns
Promise - A promise. The promise is resolved when the participant have been updated in this participant registry. If the participant cannot be updated in this participant registry, or if the participant does not exist in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participant | Resource | Yes | The participant to update in this participant registry. |
Example
// The existing driver that has come from elsewhere.
var driver;
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Modify the properties of the driver.
driver.location = 'Hursley';
// Update the driver in the driver participant registry.
return participantRegistry.update(driver);
})
.catch(function (error) {
// Add optional error handling here.
});
removeAll
Promise removeAll( string[]; Resource[] participants )
Remove all of the specified participants from this participant registry.
Returns
Promise - A promise. The promise is resolved when all of the participants have been removed from this participant registry. If the participants cannot be removed from this participant registry, or if the participants do not exist in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participants | string[]; Resource[] | Yes | The participants, or the IDs of the participants, to remove from this participant registry. |
Example
// The existing drivers that have come from elsewhere.
var driver1;
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Remove the drivers from the driver participant registry. Note that
// one driver is specified as a driver instance, and the other
// driver is specified by the ID of the driver.
return participantRegistry.removeAll([driver1, 'VEHICLE_2']);
})
.catch(function (error) {
// Add optional error handling here.
});
remove
Promise remove( string; Resource participant )
Remove the specified participant from this participant registry.
Returns
Promise - A promise. The promise is resolved when the participant has been removed from this participant registry. If the participant cannot be removed from this participant registry, or if the participant does not exist in the participant registry, then the promise will be rejected with an error that describes the problem.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| participant | string; Resource | Yes | The participant, or ID of the participant, to remove from this participant registry. |
Example
// The existing driver that has come from elsewhere.
var driver;
// Get the driver participant registry.
return getParticipantRegistry('org.example.Driver')
.then(function (participantRegistry) {
// Get the factory for creating new participant instances.
var factory = getFactory();
// Remove the driver from the driver participant registry.
return participantRegistry.remove(driver);
})
.catch(function (error) {
// Add optional error handling here.
});