Класс MulticastSocket

public class MulticastSocket
extends DatagramSocket

Класс сокета для мультиадресной передачи данных полезен для отправки и приема IP-пакетов с мультиадресной рассылкой. MulticastSocket представляет собой сокет DatagramSocket (UDP) с дополнительными возможностями для присоединения к «группам» других хостов с мультиадресной рассылкой в интернете.

Группа с мультиадресной рассылкой задается IP-адресом класса D и стандартным номером порта UDP. IP-адреса класса D находятся в диапазоне 224.0.0.0 до 239.255.255.255, включительно. Адрес 224.0.0.0 зарезервирован и не должен использоваться.

Для присоединения к группе с мультиадресной рассылкой сначала необходимо создать MulticastSocket с требуемым портом, а затем вызвать метод joinGroup(InetAddress groupAddr):

// join a Multicast group and send the group salutations
 ...
 String msg = "Hello";
 InetAddress group = InetAddress.getByName("228.5.6.7");
 MulticastSocket s = new MulticastSocket(6789);
 s.joinGroup(group);
 DatagramPacket hi = new DatagramPacket(msg.getBytes(), msg.length(),
                             group, 6789);
 s.send(hi);
 // get their responses!
 byte[] buf = new byte[1000];
 DatagramPacket recv = new DatagramPacket(buf, buf.length);
 s.receive(recv);
 ...
 // OK, I'm done talking - leave the group...
 s.leaveGroup(group);

Когда сообщение отправляется в группу с мультиадресной рассылкой, все подписчики этого хоста и порта получают сообщение (в пределах времени жизни пакета, см. ниже). Для отправки сообщений в группу сокет не обязан быть членом этой группы.

Когда сокет подписывается на группу с мультиадресной рассылкой/порт, он получает дейтаграммы, отправленные другими хостами в эту группу/порт, как и все остальные члены группы и порта. Сокет прекращает членство в группе с помощью метода leaveGroup(InetAddress addr). Несколько MulticastSocket могут одновременно подписываться на группу с мультиадресной рассылкой и порт, и все они будут получать дейтаграммы группы.

В настоящее время апплеты не могут использовать сокеты для мультиадресной рассылки.

Конструкторы

MulticastSocket

public MulticastSocket()
                throws IOException

Исключения:

IOException - если при создании MulticastSocket произошла ошибка ввода-вывода

SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.

См. также:

SecurityManager.checkListen(int), DatagramSocket.setReuseAddress(boolean)

MulticastSocket

public MulticastSocket(int port)
                throws IOException

Параметры:

port - порт для использования

Исключения:

IOException - если при создании MulticastSocket произошла ошибка ввода-вывода

SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.

См. также:

SecurityManager.checkListen(int), DatagramSocket.setReuseAddress(boolean)

MulticastSocket

public MulticastSocket(SocketAddress bindaddr)
                throws IOException

Параметры:

bindaddr - адрес сокета для привязки или null для свободного сокета.

Исключения:

IOException - если при создании MulticastSocket произошла ошибка ввода-вывода

SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.

С:

1.4

См. также:

SecurityManager.checkListen(int), DatagramSocket.setReuseAddress(boolean)

Методы

setTTL

@Deprecated
public void setTTL(byte ttl)
                        throws IOException

Устарело. Используйте метод setTimeToLive вместо него, который использует int вместо byte в качестве типа для ttl.

Параметры:

ttl - время жизни

Исключения:

IOException - если при установке значения времени жизни произошла ошибка ввода-вывода

См. также:

getTTL()

setTimeToLive

public void setTimeToLive(int ttl)
                   throws IOException

Параметры:

ttl - время жизни

Исключения:

IOException - если при установке значения времени жизни произошла ошибка ввода-вывода

См. также:

getTimeToLive()

getTTL

@Deprecated
public byte getTTL()
                        throws IOException

Устарело. Используйте метод getTimeToLive вместо него, который возвращает int вместо byte.

Получить значение времени жизни для мультикаст-пакетов, отправляемых через сокет.

Возвращает:

значение времени жизни

Исключения:

IOException - если при получении значения времени жизни произошла ошибка ввода-вывода

См. также:

setTTL(byte)

getTimeToLive

public int getTimeToLive()
                  throws IOException

Получить значение времени жизни для мультикаст-пакетов, отправляемых через сокет.

Возвращает:

значение времени жизни

Исключения:

IOException - если при получении значения времени жизни произошла ошибка ввода-вывода

См. также:

setTimeToLive(int)

joinGroup

public void joinGroup(InetAddress mcastaddr)
               throws IOException

Параметры:

mcastaddr - адрес мультикаст-группы для присоединения

Исключения:

IOException - если произошла ошибка присоединения или адрес не является адресом мультикаст-группы.

SecurityException - если менеджер безопасности существует и его метод checkMulticast не разрешает присоединение.

См. также:

SecurityManager.checkMulticast(InetAddress)

leaveGroup

public void leaveGroup(InetAddress mcastaddr)
                throws IOException

Параметры:

mcastaddr - адрес мультикаст-группы для выхода

Исключения:

IOException - если произошла ошибка выхода или адрес не является адресом мультикаст-группы.

