public interface FabricConnection
Title: Service Event Fabric Client
Description: Defines a connection to the Fabric.
Copyright: Copyright (c) 2010
Company: StreamScape Technologies
Modifier and Type | Field and Description |
---|---|
static int |
DEFAULT_RECONNECT_ATTEMPTS |
static long |
DEFAULT_RECONNECT_INTERVAL |
static java.lang.String |
HTTP_TYPE |
static java.lang.String |
HTTPS_TYPE |
static java.lang.String |
LOCAL_URL
Standard URL for all local (embedded) connections.
|
static java.lang.String |
REST_TYPE |
static java.lang.String |
SSL_URL_PREFIX |
static java.lang.String |
TLP_TYPE |
static java.lang.String |
TLPS_TYPE |
static java.lang.String |
URL_PREFIX |
static java.lang.String |
XMPP_TYPE |
Modifier and Type | Method and Description |
---|---|
void |
acknowledgeEvent(EventDatagram event,
boolean withSourceData,
AcknowledgeAction action,
java.lang.String recipientId,
EventScope eventScope,
long timeToLive)
Raises an acknowledgement on the specified event.
|
void |
acknowledgeException(ExceptionEventDatagram ex,
AcknowledgeAction action,
java.lang.String recipientId,
EventScope eventScope,
long timeToLive)
Raises an acknowledgement on the specified exception event.
|
void |
addEventCache(java.lang.String eventFilter,
int maxSize,
CacheThresholdAction thresholdAction)
Adds a new event cache.
|
void |
addURL(java.lang.String url)
Adds the specified URL to the list of URLs.
|
void |
bindProducerFor(java.lang.String eventId)
Binds the specified event identifier to the connection.
|
void |
close()
Closes the connection.
|
void |
close(long timeout)
Closes the connection.
|
DataspaceAccessor |
createDataspaceAccessor(DataspaceType dataspaceType,
java.lang.String dataspaceName)
Creates an accessor to the dataspace with the specified type and name.
|
DataspaceAccessor |
createDataspaceAccessor(java.lang.String nodeName,
DataspaceType dataspaceType,
java.lang.String dataspaceName)
Creates an accessor to the dataspace with the specified type and name.
|
DomainConstraint |
createDomainConstraint(java.lang.String domainName,
java.lang.String description,
java.util.Set values)
Creates a new Domain Constraint with the specified parameters.
|
EventAsyncConsumer |
createEventAsyncConsumer(java.lang.String consumerName,
FabricEventListener listener,
java.lang.String eventFilter,
java.lang.String eventSelector,
EventScope eventScope,
boolean noLocal)
Creates a new event asynchronous consumer and adds this consumer the dispatcher.
|
EventConsumer |
createEventConsumer(java.lang.String consumerName,
FabricEventListener listener,
java.lang.String eventFilter,
java.lang.String eventSelector,
EventScope eventScope,
boolean noLocal)
Creates a new event consumer and adds this consumer to the dispatcher.
|
EventReceiver |
createEventReceiver(java.lang.String receiverName,
java.lang.String eventFilter,
java.lang.String eventSelector,
EventScope eventScope,
boolean noLocal)
Creates a new event receiver and adds this receiver to the the dispatcher.
|
RangeConstraint |
createRangeConstraint(java.lang.String rangeName,
java.lang.String description,
java.lang.Object minValue,
java.lang.Object maxValue)
Creates a new Range Constraint with the specified parameters.
|
EventRequestConsumer |
createRequestConsumer(java.lang.String consumerName,
FabricRequestListener listener,
EventScope eventScope)
Creates a new event request consumer and adds this consumer the dispatcher.
|
ServiceAccessor |
createServiceAccessor(java.lang.String serviceType,
java.lang.String serviceName)
Creates an accessor to a service with the specified type and name.
|
ServiceAccessor |
createServiceAccessor(java.lang.String nodeName,
java.lang.String serviceType,
java.lang.String serviceName)
Creates an accessor to a service with the specified type and name.
|
SLSession |
createSLSession()
Creates a
Semantic Language session to the current node. |
SLSession |
createSLSession(java.lang.String nodeName)
Creates a
Semantic Language session to the Fabric node with the specified name. |
void |
dropConsumer(java.lang.String consumerName)
Drops a consumer with the specified name.
|
void |
dropDomainConstraint(java.lang.String domainName)
Drops a Domain Constraint with the specified name.
|
void |
dropEventAsyncConsumer(java.lang.String consumerName)
Drops an event asynchronous with the specified name.
|
void |
dropEventConsumer(java.lang.String consumerName)
Drops an event consumer with the specified name from the dispatcher.
|
void |
dropEventReceiver(java.lang.String receiverName)
Drops a receiver with the specified name.
|
void |
dropRangeConstraint(java.lang.String rangeName)
Drops a Range Constraint with the specified name.
|
void |
dropRequestConsumer(java.lang.String consumerName)
Drops an event request with the specified name.
|
void |
exportEventPrototype(java.lang.String eventId)
Exports an Event Prototype with the specified event id to the Fabric node with which the connection established.
|
void |
exportExtensionArchive(java.io.File jarFile)
Exports the specified JAR file to the Fabric node with which the connection established.
|
void |
exportSemanticType(java.lang.String typeName)
Exports the specified Semantic Type to the Fabric node with which the connection established.
|
void |
forceClose()
Forcibly closes the connection.
|
AuthenticationType |
getAuthenticationType()
Returns an authentication type of the connection.
|
java.nio.charset.Charset |
getCCSID()
Returns a
CCSID configured in the current Fabric node. |
ClientId |
getClientId()
Returns a Client ID of the connection.
|
ComponentReference |
getComponentReference()
Returns a
ComponentReference associated with the connection. |
java.lang.String |
getDescription()
Returns a description of the connection.
|
DomainConstraint |
getDomainConstraint(java.lang.String domainName)
Finds and returns a copy of Domain Constraint with the specified name.
|
EventAsyncConsumer |
getEventAsyncConsumer(java.lang.String consumerName)
Finds and returns an event asynchronous consumer with the specified name.
|
EventCache |
getEventCache(java.lang.String eventFilter)
Returns an event cache associated with the specified simple event filter.
|
EventConsumer |
getEventConsumer(java.lang.String consumerName)
Finds and returns an event consumer with the specified name.
|
EventReceiver |
getEventReceiver(java.lang.String receiverName)
Finds and returns an event receiver with the specified name.
|
EventScope |
getEventScope()
Returns an event scope of the connection.
|
FabricEventListener |
getExceptionListener()
Returns the listener that processes all exception events raised in the node or sysplex.
|
ExceptionStrategy |
getExceptionStrategy()
Returns an exception strategy of the connection.
|
FabricAddress |
getFabricAddress()
Returns a Fabric address of the connection.
|
FabricGroupLink |
getGroupLink(java.lang.String groupName)
Returns a link to the specified group if the connection is a member of this group.
|
FabricGroupManager |
getGroupManager()
Returns a Fabric Group Manager associated with the connection.
|
java.util.TimeZone |
getHostTimezone()
Returns a timezone of the host where the current Fabric node is running.
|
Moderator |
getModerator()
Returns a moderator associated with the connection.
|
java.lang.String |
getName()
Returns a name of the connection.
|
java.util.TimeZone |
getNodeTimezone()
Returns a timezone configured in the current Fabric node.
|
RangeConstraint |
getRangeConstraint(java.lang.String rangeName)
Finds and returns a copy of Range Constraint with the specified name.
|
int |
getReconnectAttempts()
Returns a number of reconnect attempts that will be made by the connection in a case of the remote node disconnection.
|
long |
getReconnectInterval()
Returns a time (in seconds) between successive reconnect attempts that will be made by the connection
in a case of the remote node disconnection.
|
RepositoryAccessor |
getRepositoryAccessor()
Returns an accessor to the Repository located in the current node.
|
RepositoryAccessor |
getRepositoryAccessor(java.lang.String nodeName)
Returns an accessor to the Repository located in the node with the specified name.
|
EventRequestConsumer |
getRequestConsumer(java.lang.String consumerName)
Finds and returns an event request consumer with the specified name.
|
SecurityManager |
getSecurityManager()
Returns a Security Manager associated with the connection.
|
long |
getTimestamp()
Returns a timestamp indicating when the connection was opened.
|
java.lang.String |
getType()
Returns a type of the connection.
|
java.lang.String |
getURL()
Returns the actual URL of the connection.
|
java.util.List |
getURLs()
Returns a list of URLs.
|
java.lang.String |
getUserName()
Returns a user name of the connection.
|
boolean |
hasBoundEventIds()
Checks if the connection has bound event identifiers.
|
void |
importEventPrototype(java.lang.String eventId)
Imports an Event Prototype with the specified event id from the Fabric node with which the connection established.
|
void |
importExtensionArchive(java.lang.String archiveName)
Imports the specified extension archive from the Fabric node with which the connection established.
|
void |
importPackage(java.lang.String packageName)
Imports all archives of the specified Package from the Fabric node with which the connection established.
|
void |
importSemanticType(java.lang.String typeName)
Imports the specified Semantic Type from the Fabric node with which the connection established.
|
boolean |
isBoundEventId(java.lang.String eventId)
Checks if the specified event identifier is bound to the connection.
|
boolean |
isOpened()
Checks if the connection is opened.
|
boolean |
isReconnecting()
Checks if the remote node has disconnected and the connection is ready for reconnecting (or reconnecting is in progress).
|
boolean |
isSecurityEnabled()
Checks if the security is enabled in the Fabric.
|
FabricGroupLink |
joinGroup(java.lang.String groupName)
Joins the specified group.
|
void |
leaveGroup(java.lang.String groupName)
Leaves the specified group.
|
java.util.List |
listBoundEventIds()
Returns a list of event identifiers bound to the connection.
|
java.util.List |
listEventAsyncConsumers()
Returns a list of names of all event asynchronous consumers of this connection.
|
java.util.List |
listEventConsumers()
Returns a list of names of all event consumers of this connection.
|
java.util.List |
listEventReceivers()
Returns a list of names of all event receivers of this connection.
|
java.util.List |
listGroups()
Returns a list of the names of all groups to which the connection has joined.
|
java.util.List |
listRequestConsumers()
Returns a list of names of all event request consumers of this connection.
|
long |
nextGlobalCount()
Increments the
Global Counter and returns its new value. |
void |
open()
Opens the connection.
|
void |
open(long timeout)
Opens the remote connection with the specified timeout (in seconds) using the list of URls (@see
addURL(String) . |
PingResult |
ping()
Checks if a destination specified by the
URL parameter is available. |
void |
raiseAcknowledgement(AcknowledgementEvent event,
EventScope eventScope,
long timeToLive)
Raises the specified acknowledgment event.
|
void |
raiseAdvisory(AdvisoryEventDatagram event,
EventScope eventScope)
Raises the specified advisory event.
|
void |
raiseEvent(ImmutableEventDatagram event,
EventScope eventScope,
long timeToLive)
Raises the specified event.
|
void |
raiseException(ExceptionEventDatagram event,
EventScope eventScope)
Raises the specified exception event.
|
AcknowledgementEvent |
raiseRequest(EventDatagram request,
EventScope eventScope,
RequestDistributionStrategy distributionStrategy,
ReplyMatchStrategy matchStrategy,
long timeout)
Raises the specified request and waits until a reply will be received or timeout period will expire.
|
ImmutableEventDatagram |
raiseRequest(RequestConsumerReference consumer,
ImmutableEventDatagram request,
long timeout)
Raises the specified request and waits until a reply will be received or waiting period expires.
|
void |
removeEventCache(java.lang.String eventFilter)
Removes an event cache associated with the specified simple event filter.
|
void |
removeURL(java.lang.String url)
Removes the specified URLs from the list of URLs.
|
long |
resetGlobalCounter()
Resets the
Global Counter , setting its value to 1 . |
void |
setClientId(ClientId clientId)
Sets the specified connection Client ID.
|
void |
setDescription(java.lang.String description)
Sets the specified connection description.
|
void |
setDomainConstraint(DomainConstraint domain)
Updates the existing domain obtained by the method
#createDomainConstraint(String)
or getDomainConstraint(String) . |
void |
setEventScope(EventScope eventScope)
Sets the specified event scope.
|
void |
setExceptionListener(FabricEventListener listener)
Sets the listener that will process all exception events raised in the node or sysplex.
|
void |
setExceptionStrategy(ExceptionStrategy exceptionStrategy)
Sets the specified exception strategy of the connection.
|
void |
setName(java.lang.String name)
Sets the specified connection name.
|
void |
setPassword(java.lang.String password)
Sets the specified user password of the connection.
|
void |
setRangeConstraint(RangeConstraint range)
Updates the existing range obtained by the method
createRangeConstraint(String, String, Object, Object)
or getRangeConstraint(String) . |
void |
setReconnectAttempts(int reconnectAttempts)
Sets a number of reconnect attempts that will be made by the connection in a case of the remote node disconnection.
|
void |
setReconnectInterval(long reconnectInterval)
Sets a time (in seconds) between successive reconnect attempts that will be made by the connection
in a case of the remote node disconnection.
|
void |
setSecurityToken(java.lang.String token)
Sets the specified
Web Application Token for the connection. |
void |
setUserName(java.lang.String userName)
Sets the specified user name of the connection.
|
long |
showGlobalCounter()
Returns the current value of the
Global Counter . |
void |
unbindProducerFor(java.lang.String eventId)
Unbinds the specified event identifier from the connection.
|
static final java.lang.String URL_PREFIX
static final java.lang.String SSL_URL_PREFIX
static final java.lang.String TLP_TYPE
static final java.lang.String TLPS_TYPE
static final java.lang.String HTTP_TYPE
static final java.lang.String HTTPS_TYPE
static final java.lang.String REST_TYPE
static final java.lang.String XMPP_TYPE
static final java.lang.String LOCAL_URL
static final int DEFAULT_RECONNECT_ATTEMPTS
static final long DEFAULT_RECONNECT_INTERVAL
java.lang.String getName()
void setName(java.lang.String name) throws FabricConnectionException
name
- the name to be set.FabricConnectionException
- if the connection is opened or
if the specified name has invalid format.ClientId getClientId()
void setClientId(ClientId clientId) throws FabricConnectionException
clientId
will be used as connection name:
setName(clientId.toString());
.clientId
- the Client ID to be set.FabricConnectionException
- if the connection is opened or
if the specified Client ID has invalid format.java.lang.String getType()
java.lang.String getDescription()
void setDescription(java.lang.String description) throws FabricConnectionException
description
- the description to be set.FabricConnectionException
- if the connection is opened or
if the description length more than 20 characters.void addURL(java.lang.String url) throws FabricConnectionException
If this list contains only local URLs (tlp://local
) other URLs cannot be added.
And vice versa, a local URL cannot be added to the list containing non-local URLs.
Non-local URLs must have the following format: <Protocol>://<Host>:<Port>
(e.g. tlp://localhost:5000
).
url
- the URL to be added.FabricConnectionException
- if the specified URL has wrong format or
if the specified URL is not allowed.void removeURL(java.lang.String url)
url
- the URL to be removed.java.util.List getURLs()
java.lang.String getURL()
null
if the connection is not opened.EventScope getEventScope()
void setEventScope(EventScope eventScope) throws FabricConnectionException
eventScope
- the event scope to be set.FabricConnectionException
- if the connection is opened.java.lang.String getUserName()
void setUserName(java.lang.String userName) throws FabricConnectionException
userName
- the user name to be set.FabricConnectionException
- if the connection is opened.void setPassword(java.lang.String password) throws FabricConnectionException
password
- the user password to be set.FabricConnectionException
- if the connection is opened.void setSecurityToken(java.lang.String token) throws FabricConnectionException
Web Application Token
for the connection.
null
(by default) or an empty string, the user credentials are used.token
- the security token to be set.FabricConnectionException
- if the connection is opened.int getReconnectAttempts() throws FabricConnectionException
Value 0
means that the connection will not attempt to reconnect.
Negative value means that the connection will try to reconnect infinitely (until successful connecting).
Default value is -1
.
This method is applicable to the Client Context only (i.e. for remote connections).
FabricConnectionException
- if the current context is a Runtime Context.void setReconnectAttempts(int reconnectAttempts) throws FabricConnectionException
Value 0
means that the connection will not attempt to reconnect.
Negative value means that the connection will try to reconnect infinitely (until successful connecting).
This method is applicable to the Client Context only (i.e. for remote connections).
reconnectAttempts
- the value to be set.FabricConnectionException
- if the current context is a Runtime Context.long getReconnectInterval() throws FabricConnectionException
Default value is 30L
.
This method is applicable to the Client Context only (i.e. for remote connections).
FabricConnectionException
- if the current context is a Runtime Context.void setReconnectInterval(long reconnectInterval) throws FabricConnectionException
This method is applicable to the Client Context only (i.e. for remote connections).
reconnectInterval
- the value to be set.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is opened or
if the specified interval is not positive (i.e. reconnectInterval <= 0
);boolean isReconnecting() throws FabricConnectionException
This method is applicable to the Client Context only (i.e. for remote connections).
true
if the connection is currently reconnecting to the remote node, false
otherwise.FabricConnectionException
- if the current context is a Runtime Context.PingResult ping()
URL
parameter is available.
addURL(String)
method.
This method will always return UNAVAILABLE
if the connection has LOCAL
event scope.
boolean isSecurityEnabled() throws FabricConnectionException
This method will always return false
if the connection has LOCAL
event scope.
true
if the security is enabled, false
otherwise.FabricConnectionException
- if some error occurs in the Exchange.void open() throws FabricConnectionException, SecurityManagerException
open(long)
will be invoked with the default timeout (10 seconds).
Client Context in one JVM allows opening connections with nodes belonging to just one Fabric (sysplex). So, if there are connections established with one sysplex it is impossible to open a new connection to another sysplex in this JVM.
FabricConnectionException
- if some error occurs during the connection opening.SecurityManagerException
- if the authentication fails due to invalid user name or password.void open(long timeout) throws FabricConnectionException, SecurityManagerException
addURL(String)
.
This method is applicable to the Client Context only (i.e. for remote connections).
Client Context in one JVM allows opening connections with nodes belonging to just one Fabric (sysplex).
So, if there are connections established with one sysplex it is impossible to open a new connection to another sysplex in this JVM.
timeout
- the timeout value (in seconds).FabricConnectionException
- if some error occurs during the connection opening.SecurityManagerException
- if the authentication fails due to invalid user name or password.void close() throws FabricConnectionException
EventAsyncConsumer.DEFAULT_CLOSE_TIMEOUT
milliseconds until remaining events
in all asynchronous consumers will be processed and closes them after that.
close({@link EventAsyncConsumer#DEFAULT_CLOSE_TIMEOUT})
.FabricConnectionException
- if some error occurs during the connection closing.void close(long timeout) throws FabricConnectionException
timeout
- the wait time (in milliseconds) for closing all asynchronous consumers.FabricConnectionException
- if some error occurs during the connection closing.void forceClose() throws FabricConnectionException
close(0)
.FabricConnectionException
- if some error occurs during the connection closing.boolean isOpened()
true
if the connection is opened, false
otherwise.long getTimestamp()
-1
if the connection is not yet opened (or the opening was not successful).
Returns the time of a last successful reconnection if it is available.
This ability is applicable to the Client Context only (i.e. for remote connections).
AuthenticationType getAuthenticationType() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened.ComponentReference getComponentReference() throws FabricConnectionException
ComponentReference
associated with the connection.
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricAddress getFabricAddress() throws FabricConnectionException
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.Moderator getModerator() throws FabricConnectionException
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.SecurityManager getSecurityManager() throws FabricConnectionException, SecurityManagerException
In the Runtime Context this method will fail if the connection is not opened.
In the Client Context a security manager, obtained from the non-opened connection, will have privileges of anonymous user
(only the method SecurityManager.createUser(String, String, String)
will be allowed).
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened in the Runtime Context.SecurityManagerException
- if the security is disabled in the Fabric.RepositoryAccessor getRepositoryAccessor() throws FabricConnectionException
getRepositoryAccessor(null)
.
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.RepositoryAccessor getRepositoryAccessor(java.lang.String nodeName) throws FabricConnectionException
This method will return null
if the connection has LOCAL
event scope.
nodeName
- the name of the node in which the repository locates.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.DataspaceAccessor createDataspaceAccessor(DataspaceType dataspaceType, java.lang.String dataspaceName) throws FabricConnectionException, FabricComponentAccessorException
createDataspaceAccessor(null, dataspaceType, dataspaceName)
.
This method will return null
if the connection has LOCAL
event scope.
dataspaceType
- the type of the accessed dataspace.dataspaceName
- the name of the accessed dataspace.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricComponentAccessorException
- if some error occurs during creation of the accessor.DataspaceAccessor createDataspaceAccessor(java.lang.String nodeName, DataspaceType dataspaceType, java.lang.String dataspaceName) throws FabricConnectionException, FabricComponentAccessorException
This method will return null
if the connection has LOCAL
event scope.
nodeName
- the node name in which the dataspace will be looked up.dataspaceType
- the type of a dataspace to which the accessor will be created.dataspaceName
- the name of a dataspace to which the accessor will be created.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricComponentAccessorException
- if some error occurs during creation of the accessor.ServiceAccessor createServiceAccessor(java.lang.String serviceType, java.lang.String serviceName) throws FabricConnectionException, FabricComponentAccessorException
createServiceAccessor(null, serviceType, serviceName)
.
This method will return null
if the connection has LOCAL
event scope.
serviceType
- the type of the accessed service.serviceName
- the name of the accessed service.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricComponentAccessorException
- if some error occurs.ServiceAccessor createServiceAccessor(java.lang.String nodeName, java.lang.String serviceType, java.lang.String serviceName) throws FabricConnectionException, FabricComponentAccessorException
This method will return null
if the connection has LOCAL
event scope.
nodeName
- the node name in which the service will be looked up.serviceType
- the type of the accessed service.serviceName
- the name of the accessed service.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricComponentAccessorException
- if some error occurs during creation of the accessor.SLSession createSLSession() throws FabricConnectionException, SLSessionException
Semantic Language
session to the current node.
createSLSession(null)
.
This method will return null
if the connection has LOCAL
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.SLSessionException
- if some error occurs during creation of the session.SLSession createSLSession(java.lang.String nodeName) throws FabricConnectionException, SLSessionException
Semantic Language
session to the Fabric node with the specified name.
nodeName
is null
, the session will be created to the current node.
This method will return null
if the connection has LOCAL
event scope.
nodeName
- the node name to which the session will be created.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.SLSessionException
- if some error occurs during creation of the session.void raiseAdvisory(AdvisoryEventDatagram event, EventScope eventScope) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
event
- the event to be raised.eventScope
- the scope of the raised event.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).void raiseEvent(ImmutableEventDatagram event, EventScope eventScope, long timeToLive) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
event
- the event to be raised.eventScope
- the scope of the raised event.timeToLive
- the time interval (in milliseconds) within that the event persists (in a queue, cache or internal buffer)
before it will be discarded. Non-positive value implies ignoring of this parameter.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).ImmutableEventDatagram raiseRequest(RequestConsumerReference consumer, ImmutableEventDatagram request, long timeout) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricRequestException
consumer
- the consumer which will process the request.request
- the request to be raised.timeout
- the waiting time for reply (in milliseconds).FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricRequestException
- if some error occurs during processing of the request in the listener.AcknowledgementEvent raiseRequest(EventDatagram request, EventScope eventScope, RequestDistributionStrategy distributionStrategy, ReplyMatchStrategy matchStrategy, long timeout) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
Only AUCTION
distribution strategy is supported at present.
request
- the request to be raised.eventScope
- the scope of the raised request.distributionStrategy
- the strategy used for a distribution of the request.matchStrategy
- the strategy used for a matching of the reply.timeout
- the waiting time for reply (in milliseconds).FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the request in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).void raiseException(ExceptionEventDatagram event, EventScope eventScope) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
event
- the exception event to be raised.eventScope
- the scope of the raised exception.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).void raiseAcknowledgement(AcknowledgementEvent event, EventScope eventScope, long timeToLive) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
event
- the event to be raised.eventScope
- the scope of the raised event.timeToLive
- the time interval (in milliseconds) within that the event persists (in a queue, cache or internal buffer)
before it will be discarded. Non-positive value implies ignoring of this parameter.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).void acknowledgeEvent(EventDatagram event, boolean withSourceData, AcknowledgeAction action, java.lang.String recipientId, EventScope eventScope, long timeToLive) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
event
- the event for which the acknowledgement will be raised.withSourceData
- the flag indicating if the event data will be copied into the acknowledgement event.action
- the action which will be made after raising of the acknowledgement.recipientId
- the identifier of the acknowledgement recipient.eventScope
- the scope of the raised acknowledgement.timeToLive
- the time interval (in milliseconds) within that the event persists (in a queue, cache or internal buffer)
before it will be discarded. Non-positive value implies ignoring of this parameter.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).void acknowledgeException(ExceptionEventDatagram ex, AcknowledgeAction action, java.lang.String recipientId, EventScope eventScope, long timeToLive) throws FabricConnectionException, FabricEventSourceException, FabricUnboundEventException, FabricEventException
ex
- the event for which the acknowledgement will be raised.action
- the action which will be made after the raising.recipientId
- the identifier of a recipient of the acknowledgement.eventScope
- the scope of the raised acknowledgement.timeToLive
- the time interval (in milliseconds) within that the event persists (in a queue, cache or internal buffer)
before it will be discarded. Non-positive value implies ignoring of this parameter.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventSourceException
- if some error occurs in the Exchange.FabricUnboundEventException
- if the specified event is not bound to the connection.FabricEventException
- if some error occurs during processing of the event in the listener.
This exception won't be raised for asynchronous listeners (EventAsyncConsumer
).EventConsumer createEventConsumer(java.lang.String consumerName, FabricEventListener listener, java.lang.String eventFilter, java.lang.String eventSelector, EventScope eventScope, boolean noLocal) throws FabricConnectionException, FabricEventDispatcherException
consumerName
- the name of the consumer.listener
- the listener associated with the consumer.eventFilter
- the event filter of the consumer.eventSelector
- the event selector of the consumer.
Selector allows to specify almost any conditions on event properties which should
be satisfied for an event to be consumed.
See EventDispatcher
for details.eventScope
- the event scope of the consumer.noLocal
- true
if the consumer will not process events raised by this connection.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropEventConsumer(java.lang.String consumerName) throws FabricConnectionException, FabricEventDispatcherException
consumerName
- the name of consumer to be dropped.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified consumer name is invalid.EventAsyncConsumer createEventAsyncConsumer(java.lang.String consumerName, FabricEventListener listener, java.lang.String eventFilter, java.lang.String eventSelector, EventScope eventScope, boolean noLocal) throws FabricConnectionException, FabricEventDispatcherException
QUEUE DEPTH
, DELIVERY WAIT
and FLOW CONTROL
strategies may be configured prior to starting the consumer.consumerName
- the name of the consumer.listener
- the listener associated with the consumer.eventFilter
- the event filter of the consumer.eventSelector
- the event selector of the consumer.
Selector allows to specify almost any conditions on event properties which should
be satisfied for an event to be consumed.
See EventDispatcher
for details.eventScope
- the event scope of the consumer.noLocal
- true
if the consumer will not process events raised by this connection.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropEventAsyncConsumer(java.lang.String consumerName) throws FabricConnectionException, FabricEventDispatcherException
EventAsyncConsumer.DEFAULT_CLOSE_TIMEOUT
seconds until all remaining events
in the underlying event queue will be processed and stops the delivery thread after that.consumerName
- the name of consumer to be dropped.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified consumer name is invalid.EventRequestConsumer createRequestConsumer(java.lang.String consumerName, FabricRequestListener listener, EventScope eventScope) throws FabricConnectionException, FabricEventDispatcherException
consumerName
- the name of the consumer.listener
- the listener associated with the consumer.eventScope
- the event scope of the consumer. It cannot be LOCAL
.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropRequestConsumer(java.lang.String consumerName) throws FabricConnectionException, FabricEventDispatcherException
consumerName
- the name of consumer to be dropped.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified consumer name is invalid.void dropConsumer(java.lang.String consumerName) throws FabricConnectionException, FabricEventDispatcherException
consumerName
- the name of consumer to be dropped.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified consumer name is invalid.EventConsumer getEventConsumer(java.lang.String consumerName) throws FabricConnectionException
consumerName
- the name of consumer which should be found.null
if consumer was not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.EventAsyncConsumer getEventAsyncConsumer(java.lang.String consumerName) throws FabricConnectionException
consumerName
- the name of consumer which is to be found.null
if consumer is not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.EventRequestConsumer getRequestConsumer(java.lang.String consumerName) throws FabricConnectionException
consumerName
- the name of consumer which is to be found.null
if consumer was not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.java.util.List listEventConsumers() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.java.util.List listEventAsyncConsumers() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.java.util.List listRequestConsumers() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.EventReceiver createEventReceiver(java.lang.String receiverName, java.lang.String eventFilter, java.lang.String eventSelector, EventScope eventScope, boolean noLocal) throws FabricConnectionException, FabricEventDispatcherException
receiverName
- the name of the receiver.eventFilter
- the event filter of the receiver.eventSelector
- the event selector of the receiver.
Selector allows to specify almost any conditions on event properties which should
be satisfied for an event to be received.
See EventDispatcher
for details.eventScope
- the event scope of the receiver.noLocal
- true
if the receiver will not get events raised by this connection.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropEventReceiver(java.lang.String receiverName) throws FabricConnectionException, FabricEventDispatcherException
receiverName
- the name of the receiver to be dropped.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified consumer name is invalid.EventReceiver getEventReceiver(java.lang.String receiverName) throws FabricConnectionException
receiverName
- the name of receiver which is to be found.null
if receiver is not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.java.util.List listEventReceivers() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.void addEventCache(java.lang.String eventFilter, int maxSize, CacheThresholdAction thresholdAction) throws FabricConnectionException, FabricEventDispatcherException
Since an event cache always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
eventFilter
- the simple event filter associated with the cache.maxSize
- the cache size (maximum number of events which the cache can contain).thresholdAction
- the type of action which is performed if the cache is overflowed.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.FabricEventDispatcherException
- if some error occurs in the Exchange.void removeEventCache(java.lang.String eventFilter) throws FabricConnectionException
Since an event cache always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
eventFilter
- the simple event associated with the cache.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.EventCache getEventCache(java.lang.String eventFilter) throws FabricConnectionException
Since an event cache always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
eventFilter
- the event filter associated with the cache.null
if the cache is not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.void bindProducerFor(java.lang.String eventId) throws FabricConnectionException, FabricEventDispatcherException
The method will fail if an event prototype associated with the specified event does not exist.
See PrototypeFactory
to get information about operations with event prototypes.
eventId
- the event id to be bound.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if the specified event id is already bound to the connection or
if the corresponding event prototype does not exist.void unbindProducerFor(java.lang.String eventId) throws FabricConnectionException
eventId
- the event id to be unbound.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.boolean hasBoundEventIds() throws FabricConnectionException
true
if the connection has bound event ids, false
otherwise.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.boolean isBoundEventId(java.lang.String eventId) throws FabricConnectionException
eventId
- the event id to be checked.true
if the event id is bound to the connection, false
otherwise.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.java.util.List listBoundEventIds() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.ExceptionStrategy getExceptionStrategy() throws FabricConnectionException
EventConsumer
)
during a processing of events raised by the connection.FabricConnectionException
- if the connection is not opened.void setExceptionStrategy(ExceptionStrategy exceptionStrategy) throws FabricConnectionException
EventConsumer
)
during a processing of events raised by the connection.exceptionStrategy
- the exception strategy to be set.FabricConnectionException
- if the connection is not opened.DomainConstraint createDomainConstraint(java.lang.String domainName, java.lang.String description, java.util.Set values) throws FabricConnectionException, FabricEventDispatcherException
String
Byte
Short
Integer
Long
Float
Double
BigDecimal
Date
Changing the returned object will have no effect until the method
setDomainConstraint(DomainConstraint)
is invoked for this object.
domainName
- the domain name.description
- the domain description.values
- the domain values.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropDomainConstraint(java.lang.String domainName) throws FabricConnectionException, FabricEventDispatcherException
domainName
- the domain name.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.DomainConstraint getDomainConstraint(java.lang.String domainName) throws FabricConnectionException, FabricEventDispatcherException
Changing the returned object will have no effect until the method
setDomainConstraint(DomainConstraint)
is invoked for this object.
domainName
- the domain name.null
if the corresponding domain is not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void setDomainConstraint(DomainConstraint domain) throws FabricConnectionException, FabricEventDispatcherException
#createDomainConstraint(String)
or getDomainConstraint(String)
.domain
- the domain to be updated.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.RangeConstraint createRangeConstraint(java.lang.String rangeName, java.lang.String description, java.lang.Object minValue, java.lang.Object maxValue) throws FabricConnectionException, FabricEventDispatcherException
Number
Date
Changing the returned object will have no effect until the method
setRangeConstraint(RangeConstraint)
is invoked for this object.
rangeName
- the range name.description
- the range description.minValue
- the min boundary value of the range.maxValue
- the max boundary value of the range.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void dropRangeConstraint(java.lang.String rangeName) throws FabricConnectionException, FabricEventDispatcherException
rangeName
- the range name.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.RangeConstraint getRangeConstraint(java.lang.String rangeName) throws FabricConnectionException, FabricEventDispatcherException
Changing the returned object will have no effect until the method
setRangeConstraint(RangeConstraint)
is invoked for this object.
rangeName
- the range name.null
if the corresponding range is not found.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.void setRangeConstraint(RangeConstraint range) throws FabricConnectionException, FabricEventDispatcherException
createRangeConstraint(String, String, Object, Object)
or getRangeConstraint(String)
.range
- the range to be updated.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation.FabricEventDispatcherException
- if some error occurs in the Exchange.FabricGroupManager getGroupManager() throws FabricConnectionException
Since a group always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.FabricGroupLink joinGroup(java.lang.String groupName) throws FabricConnectionException, FabricGroupManagerException
Since a group always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
groupName
- the name of the group.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope or
if the connection already joined the specified group.FabricGroupManagerException
- if the specified group does not exist.void leaveGroup(java.lang.String groupName) throws FabricConnectionException, FabricGroupManagerException
Since a group always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
groupName
- the name of the specified group.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.FabricGroupManagerException
- if the specified group does not exist.FabricGroupLink getGroupLink(java.lang.String groupName) throws FabricConnectionException
Since a group always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
groupName
- the name of the group.null
if the connection is not a member of this group.FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.java.util.List listGroups() throws FabricConnectionException
Since a group always has GLOBAL
event scope, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope.void setExceptionListener(FabricEventListener listener) throws FabricConnectionException, FabricEventDispatcherException
INHERITED
event scope.
If the specified listener is null
the previous listener is nullified (i.e. associated consumer is removed).
listener
- the listener to be set.FabricConnectionException
- if the connection is not opened.FabricEventDispatcherException
- if some error occurs in the Exchange.FabricEventListener getExceptionListener()
void exportExtensionArchive(java.io.File jarFile) throws FabricConnectionException, RepositoryException
ext
area of the Repository.
Since this operation has impact on the whole Fabric, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
jarFile
- the JAR file to be exported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope or
if some error occurs in the Exchange.RepositoryException
- if the corresponding archive already exists in the Fabric node or
if some other error occurs in the Repository of the node.void importExtensionArchive(java.lang.String archiveName) throws FabricConnectionException, RepositoryException, ArchiveException
ext
area of the Repository.
This method will throw exception if the connection has LOCAL
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
archiveName
- the name of archive to be imported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
event scope or
if some error occurs in the Exchange.RepositoryException
- if the corresponding archive does not exist in the Fabric node or
if some other error occurs in the Repository of the node.ArchiveException
- if the corresponding archive already exists or
if some error occurs during adding the archive to the system class loader.void importPackage(java.lang.String packageName) throws FabricConnectionException, javax.naming.NamingException, RepositoryException, ArchiveException
sdo.TestPackage
).
lib
area of the Repository.
This method will throw exception if the connection has LOCAL
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
packageName
- the name of package to be imported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
event scope or
if some error occurs in the Exchange.javax.naming.NamingException
- if the specified name has invalid format.RepositoryException
- if the corresponding package does not exist in the Fabric node or
if some other error occurs in the Repository of the node.ArchiveException
- if the corresponding package already exists or
if some error occurs during adding the archives to the system class loader.void exportSemanticType(java.lang.String typeName) throws FabricConnectionException, SemanticTypeFactoryException
Since this operation has impact on the whole Fabric, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
typeName
- the name of semantic type to be exported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope or
if some error occurs in the Exchange.SemanticTypeFactoryException
- if the corresponding type does not exist in the current context or
if the corresponding type already exists in the Fabric node.void importSemanticType(java.lang.String typeName) throws FabricConnectionException, SemanticTypeFactoryException, ArchiveException
This method will throw exception if the connection has LOCAL
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
typeName
- the name of semantic type to be imported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
event scope or
if some error occurs in the Exchange.SemanticTypeFactoryException
- if the corresponding type already exists in the current context or
if the corresponding type does not exist in the Fabric node.ArchiveException
- if some error occurs during adding the corresponding archives to the system class loader.void exportEventPrototype(java.lang.String eventId) throws FabricConnectionException, DatagramFactoryException
This method will throw exception if the connection has LOCAL
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
eventId
- the event id of prototype to be exported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
or OBSERVABLE
event scope or
if some error occurs in the Exchange.DatagramFactoryException
- if the corresponding prototype does not exist in the current context or
if the corresponding prototype already exists in the Fabric node.void importEventPrototype(java.lang.String eventId) throws FabricConnectionException, DatagramFactoryException, ArchiveException
Since this operation has impact on the whole Fabric, this method will throw exception
if the connection has LOCAL
or OBSERVABLE
event scope.
This method is applicable to the Client Context only (i.e. for remote connections).
eventId
- the event id of prototype to be imported.FabricConnectionException
- if the current context is a Runtime Context or
if the connection is not opened or
if the user has insufficient rights to perform this operation or
if the connection has LOCAL
event scope or
if some error occurs in the Exchange.DatagramFactoryException
- if the corresponding prototype already exists in the current context or
if the corresponding prototype does not exist in the Fabric node.ArchiveException
- if some error occurs during adding the corresponding archives to the system class loader.java.util.TimeZone getHostTimezone() throws FabricConnectionException
FabricConnectionException
- if the connection is not opened.java.util.TimeZone getNodeTimezone() throws FabricConnectionException
getHostTimezone()
).FabricConnectionException
- if the connection is not opened.java.nio.charset.Charset getCCSID() throws FabricConnectionException
CCSID
configured in the current Fabric node.
CCSID
configured in the Dataspace Store.FabricConnectionException
- if the connection is not opened.long nextGlobalCount() throws FabricConnectionException
Global Counter
and returns its new value.
FabricConnectionException
- if the connection is not opened or
if some error occurs in the Exchange.long showGlobalCounter() throws FabricConnectionException
Global Counter
.
FabricConnectionException
- if the connection is not opened or
if some error occurs in the Exchange.long resetGlobalCounter() throws FabricConnectionException
Global Counter
, setting its value to 1
.
Only administrator can invoke this method.
0
).FabricConnectionException
- if the connection is not opened or
if the user has insufficient rights to perform this operation or
if some error occurs in the Exchange.Copyright © 2015-2024 StreamScape Technologies. All rights reserved.