org.netxms.client.log
Class Log

java.lang.Object
  org.netxms.client.log.Log

public class Log
extends java.lang.Object

Log handle for accessing log on management server

Author:

Victor Kirhenshtein

Constructor Summary

Log(NXCSession session, NXCPMessage msg)
Create log object from server's reply to CMD_LOG_OPEN.

Method Summary

void	close() Close log
protected void	finalize()
java.lang.String	getColumnDescription(java.lang.String columnName) Get description for given column name.
java.util.Collection<LogColumn>	getColumns() Get column information
java.lang.String	getName() Get log name.
long	getNumRecords() Get number of records available on server after successful query() call.
void	query(LogFilter filter) Send query to server
Table	retrieveData(long startRow, long rowCount) Retrieve log data from server.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Log

public Log(NXCSession session,
           NXCPMessage msg)

Create log object from server's reply to CMD_LOG_OPEN.

Parameters:

session - Client session

msg - NXCP message with server's reply

Method Detail

getName

public java.lang.String getName()

Get log name.

Returns:

Log name

getColumns

public java.util.Collection<LogColumn> getColumns()

Get column information

Returns:

the columns

getColumnDescription

public java.lang.String getColumnDescription(java.lang.String columnName)

Get description for given column name.

Parameters:

columnName - Column name

Returns:

Column description

query

public void query(LogFilter filter)
           throws java.io.IOException,
                  NXCException

Send query to server

Parameters:

filter - Log filter

Throws:

java.io.IOException

NXCException

retrieveData

public Table retrieveData(long startRow,
                          long rowCount)
                   throws java.io.IOException,
                          NXCException

Retrieve log data from server. You must first call query() to prepare data on server.

Parameters:

startRow -

rowCount -

Returns:

Throws:

java.io.IOException

NXCException

getNumRecords

public long getNumRecords()

Get number of records available on server after successful query() call.

Returns:

Number of log records available

close

public void close()
           throws java.io.IOException,
                  NXCException

Close log

Throws:

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

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

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object