org.netxms.api.client

Interface Session

public interface Session

Base client session interface. All client APIs for NetXMS based products expected to provide this interface.

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(SessionListener lst) Add notification listener
void	checkConnection() Send KEEPALIVE message.
void	connect() Connect to the server.
int	createMappingTable(java.lang.String name, java.lang.String description, int flags) Create new mapping table.
void	deleteMappingTable(int id) Delete mapping table
void	disconnect() Disconnect from server.
java.lang.String	getAttributeForCurrentUser(java.lang.String name) Get custom attribute for currently logged in user.
java.lang.String	getConnClientInfo()
java.lang.String	getDateFormat() Get default date format provided by server
MappingTable	getMappingTable(int id)
int	getRecvBufferSize() Get receiver buffer size.
java.lang.String	getServerAddress() Get server address
byte[]	getServerId() Get NetXMS server UID.
java.lang.String	getServerTimeZone()
java.lang.String	getServerVersion() Get NetXMS server version.
java.lang.String	getTimeFormat() Get default time format provided by server
int	getUserId() Get identifier of logged in user.
java.lang.String	getUserName() Get login name of currently logged in user
long	getUserSystemRights() Get system-wide rights of currently logged in user.
boolean	isConnected() Get connection state
boolean	isPasswordExpired()
java.util.List<MappingTableDescriptor>	listMappingTables() Get list of all configured mapping tables.
NXCPMessage	newMessage(int code) Create new NXCP message with unique id
void	removeListener(SessionListener lst) Remove notification listener
void	setAttributeForCurrentUser(java.lang.String name, java.lang.String value) Set custom attribute for currently logged in user.
void	setCommandTimeout(int commandTimeout) Set command execution timeout.
void	setConnClientInfo(java.lang.String connClientInfo)
void	setRecvBufferSize(int recvBufferSize) Set receiver buffer size.
int	updateMappingTable(MappingTable table) Create or update mapping table.
NXCPMessage	waitForMessage(int code, long id) Wait for message with specific code and id.
NXCPMessage	waitForMessage(int code, long id, int timeout) Wait for message with specific code and id.
NXCPMessage	waitForRCC(long id) Wait for CMD_REQUEST_COMPLETED message with given id using default timeout
NXCPMessage	waitForRCC(long id, int timeout) Wait for CMD_REQUEST_COMPLETED message with given id

Method Detail

addListener

void addListener(SessionListener lst)

Add notification listener

Parameters:

lst - Listener to add

removeListener

void removeListener(SessionListener lst)

Remove notification listener

Parameters:

lst - Listener to remove

waitForMessage

NXCPMessage waitForMessage(int code,
                         long id,
                         int timeout)
                           throws NetXMSClientException

Wait for message with specific code and id.

Parameters:

code - Message code

id - Message id

timeout - Wait timeout in milliseconds

Returns:

Message object

Throws:

NetXMSClientException - if message was not arrived within timeout interval

waitForMessage

NXCPMessage waitForMessage(int code,
                         long id)
                           throws NetXMSClientException

Wait for message with specific code and id.

Parameters:

code - Message code

id - Message id

Returns:

Message object

Throws:

NetXMSClientException - if message was not arrived within timeout interval

waitForRCC

NXCPMessage waitForRCC(long id)
                       throws NetXMSClientException

Wait for CMD_REQUEST_COMPLETED message with given id using default timeout

Parameters:

id - Message id

Returns:

received message

Throws:

NetXMSClientException - if message was not arrived within timeout interval or contains RCC other than RCC.SUCCESS

waitForRCC

NXCPMessage waitForRCC(long id,
                     int timeout)
                       throws NetXMSClientException

Wait for CMD_REQUEST_COMPLETED message with given id

Parameters:

id - Message id

timeout - Timeout in milliseconds

Returns:

received message

Throws:

NetXMSClientException - if message was not arrived within timeout interval or contains RCC other than RCC.SUCCESS

newMessage

NXCPMessage newMessage(int code)

Create new NXCP message with unique id

Parameters:

code - Message code

Returns:

New message object

connect

void connect()
             throws java.io.IOException,
                    java.net.UnknownHostException,
                    NetXMSClientException

