Package com.bloomberglp.blpapi

Class ServiceRegistrationOptions

java.lang.Object

com.bloomberglp.blpapi.ServiceRegistrationOptions

public final class ServiceRegistrationOptions
extends Object

Contains the options which the user can specify when registering a service. To use non-default options to registerService, create an instance and set the required options and then supply it when using the registerService interface.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ServiceRegistrationOptions.RegistrationParts	Constants for specifying which part(s) of a service should be registered
static class	ServiceRegistrationOptions.ServiceRegistrationPriority	Constants for specifying the priority of registered service.

Constructor Summary

Constructors

Constructor	Description
ServiceRegistrationOptions()	Constructs a ServiceRegistrationOptions with well defined defaults for various options.

Method Summary

Modifier and Type	Method	Description
void	addActiveSubServiceCodeRange(int begin, int end, int priority)	Advertises the service to be registered to receive, with the specified 'priority', subscriptions that the resolver has mapped to a service code between the specified 'begin' and the specified 'end' values, inclusive.
String	getGroupId()	Returns the Group ID for the service to be registered to the specified groupId String.
int	getPartsToRegister()	Returns the parts of the service to be registered.
int	getServicePriority()	Returns the value of the service priority.
void	setGroupId(String groupId)	Sets the Group ID for the service to be registered to the specified groupId String.
void	setPartsToRegister(int parts)	Sets the parts of the service to be registered to the specified 'parts', which must be a bitwise-or of the options provided in ServiceRegistrationOptions.RegistrationParts, above.
void	setServicePriority(int priority)	Sets the priority with which a service will be registered to the specified priority.

Methods inherited from class java.lang.Object

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

Constructor Details

ServiceRegistrationOptions

public ServiceRegistrationOptions()

Constructs a ServiceRegistrationOptions with well defined defaults for various options. Currently the following defaults are applied.

     groupId                        = null
     priority                       = PRIORITY_HIGH
 

Method Details

getGroupId

public String getGroupId()

Returns the Group ID for the service to be registered to the specified groupId String.

getServicePriority

public int getServicePriority()

Returns the value of the service priority.

Note the priority is not supported for resolution services.

getPartsToRegister

public int getPartsToRegister()

Returns the parts of the service to be registered. See ServiceRegistrationOptions.RegistrationParts, above for additional details.

setGroupId

public void setGroupId(String groupId)

Sets the Group ID for the service to be registered to the specified groupId String. If groupId.length() > MAX_GROUP_ID_SIZE (=64) only the first MAX_GROUP_ID_SIZE chars are considered as Group Id.

setServicePriority

public void setServicePriority(int priority)

Sets the priority with which a service will be registered to the specified priority. Numerically greater values of priority indicate higher priorities. The behavior is undefined unless priority is non-negative. Note that while the values pre-defined in ServiceRegistrationOptions.ServiceRegistrationPriority are suitable for use here, any non-negative priority is acceptable.

Note that this does not have any effect on resolution services.

By default, a service will be registered with priority ServiceRegistrationOptions.ServiceRegistrationPriority.PRIORITY_HIGH.

setPartsToRegister

public void setPartsToRegister(int parts)

Sets the parts of the service to be registered to the specified 'parts', which must be a bitwise-or of the options provided in ServiceRegistrationOptions.RegistrationParts, above. This option defaults to ServiceRegistrationOptions.RegistrationParts.PART_DEFAULT.

addActiveSubServiceCodeRange

public void addActiveSubServiceCodeRange(int begin,
 int end,
 int priority)

Advertises the service to be registered to receive, with the specified 'priority', subscriptions that the resolver has mapped to a service code between the specified 'begin' and the specified 'end' values, inclusive. Numerically greater values of 'priority' indicate higher priorities. The behavior of this function is undefined unless '0 <= begin <= end < (1 << 24)', and 'priority' is non-negative.