Interface GatewayConnection
- 
- All Known Implementing Classes:
- AbstractGatewayConnection,- ClientGatewayConnection,- DesignerGatewayConnection
 
 public interface GatewayConnection
- 
- 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddConnectionListener(ConnectionListener listener)voidaddConnectionStatusListener(ConnectionStatusListener listener)Different from the ConnectionListener in the sense that this listener is intended for use in redundant setups, where the status of the inactive connection must be updated along with the status of the active connection.voidaddPropertyChangeListener(java.beans.PropertyChangeListener l)voidaddPropertyChangeListener(java.lang.String propName, java.beans.PropertyChangeListener l)voidaddPushNotificationListener(PushNotificationListener listener)voidconnect(java.util.List<HttpURL> gatewayURLs)Connect to the gateway(s) specifiedvoiddisconnect()java.util.List<HttpURL>getAllAddresses()Returns a list of all possible Gateway addresses that are known to the client.AuthChallengegetAuthChallenge()The encrypted auth challenge that was used to log inintgetConnectionMode()Returns the current connection mode: MODE_FULL MODE_READ_ONLY MODE_DISCONNECTEDintgetConnectTimeout()java.lang.StringgetEdgeProjectName()HttpURLgetGatewayAddress()Returns the address of the gateway that is currently being communicated with.GatewayInterfacegetGatewayInterface()java.lang.StringgetGatewayNodeRole()Returns the string version of the currently connected gateway's "Node Role", which will be one of: Independent Master Backupjava.util.TimeZonegetGatewayTimeZone()java.lang.StringgetGatewayWebURL()Returns the url to the web portion of the gateway, like "http[s]://<address>:<port>[/context]"intgetHttpConcurrency()The number of concurrent HTTP connections allowed.intgetOpcBrowseTimeout()java.lang.StringgetPlatformEdition()Platform edition.java.lang.StringgetProjectName()The name of the project that we are currently logged into, if any.java.util.List<java.lang.String>getRoles()The set of roles that the actively logged in user has, if any.java.lang.StringgetScheme()Returns "http" or "https" depending on our transport schemejava.util.List<java.lang.String>getSecurityZones()The set of security zones that the actively logged in user has, if any.intgetSocketTimeout()java.lang.StringgetUsername()The username of the actively logged in user, if any.AuthenticatedUseridpLoginFinish(java.lang.String projectName)java.net.URIidpLoginStart(java.lang.String projectName)booleanisConnected()booleanisConnectionUp()booleanisPlatformLicensed()booleanisSessionValid()AuthenticatedUserlogin(java.lang.String projectName, AuthChallenge challenge)voidlogout()voidremoveConnectionListener(ConnectionListener listener)voidremoveConnectionStatusListener(ConnectionStatusListener listener)voidremovePropertyChangeListener(java.beans.PropertyChangeListener l)voidremovePropertyChangeListener(java.lang.String propName, java.beans.PropertyChangeListener l)voidremovePushNotificationListener(PushNotificationListener listener)voidremovePushNotificationListeners(java.lang.Class<?> c)voidsetConnectionMode(int connectionMode)voidsetConnectTimeout(int connectTimeout)voidsetHttpConcurrency(int concurrency)voidsetOpcBrowseTimeout(int opcBrowseTimeout)voidsetSocketTimeout(int socketTimeout)voidtriggerConnectionStatusListeners()Manually update the status of all connection listeners.
 
- 
- 
- 
Method Detail- 
connectvoid connect(java.util.List<HttpURL> gatewayURLs) Connect to the gateway(s) specified
 - 
disconnectvoid disconnect() 
 - 
getGatewayAddressHttpURL getGatewayAddress() Returns the address of the gateway that is currently being communicated with.
 - 
getAllAddressesjava.util.List<HttpURL> getAllAddresses() Returns a list of all possible Gateway addresses that are known to the client. This list includes redundant master and backup addresses. The list is used for client restarts.
 - 
getGatewayInterfaceGatewayInterface getGatewayInterface() 
 - 
getGatewayWebURLjava.lang.String getGatewayWebURL() Returns the url to the web portion of the gateway, like "http[s]://<address>:<port>[/context]"
 - 
getSchemejava.lang.String getScheme() Returns "http" or "https" depending on our transport scheme
 - 
getGatewayNodeRolejava.lang.String getGatewayNodeRole() Returns the string version of the currently connected gateway's "Node Role", which will be one of:- Independent
- Master
- Backup
 
 - 
