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 and 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 and Description
ServiceRegistrationOptions() Constructs a ServiceRegistrationOptions with well defined defaults for various options.

Method Summary

Modifier and Type	Method and 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 for subscription services.
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 publishing 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 Detail

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 Detail

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 for subscription services. Note that the priority is only used in the publisher part of the service. Request-response and resolution services cannot be configured with different priorities.

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 publishing 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 request-response or 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.