SecurityException - если менеджер безопасности существует и его метод checkMulticast не разрешает операцию.

См. также:

SecurityManager.checkMulticast(InetAddress)

joinGroup

public void joinGroup(SocketAddress mcastaddr,
                      NetworkInterface netIf)
               throws IOException

Параметры:

mcastaddr - адрес мультикаст-группы для присоединения

netIf - задает локальный интерфейс для приема мультикаст-датаграмм, или null, чтобы использовать интерфейс, установленный методами setInterface(InetAddress) или setNetworkInterface(NetworkInterface)

Исключения:

IOException - если произошла ошибка присоединения или адрес не является адресом мультикаст-группы.

SecurityException - если менеджер безопасности существует и его метод checkMulticast не разрешает присоединение.

IllegalArgumentException - если mcastaddr равен null или является классом SocketAddress, не поддерживаемым данным сокетом

С:

1.4

См. также:

SecurityManager.checkMulticast(InetAddress)

leaveGroup

public void leaveGroup(SocketAddress mcastaddr,
                       NetworkInterface netIf)
                throws IOException

Параметры:

mcastaddr - адрес мультикаст-группы для выхода

netIf - задает локальный интерфейс или null, чтобы использовать интерфейс, установленный методами setInterface(InetAddress) или setNetworkInterface(NetworkInterface)

Исключения:

IOException - если произошла ошибка выхода или адрес не является адресом мультикаст-группы.

SecurityException - если менеджер безопасности существует и его метод checkMulticast не разрешает операцию.

IllegalArgumentException - если mcastaddr равен null или является классом SocketAddress, не поддерживаемым данным сокетом

С:

1.4

См. также:

SecurityManager.checkMulticast(InetAddress)

setInterface

public void setInterface(InetAddress inf)
                  throws SocketException

Установить мультикаст-сетевой интерфейс, используемый методами, поведение которых зависит от сетевого интерфейса. Полезно для хостов с несколькими интерфейсами.

Параметры:

inf - InetAddress

Исключения:

SocketException - если произошла ошибка в базовом протоколе, например, TCP ошибка.

См. также:

getInterface()

getInterface

public InetAddress getInterface()
                         throws SocketException

Получить адрес сетевого интерфейса, используемого для мультикаст-пакетов.

Возвращает:

InetAddress представляющий адрес сетевого интерфейса, используемого для мультикаст-пакетов.

Исключения:

SocketException - если произошла ошибка в базовом протоколе, например, TCP ошибка.

См. также:

setInterface(java.net.InetAddress)

setNetworkInterface

public void setNetworkInterface(NetworkInterface netIf)
                         throws SocketException

Указать сетевой интерфейс для исходящих мультикаст-датаграмм, отправляемых через этот сокет.

Параметры:

netIf - интерфейс

Исключения:

SocketException - если возникает ошибка в базовом протоколе, например, ошибка TCP.

С момента:

1.4

См. также:

getNetworkInterface()

getNetworkInterface

public NetworkInterface getNetworkInterface()
                                     throws SocketException

Получить установленный интерфейс мультиадресной сети.

Возвращает:

установленный в настоящее время мультиадресной NetworkInterface интерфейс

Исключения:

SocketException - если возникает ошибка в базовом протоколе, например, ошибка TCP.

С момента:

1.4

См. также:

setNetworkInterface(NetworkInterface)

setLoopbackMode

public void setLoopbackMode(boolean disable)
                     throws SocketException

Параметры:

disable - значение true, чтобы отключить режим LoopbackMode

Исключения:

SocketException - если при установке значения произошла ошибка

С момента:

1.4

См. также:

getLoopbackMode()

getLoopbackMode

public boolean getLoopbackMode()
                        throws SocketException

Получить настройку для локального циклического повторения мультиадресных датаграмм.

Возвращает:

true, если режим LoopbackMode отключен

Исключения:

SocketException - если при получении значения произошла ошибка

С момента:

1.4

См. также:

setLoopbackMode(boolean)

send

@Deprecated
public void send(DatagramPacket p,
                             byte ttl)
                      throws IOException

Устаревший. Используйте следующий код или его эквивалент вместо этого: ...... int ttl = mcastSocket.getTimeToLive(); mcastSocket.setTimeToLive(newttl); mcastSocket.send(p); mcastSocket.setTimeToLive(ttl); ......

Параметры:

p - пакет, который должен быть отправлен. Пакет должен содержать целевой мультиадресной IP-адрес и данные, которые нужно отправить. Для отправки пакетов на целевой мультиадресной адрес не требуется быть членом группы.

ttl - необязательное время жизни (TTL) для мультиадресного пакета. Значение TTL по умолчанию равно 1.

Исключения:

IOException - возникает, если произошла ошибка, например, при установке TTL.

SecurityException - если существует менеджер безопасности, и его метод checkMulticast или checkConnect не разрешает отправку.

См. также:

DatagramSocket.send(java.net.DatagramPacket), DatagramSocket.receive(java.net.DatagramPacket), SecurityManager.checkMulticast(java.net.InetAddress, byte), SecurityManager.checkConnect(java.lang.String, int)