org.altlinux.jabbix

Class JabbixReader

java.lang.Object

org.altlinux.jabbix.JabbixReader

public class JabbixReader
extends java.lang.Object

Объект, инкапсулирующий процесс чтения из канала, и реализующий базовый протокол Jabbix.

Constructor Summary

Constructors

Constructor and Description
JabbixReader(java.io.InputStream in) Создаёт объект, инкапсулирующий процесс чтения из указанного входного канала.

Method Summary

Modifier and Type	Method and Description
java.lang.String	readAll() Читает из канала все имеющиеся данные
java.lang.String	readMessage() Читает сообщение из входного канала.
java.lang.String	readMessage(boolean untilEOF) Читает сообщение из входного канала.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JabbixReader

public JabbixReader(java.io.InputStream in)

Создаёт объект, инкапсулирующий процесс чтения из указанного входного канала.

Parameters:

in - канал для чтения

Method Detail

readMessage

public java.lang.String readMessage(boolean untilEOF)
                             throws java.io.IOException,
                                    JabbixProtocolException

Читает сообщение из входного канала. Если принимаемое сообщение составлено по протоколу Zabbix, то его длина определяется из заголовка. Иначе делается предположение о том, что конец сообщения будет обозначен символом-разделителем (см. JabbixProtocol.isSeparator(char)). Если указан флаг untilEOF, то в этом случае все имеющиеся в канале данные будут прочитаны и возвращены как единое сообщение.

Parameters:

untilEOF - флаг, уазывающий читать все имеющиеся данные

Returns:

сообщение

Throws:

java.io.IOException - если во время операции чтения возникло исключение ввода-вывода

JabbixProtocolException - если протокол был нарушен (т.е. было принято неожиданное значение)

See Also:

JabbixProtocol.HEADER

readMessage

public java.lang.String readMessage()
                             throws java.io.IOException,
                                    JabbixProtocolException

Читает сообщение из входного канала. Длина сообщения либо указана явно в заголовке, либо определяется на основании положения символа-разделителя внутри сообщения (см. JabbixProtocol.isSeparator(char)).

Returns:

сообщение

Throws:

java.io.IOException - если во время операции чтения возникло исключение ввода-вывода

JabbixProtocolException - если протокол был нарушен (т.е. было принято неожиданное значение)

See Also:

JabbixReader.readMessage(boolean)

readAll

public java.lang.String readAll()
                         throws java.io.IOException,
                                JabbixProtocolException

Читает из канала все имеющиеся данные

Returns:

сообщение, содержащее все прочитанные данные

Throws:

java.io.IOException - если во время операции чтения возникло исключение ввода-вывода

JabbixProtocolException - если протокол был нарушен (т.е. было принято неожиданное значение)

See Also:

JabbixReader.readMessage(boolean)