com.sun.jini.discovery
Interface MulticastAnnouncementEncoder

All Superinterfaces:

DiscoveryFormatProvider

All Known Implementing Classes:

Server, X500Server

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 Summary

void

encodeMulticastAnnouncement(MulticastAnnouncement announcement, DatagramBufferFactory bufs, InvocationConstraints constraints) 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.

Methods inherited from interface com.sun.jini.discovery.DiscoveryFormatProvider

getFormatName

Method Detail

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