org.elastos.hive

Class ServiceEndpoint

java.lang.Object

org.elastos.hive.connection.NodeRPCConnection

org.elastos.hive.ServiceEndpoint

Direct Known Subclasses:

Backup, BackupSubscription, ScriptRunner, Vault, VaultSubscription

public class ServiceEndpoint
extends NodeRPCConnection

The service end-point represents the service provides some API functions. It supports:

• Access token management.
• Local cache for the access token.
• The service DID of the hive node.
• The provider address.

The service end-point is just like the map of the hive node. The application can communicate with the hive node APIs by its sub-class.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServiceEndpoint(AppContext context, java.lang.String providerAddress) Create by the application context, and the address of the provider.

Method Summary

Modifier and Type	Method and Description
protected AccessToken	getAccessToken()
AppContext	getAppContext() Get the application context.
java.lang.String	getAppDid() Get the application DID in the current calling context.
java.lang.String	getAppInstanceDid() Get the application instance DID in the current calling context;
java.util.concurrent.CompletableFuture<java.lang.String>	getLatestCommitId() Get the last commit ID of the hive node.
java.util.concurrent.CompletableFuture<NodeVersion>	getNodeVersion() Get the version of the hive node.
java.lang.String	getProviderAddress() Get the end-point address of this service End-point.
java.lang.String	getServiceDid() Get the remote node service application DID.
java.lang.String	getServiceInstanceDid() Get the remote node service instance DID where is serving the storage service.
DataStorage	getStorage() Get the instance of the data storage.
java.lang.String	getUserDid() Get the user DID string of this serviceEndpoint.
void	refreshAccessToken() Refresh the access token.

Methods inherited from class org.elastos.hive.connection.NodeRPCConnection

createService, openConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceEndpoint

protected ServiceEndpoint(AppContext context,
                          java.lang.String providerAddress)

Create by the application context, and the address of the provider.

Parameters:

context - The application context.

providerAddress - The address of the provider.

Method Detail

getAppContext

public AppContext getAppContext()

Get the application context.

Returns:

The application context.

getProviderAddress

public java.lang.String getProviderAddress()

Get the end-point address of this service End-point.

Specified by:

getProviderAddress in class NodeRPCConnection

Returns:

provider address

getUserDid

public java.lang.String getUserDid()

Get the user DID string of this serviceEndpoint.

Returns:

user did

getAppDid

public java.lang.String getAppDid()

Get the application DID in the current calling context.

Returns:

application did

getAppInstanceDid

public java.lang.String getAppInstanceDid()

Get the application instance DID in the current calling context;

Returns:

application instance did

getServiceDid

public java.lang.String getServiceDid()

Get the remote node service application DID.

Returns:

node service did

getServiceInstanceDid

public java.lang.String getServiceInstanceDid()

Get the remote node service instance DID where is serving the storage service.

Returns:

node service instance did

getStorage

public DataStorage getStorage()

Get the instance of the data storage.

Returns:

The instance of the data storage.

refreshAccessToken

public void refreshAccessToken()
                        throws NodeRPCException

Refresh the access token. This will do remote refresh if not exist.

Throws:

NodeRPCException - See NodeRPCException

getAccessToken

protected AccessToken getAccessToken()

Specified by:

getAccessToken in class NodeRPCConnection

getNodeVersion

public java.util.concurrent.CompletableFuture<NodeVersion> getNodeVersion()

Get the version of the hive node.

Returns:

The version of the hive node.

getLatestCommitId

public java.util.concurrent.CompletableFuture<java.lang.String> getLatestCommitId()

Get the last commit ID of the hive node.

Returns:

The last commit ID.