com.bigdata.service
Interface IService

All Superinterfaces:

Remote

All Known Subinterfaces:

IClientService, IDataService, ILoadBalancerService, IMetadataService, ITimestampService, ITransactionService

All Known Implementing Classes:

AbstractService, AbstractServicesManagerService, AbstractTransactionService, ClientServer.AdministrableClientService, ClientService, DataServer.AdministrableDataService, DataService, DelegateTransactionService, DistributedTransactionService, DummyEventReportingService, JournalTransactionService, LoadBalancerServer.AdministrableLoadBalancer, LoadBalancerService, MetadataServer.AdministrableMetadataService, MetadataService, ServicesManagerServer.AdministrableServicesManagerService, TransactionServer.AdministrableTransactionService

public interface IService
extends Remote

Common service interface.

Version:

$Id: IService.java 2265 2009-10-26 12:51:06Z thompsonbry $

Author:

Bryan Thompson

Method Summary

void	destroy() Destroy the service.
String	getHostname() The host on which this service is running.
Class	getServiceIface() Return the most interesting interface for the service.
String	getServiceName() Return name by which a user might recognize this service.
UUID	getServiceUUID() The unique identifier for this service.

Method Detail

getServiceUUID

UUID getServiceUUID()
                    throws IOException

The unique identifier for this service.

Note: Some service discovery frameworks (Jini) will assign the service a UUID asynchronously after a new service starts, in which case this method will return null until the service UUID has been assigned.

Returns:

The unique data service identifier.

Throws:

IOException - since you can use this method with RMI.

getServiceIface

Class getServiceIface()
                      throws IOException

Return the most interesting interface for the service.

Throws:

IOException - since you can use this method with RMI.

getHostname

String getHostname()
                   throws IOException

The host on which this service is running.

Throws:

IOException - since you can use this method with RMI.

getServiceName

String getServiceName()
                      throws IOException

Return name by which a user might recognize this service.

Throws:

IOException - since you can use this method with RMI.

destroy

void destroy()
             throws RemoteException

Destroy the service. If the service is running, it is shutdown immediately and then destroyed. This method has the same signature as DestroyAdmin.destroy().

Throws:

RemoteException