Connect to the server.

Throws:

java.io.IOException

java.net.UnknownHostException

NetXMSClientException

disconnect

void disconnect()

Disconnect from server.

getRecvBufferSize

int getRecvBufferSize()

Get receiver buffer size.

Returns:

Current receiver buffer size in bytes.

setRecvBufferSize

void setRecvBufferSize(int recvBufferSize)

Set receiver buffer size. This method should be called before connect(). It will not have any effect after connect().

Parameters:

recvBufferSize - Size of receiver buffer in bytes.

getServerAddress

java.lang.String getServerAddress()

Get server address

Returns:

Server address

getUserName

java.lang.String getUserName()

Get login name of currently logged in user

Returns:

login name of currently logged in user

getServerVersion

java.lang.String getServerVersion()

Get NetXMS server version.

Returns:

Server version

getServerId

byte[] getServerId()

Get NetXMS server UID.

Returns:

Server UID

getServerTimeZone

java.lang.String getServerTimeZone()

Returns:

the serverTimeZone

getConnClientInfo

java.lang.String getConnClientInfo()

Returns:

the connClientInfo

setConnClientInfo

void setConnClientInfo(java.lang.String connClientInfo)

Parameters:

connClientInfo - the connClientInfo to set

setCommandTimeout

void setCommandTimeout(int commandTimeout)

Set command execution timeout.

Parameters:

commandTimeout - New command timeout

getUserId

int getUserId()

Get identifier of logged in user.

Returns:

Identifier of logged in user

getUserSystemRights

long getUserSystemRights()

Get system-wide rights of currently logged in user.

Returns:

System-wide rights of currently logged in user

isPasswordExpired

boolean isPasswordExpired()

Returns:

the passwordExpired

setAttributeForCurrentUser

void setAttributeForCurrentUser(java.lang.String name,
                              java.lang.String value)
                                throws java.io.IOException,
                                       NetXMSClientException

Set custom attribute for currently logged in user. Server will allow to change only attributes whose name starts with dot.

Parameters:

name - Attribute's name

value - New attribute's value

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

getAttributeForCurrentUser

java.lang.String getAttributeForCurrentUser(java.lang.String name)
                                            throws java.io.IOException,
                                                   NetXMSClientException

Get custom attribute for currently logged in user. If attribute is not set, empty string will be returned.

Parameters:

name - Attribute's name

Returns:

Attribute's value

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

isConnected

boolean isConnected()

Get connection state

Returns:

connection state

checkConnection

void checkConnection()
                     throws java.io.IOException,
                            NetXMSClientException

Send KEEPALIVE message. Return nothing is connection is fine, exception thrown otherwise

Throws:

java.io.IOException

NXCException

NetXMSClientException

getDateFormat

java.lang.String getDateFormat()

Get default date format provided by server

Returns:

getTimeFormat

java.lang.String getTimeFormat()

Get default time format provided by server

Returns:

listMappingTables

java.util.List<MappingTableDescriptor> listMappingTables()
                                                         throws java.io.IOException,
                                                                NetXMSClientException

Get list of all configured mapping tables.

Returns:

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

getMappingTable

MappingTable getMappingTable(int id)
                             throws java.io.IOException,
                                    NetXMSClientException

Parameters:

id -

Returns:

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

createMappingTable

int createMappingTable(java.lang.String name,
                     java.lang.String description,
                     int flags)
                       throws java.io.IOException,
                              NetXMSClientException

Create new mapping table.

Parameters:

name - name of new table

description - description for new table

flags - flags for new table

Returns:

ID of new table object

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

updateMappingTable

int updateMappingTable(MappingTable table)
                       throws java.io.IOException,
                              NetXMSClientException

Create or update mapping table. If table ID is 0, new table will be created on server.

Parameters:

table - mapping table

Returns:

ID of new table object

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out

deleteMappingTable

void deleteMappingTable(int id)
                        throws java.io.IOException,
                               NetXMSClientException

Delete mapping table

Parameters:

id - mapping table ID

Throws:

java.io.IOException - if socket I/O error occurs

NetXMSClientException - if NetXMS server returns an error or operation was timed out