Interface MulticastAnnouncementEncoder

All Superinterfaces:
DiscoveryFormatProvider
All Known Implementing Classes:
Server

public interface MulticastAnnouncementEncoder extends DiscoveryFormatProvider
Interface implemented by classes which encode multicast announcement data according to discovery protocol formats.
Since:
2.0
Author:
Sun Microsystems, Inc.
  • Method Details

    • encodeMulticastAnnouncement

      void encodeMulticastAnnouncement(MulticastAnnouncement announcement, DatagramBufferFactory bufs, InvocationConstraints constraints) throws IOException
      Encodes the given multicast announcement data into byte buffers obtained from the provided datagram buffer factory, in a manner that satisfies the specified absolute constraints. null constraints are considered equivalent to empty constraints. Multicast announcement data that is too large to fit in a single datagram buffer is split across multiple buffers, with the constraints applied to each; this method is responsible for determining if and when to split the data based on the available space in the obtained buffers.
      Parameters:
      announcement - the announcement data to encode
      bufs - the factory for producing buffers in which to write encoded data
      constraints - the constraints to apply when encoding the data, or null
      Throws:
      IOException - if an error occurs in encoding the data to send
      UnsupportedConstraintException - if unable to satisfy the specified constraints
      SecurityException - if the given constraints cannot be satisfied due to insufficient caller permissions
      NullPointerException - if announcement or bufs is null