public interface ServiceRegistration
ServiceRegistrar
Modifier and Type | Method and Description |
---|---|
void |
addAttributes(Entry[] attrSets)
Adds the specified attribute sets (those that aren't duplicates of
existing attribute sets) to the registered service item.
|
Lease |
getLease()
Returns the lease that controls the service registration, allowing
the lease to be renewed or cancelled.
|
ServiceID |
getServiceID()
Returns the service ID for this service.
|
void |
modifyAttributes(Entry[] attrSetTemplates,
Entry[] attrSets)
Modifies existing attribute sets.
|
void |
setAttributes(Entry[] attrSets)
Deletes all of the service item's existing attributes, and replaces
them with the specified attribute sets.
|
ServiceID getServiceID()
Lease getLease()
void addAttributes(Entry[] attrSets) throws UnknownLeaseException, RemoteException
attrSets
- attribute sets to addUnknownLeaseException
- the registration lease has expired
or been cancelled.RemoteException
void modifyAttributes(Entry[] attrSetTemplates, Entry[] attrSets) throws UnknownLeaseException, RemoteException
Note that it is possible to use modifyAttributes in ways that are not idempotent. The attribute schema should be designed in such a way that all intended uses of this method can be performed in an idempotent fashion. Also note that modifyAttributes does not provide a means for setting a field to null; it is assumed that the attribute schema is designed in such a way that this is not necessary.
attrSetTemplates
- attribute set templates to matchattrSets
- modifications to make to matching attribute setsUnknownLeaseException
- the registration lease has expired
or been cancelledIllegalArgumentException
- lengths of attrSetTemplates and
attrSets are not equal, or class of an attrSets element is
not the same as, or a superclass of, the class of the
corresponding attrSetTemplates elementRemoteException
void setAttributes(Entry[] attrSets) throws UnknownLeaseException, RemoteException
attrSets
- attribute sets to useUnknownLeaseException
- the registration lease has expired
or been cancelledRemoteException