The character set used to encode and decode strings. Unfortunately, this has not been specified in the OSC standard. We recommend to either restrict characters to 7-bit ascii range or to use UTF-8. The default implementation initially uses UTF-8.

Creates a new packet decoded from the ByteBuffer. This method tries to read a null terminated string at the beginning of the provided buffer. If it equals the bundle identifier, the decode of Bundle is called (which may recursively decode nested bundles), otherwise the one from Message.

This method is final. For messages encountered, decodeMessage is called, , thus for implementations of PacketCodec, it is sufficient to overwrite decodeMessage.

Decodes a message with a given name and buffer holding its arguments.

Implementations should be careful to catch potential instances of BufferUnderflowException or other runtime exception such as IllegalArgumentException and cast them into instances of PacketCodec.Exception, such that the caller can be safe to catch any error by matching against PacketCodec.Exception.

Encodes the given bundle into the provided ByteBuffer, beginning at the buffer's current position. To write the encoded packet, you will typically call flip() on the buffer, then write() on the channel.

Encodes the message onto the given ByteBuffer, beginning at the buffer's current position. To write the encoded message, you will typically call flip() on the buffer, then write() on the channel.

Calculates the byte size of the encoded bundle. This method is final. The size is the sum of the bundle name, its time-tag and the sizes of each bundle element.

For contained messages, encodedMessageSize will be called, thus for implementations of PacketCodec, it is sufficient to overwrite encodedMessageSize.

Calculates the byte size of the encoded message

Prints a textual representation of the given atom to the given print stream. Implementations should use the atom encoder suitable for the given value.