getGatewayTimeZonejava.util.TimeZone getGatewayTimeZone() 
 - 
loginAuthenticatedUser login(java.lang.String projectName, AuthChallenge challenge) throws GatewayException - Throws:
- GatewayException
 
 - 
idpLoginStart@Nullable java.net.URI idpLoginStart(java.lang.String projectName) throws GatewayException- Throws:
- GatewayException
 
 - 
idpLoginFinish@Nullable AuthenticatedUser idpLoginFinish(java.lang.String projectName) throws GatewayException - Throws:
- GatewayException
 
 - 
logoutvoid logout() 
 - 
getConnectionModeint getConnectionMode() Returns the current connection mode:- MODE_FULL
- MODE_READ_ONLY
- MODE_DISCONNECTED
 
 - 
setConnectionModevoid setConnectionMode(int connectionMode) 
 - 
isConnectedboolean isConnected() 
 - 
isConnectionUpboolean isConnectionUp() 
 - 
isSessionValidboolean isSessionValid() 
 - 
addPushNotificationListenervoid addPushNotificationListener(PushNotificationListener listener) 
 - 
removePushNotificationListenervoid removePushNotificationListener(PushNotificationListener listener) 
 - 
removePushNotificationListenersvoid removePushNotificationListeners(java.lang.Class<?> c) 
 - 
addPropertyChangeListenervoid addPropertyChangeListener(java.beans.PropertyChangeListener l) 
 - 
removePropertyChangeListenervoid removePropertyChangeListener(java.beans.PropertyChangeListener l) 
 - 
addPropertyChangeListenervoid addPropertyChangeListener(java.lang.String propName, java.beans.PropertyChangeListener l)
 - 
removePropertyChangeListenervoid removePropertyChangeListener(java.lang.String propName, java.beans.PropertyChangeListener l)
 - 
addConnectionListenervoid addConnectionListener(ConnectionListener listener) 
 - 
removeConnectionListenervoid removeConnectionListener(ConnectionListener listener) 
 - 
getProjectNamejava.lang.String getProjectName() The name of the project that we are currently logged into, if any.
 - 
getUsernamejava.lang.String getUsername() The username of the actively logged in user, if any.
 - 
getAuthChallengeAuthChallenge getAuthChallenge() The encrypted auth challenge that was used to log in
 - 
getRolesjava.util.List<java.lang.String> getRoles() The set of roles that the actively logged in user has, if any.
 - 
getSecurityZonesjava.util.List<java.lang.String> getSecurityZones() The set of security zones that the actively logged in user has, if any.
 - 
getConnectTimeoutint getConnectTimeout() 
 - 
setConnectTimeoutvoid setConnectTimeout(int connectTimeout) 
 - 
getSocketTimeoutint getSocketTimeout() 
 - 
setSocketTimeoutvoid setSocketTimeout(int socketTimeout) 
 - 
getOpcBrowseTimeoutint getOpcBrowseTimeout() 
 - 
setOpcBrowseTimeoutvoid setOpcBrowseTimeout(int opcBrowseTimeout) 
 - 
getHttpConcurrencyint getHttpConcurrency() The number of concurrent HTTP connections allowed. 0 or less means unlimited.
 - 
setHttpConcurrencyvoid setHttpConcurrency(int concurrency) 
 - 
addConnectionStatusListenervoid addConnectionStatusListener(ConnectionStatusListener listener) Different from the ConnectionListener in the sense that this listener is intended for use in redundant setups, where the status of the inactive connection must be updated along with the status of the active connection. The passed ConnectionStatusListener will be continually updated with master/independent and backup connection status every few seconds.
 - 
removeConnectionStatusListenervoid removeConnectionStatusListener(ConnectionStatusListener listener) 
 - 
triggerConnectionStatusListenersvoid triggerConnectionStatusListeners() Manually update the status of all connection listeners. Use this in situations where listeners need an immediate update without waiting for the normal thread task to fire (such as when first displaying a status panel).
 - 
getPlatformEditionjava.lang.String getPlatformEdition() Platform edition. Standard edition = "", Edge edition = "edge"
 - 
getEdgeProjectNamejava.lang.String getEdgeProjectName() throws GatewayException- Returns:
- the name of the Edge project as defined by the user on the edge gateway settings
- Throws:
- GatewayException
 
 - 
isPlatformLicensedboolean isPlatformLicensed() 
 
- 
 
-