com.sun.jini.discovery
Class MulticastRequest

java.lang.Object
  com.sun.jini.discovery.MulticastRequest

public class MulticastRequest
extends Object

Class representing the values in a multicast request.

Since:

2.0

Author:

Sun Microsystems, Inc.

Field Summary

protected String[]	groups The groups of interest.
protected String	host The client host.
protected int	port The client listen port.
protected ServiceID[]	serviceIDs The IDs of known lookup services.

Constructor Summary

MulticastRequest(String host, int port, String[] groups, ServiceID[] serviceIDs)
Creates a new MulticastRequest instance containing the given values.

Method Summary

void	checkConstraints() Checks if the constraints whose checking was delayed when this instance was decoded, if any, are satisfied.
String[]	getGroups() Returns the groups targeted by the request.
String	getHost() Returns the client host name.
int	getPort() Returns the client listen port.
ServiceID[]	getServiceIDs() Returns the service IDs of known lookup services.
String	toString() Returns string representation of this request.

Methods inherited from class java.lang.Object

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

Field Detail

host

protected String host

The client host.

port

protected int port

The client listen port.

groups

protected String[] groups

The groups of interest.

serviceIDs

protected ServiceID[] serviceIDs

The IDs of known lookup services.

Constructor Detail

MulticastRequest

public MulticastRequest(String host,
                        int port,
                        String[] groups,
                        ServiceID[] serviceIDs)

Creates a new MulticastRequest instance containing the given values. Arrays are copied; null array values are considered equivalent to empty arrays.

Parameters:

host - the client host

port - the client listen port

groups - the groups of interest

serviceIDs - the IDs of known lookup services

Throws:

NullPointerException - if host is null, or if groups or serviceIDs contains null

IllegalArgumentException - if port is out of range

Method Detail

getHost

public String getHost()

Returns the client host name.

Returns:

the client host name

getPort

public int getPort()

Returns the client listen port.

Returns:

the client listen port

getGroups

public String[] getGroups()

Returns the groups targeted by the request.

Returns:

the groups targeted by the request

getServiceIDs

public ServiceID[] getServiceIDs()

Returns the service IDs of known lookup services.

Returns:

the service IDs of known lookup services

checkConstraints

public void checkConstraints()
                      throws IOException

Checks if the constraints whose checking was delayed when this instance was decoded, if any, are satisfied. If the instance was not decoded, but directly constructed, this method does nothing.

Throws:

UnsupportedConstraintException - if unable to satisfy the specified constraints

SecurityException - if the given constraints cannot be satisfied due to insufficient caller permissions, or if the client subject check fails

IOException - if an error occurs in interpreting the data

toString

public String toString()

Returns string representation of this request.

Overrides:

toString in class Object

Returns:

string representation of this request