java.net
클래스 MulticastSocket

java.lang.Object 
  java.net.DatagramSocket 
      java.net.MulticastSocket

public class MulticastSocket
extends DatagramSocket 

멀티 캐스트 데이터 그램 소켓 클래스는 IP 멀티 캐스트 패킷을 송수신 할 경우에 도움이 됩니다. MulticastSocket는 인터넷상외의 멀티 캐스트 호스트의 「그룹」에 참가하는 추가 기능을 가지는 (UDP) DatagramSocket 입니다.

멀티 캐스트 그룹은 클래스 D IP 주소 및 표준 UDP 포트 번호에 의해 지정됩니다. 클래스 D IP 주소의 범위는 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는 모두 같은 그룹 데이터 그램을 수신합니다.

현재로서는 애플릿에서는 멀티 캐스트 소켓을 사용할 수 없습니다.

도입된 버전 :

JDK1. 1

생성자 개요

MulticastSocket ()
멀티 캐스트 소켓을 작성합니다.

MulticastSocket (int port)
특정의 포트에 바인드 된 멀티 캐스트 소켓을 작성합니다.

MulticastSocket (SocketAddress bindaddr)
지정된 소켓 주소에 바인드 된 MulticastSocket를 작성합니다.

메서드 개요

InetAddress	getInterface () 멀티 캐스트 패킷에 사용하는 네트워크 인터페이스의 주소를 취득합니다.
boolean	getLoopbackMode () 멀티 캐스트 데이터 그램의 로컬 루프백의 설정치를 취득합니다.
NetworkInterface	getNetworkInterface () 멀티 캐스트 네트워크 인터페이스 세트를 취득합니다.
int	getTimeToLive () 이 소켓으로부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 취득합니다.
byte	getTTL () 추천하지 않습니다. 대신에 byte는 아니고 int를 돌려주는 getTimeToLive 메서드를 사용합니다.
void	joinGroup (InetAddress mcastaddr) 멀티 캐스트 그룹에 참가합니다.
void	joinGroup (SocketAddress mcastaddr, NetworkInterface netIf) 지정된 인터페이스로 지정된 멀티 캐스트 그룹에 참가합니다.
void	leaveGroup (InetAddress mcastaddr) 멀티 캐스트 그룹으로부터 멀어집니다.
void	leaveGroup (SocketAddress mcastaddr, NetworkInterface netIf) 지정된 로컬 인터페이스상의 멀티 캐스트 그룹으로부터 멀어집니다.
void	send (DatagramPacket p, byte ttl) 추천하지 않습니다. 다음의 코드 또는 그것과 동등의 코드를 사용한다: ...... int ttl = mcastSocket.getTimeToLive(); mcastSocket.setTimeToLive(newttl); mcastSocket.send(p); mcastSocket.setTimeToLive(ttl); ......
void	setInterface (InetAddress inf) 네트워크 인터페이스의 값에 의해 그 동작이 영향을 받는 메서드가 사용하는 멀티 캐스트 네트워크 인터페이스를 설정합니다.
void	setLoopbackMode (boolean disable) 멀티 캐스트 데이터 그램의 로컬 루프백을 유효 또는 무효로 합니다.
void	setNetworkInterface (NetworkInterface netIf) 이 소켓으로부터 송신되는 송출 멀티 캐스트 데이터 그램용의 네트워크 인터페이스를 지정합니다.
void	setTimeToLive (int ttl) 멀티 캐스트의 스코프를 제어하기 위해서 이 MulticastSocket로 부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 설정합니다.
void	setTTL (byte ttl) 추천하지 않습니다. 대신에 ttl 형태로서 byte는 아니고 int를 사용하는 setTimeToLive 메서드를 사용합니다.

클래스 java.net. DatagramSocket 로부터 상속된 메서드

bind, close, connect, connect, disconnect, getBroadcast, getChannel, getInetAddress, getLocalAddress, getLocalPort, getLocalSocketAddress, getPort, getReceiveBufferSize, getRemoteSocketAddress, getReuseAddress, getSendBufferSize, getSoTimeout, getTrafficClass, isBound, isClosed, isConnected, receive, send, setBroadcast, setDatagramSocketImplFactory, setReceiveBufferSize, setReuseAddress, setSendBufferSize, setSoTimeout, setTrafficClass

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

MulticastSocket

public MulticastSocket()
                throws IOException 

멀티 캐스트 소켓을 작성합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkListen가 인수로서 0을 지정해 불려가 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

소켓이 작성되면, DatagramSocket.setReuseAddress(boolean) 메서드가 불려가 SO_REUSEADDR 소켓 옵션이 유효하게 됩니다.

예외:

IOException - MulticastSocket 생성중에 입출력 예외가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkListen 메서드가 이 조작을 허가하지 않는 경우

관련 항목:

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

MulticastSocket

public MulticastSocket(int port)
                throws IOException 

특정의 포트에 바인드 된 멀티 캐스트 소켓을 작성합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkListen 메서드가 인수로서 port를 지정해 불려가 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

소켓이 작성되면, DatagramSocket.setReuseAddress(boolean) 메서드가 불려가 SO_REUSEADDR 소켓 옵션이 유효하게 됩니다.

파라미터:

port - 사용하는 포트

예외:

IOException - MulticastSocket 생성중에 입출력 예외가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkListen 메서드가 이 조작을 허가하지 않는 경우

관련 항목:

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

MulticastSocket

public MulticastSocket(SocketAddress  bindaddr)
                throws IOException 

지정된 소켓 주소에 바인드 된 MulticastSocket를 작성합니다.

혹은 주소가 null인 경우는 안 바운드의 소켓을 작성합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkListen 메서드가 인수로서 SocketAddress 포트를 지정해 불려가 이 조작이 허가되고 있는 것을 확인합니다. 이 결과, SecurityException가 되는 일이 있습니다.

소켓이 작성되면, DatagramSocket.setReuseAddress(boolean) 메서드가 불려가 SO_REUSEADDR 소켓 옵션이 유효하게 됩니다.

파라미터:

bindaddr - 바인드 하는 소켓 주소. 안 바운드의 소켓의 경우는 null

예외:

IOException - MulticastSocket 생성중에 입출력 예외가 발생했을 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkListen 메서드가 이 조작을 허가하지 않는 경우

도입된 버전 :

1.4

관련 항목:

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

메서드의 상세

setTTL

@Deprecated 
public void setTTL(byte ttl)
            throws IOException 

추천하지 않습니다. 대신에 ttl 형태로서 byte는 아니고 int를 사용하는 setTimeToLive 메서드를 사용합니다.

멀티 캐스트의 스코프를 제어하기 위해서 이 MulticastSocket로 부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 설정합니다.

ttl는 부호 없음 8 비트 데이터이므로0 <= ttl <= 0xFF 범위가아니면 안됩니다.

파라미터:

ttl - 유효기간

예외:

IOException - 디폴트의 유효기간치를 설정중에 입출력 예외가 발생했을 경우

관련 항목:

getTTL()

setTimeToLive

public void setTimeToLive(int ttl)
                   throws IOException 

멀티 캐스트의 스코프를 제어하기 위해서 이 MulticastSocket로 부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 설정합니다.

ttl 범위는 0 <= ttl <= 255가 아니면 안됩니다. 그렇지 않은 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

ttl - 유효기간

예외:

IOException - 디폴트의 유효기간치를 설정중에 입출력 예외가 발생했을 경우

관련 항목:

getTimeToLive()

getTTL

@Deprecated 
public byte getTTL()
            throws IOException 

추천하지 않습니다. 대신에 byte는 아니고 int를 돌려주는 getTimeToLive 메서드를 사용합니다.

이 소켓으로부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 취득합니다.

반환값:

디폴트의 유효기간치

예외:

IOException - 디폴트의 유효기간치를 취득중에 입출력 예외가 발생했을 경우

관련 항목:

setTTL(byte)

getTimeToLive

public int getTimeToLive()
                  throws IOException 

이 소켓으로부터 송신되는 멀티 캐스트 패킷의 디폴트의 유효기간을 취득합니다.

반환값:

디폴트의 유효기간치

예외:

IOException - 디폴트의 유효기간치를 취득중에 입출력 예외가 발생했을 경우

관련 항목:

setTimeToLive(int)

joinGroup

public void joinGroup(InetAddress  mcastaddr)
               throws IOException 

멀티 캐스트 그룹에 참가합니다. 동작은 setInterface 또는 setNetworkInterface 영향을 받는 일이 있습니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkMulticast 메서드가 인수로서 mcastaddr를 지정해 호출합니다.

파라미터:

mcastaddr - 참가하는 멀티 캐스트 주소

예외:

IOException - 참가에 에러가 있는지, 주소가 멀티 캐스트 주소가 아닌 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkMulticast 메서드가 참가를 허가하지 않는 경우

관련 항목:

SecurityManager.checkMulticast(InetAddress)

leaveGroup

public void leaveGroup(InetAddress  mcastaddr)
                throws IOException 

멀티 캐스트 그룹으로부터 멀어집니다. 동작은 setInterface 또는 setNetworkInterface 영향을 받는 일이 있습니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkMulticast 메서드가 인수로서 mcastaddr를 지정해 호출합니다.

파라미터:

mcastaddr - 떨어지는 멀티 캐스트 주소

예외:

IOException - 에러가 남아 있는지, 주소가 멀티 캐스트 주소가 아닌 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkMulticast 메서드가 이 조작을 허가하지 않는 경우

관련 항목:

SecurityManager.checkMulticast(InetAddress)

joinGroup

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

지정된 인터페이스로 지정된 멀티 캐스트 그룹에 참가합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkMulticast 메서드가 인수로서 mcastaddr를 지정해 호출합니다.

파라미터:

mcastaddr - 참가하는 멀티 캐스트 주소

netIf - 멀티 캐스트 데이터 그램 패킷을 수신하는 로컬 인터페이스를 지정한다. setInterface(InetAddress) 또는 setNetworkInterface(NetworkInterface) 에 의해 설정된 인터페이스에 따르는 경우는 null

예외:

IOException - 참가에 에러가 있는지, 주소가 멀티 캐스트 주소가 아닌 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkMulticast 메서드가 참가를 허가하지 않는 경우

IllegalArgumentException - mcastaddr가 null 인 경우, 또는 주소가 이 소켓으로 지원 되어 있지 않은 SocketAddress 서브 클래스인 경우

도입된 버전 :

1.4

관련 항목:

SecurityManager.checkMulticast(InetAddress)

leaveGroup

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

지정된 로컬 인터페이스상의 멀티 캐스트 그룹으로부터 멀어집니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkMulticast 메서드가 인수로서 mcastaddr를 지정해 호출합니다.

파라미터:

mcastaddr - 떨어지는 멀티 캐스트 주소

netIf - 로컬 인터페이스를 지정한다. setInterface(InetAddress) 또는 setNetworkInterface(NetworkInterface) 에 의해 설정된 인터페이스에 따르는 경우는 null

예외:

IOException - 에러가 남아 있는지, 주소가 멀티 캐스트 주소가 아닌 경우

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkMulticast 메서드가 이 조작을 허가하지 않는 경우

IllegalArgumentException - mcastaddr가 null 인 경우, 또는 주소가 이 소켓으로 지원 되어 있지 않은 SocketAddress 서브 클래스인 경우

도입된 버전 :

1.4

관련 항목:

SecurityManager.checkMulticast(InetAddress)

setInterface

public void setInterface(InetAddress  inf)
                  throws SocketException 

네트워크 인터페이스의 값에 의해 그 동작이 영향을 받는 메서드가 사용하는 멀티 캐스트 네트워크 인터페이스를 설정합니다. multi-homed의 호스트에게 편리합니다.

파라미터:

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 

멀티 캐스트 데이터 그램의 로컬 루프백을 유효 또는 무효로 합니다. 이 옵션은 멀티 캐스트 데이터를 로컬 소켓에 루프백 할지 어떨지를 설정하는 힌트로서 플랫폼의 네트워크 코드가 사용합니다.

이 옵션은 힌트이므로 어플리케이션으로 루프 백 모드의 설정을 조사할 필요가 있는 경우는 getLoopbackMode()를 호출해 주세요.

파라미터:

disable - LoopbackMode를 무효로 하는 경우는 true

예외:

SocketException - 치의 설정중에 에러가 발생했을 경우

도입된 버전 :

1.4

관련 항목:

getLoopbackMode()

getLoopbackMode

public boolean getLoopbackMode()
                        throws SocketException 

멀티 캐스트 데이터 그램의 로컬 루프백의 설정치를 취득합니다.

반환값:

LoopbackMode가 무효가 되었을 경우는 true

예외:

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); ......

그 소켓의 기본값 이외의 TTL (유효기간)를 사용해, 데이터 그램 패킷을 행선지에 송신합니다. 이 메서드는 특정의 TTL를 지정할 필요가 있는 경우에만 사용합니다. 그 외의 경우는 그 소켓의 TTL를 일단 설정해, 모든 패킷에 그 TTL 기본값을 사용하는 것이 이상적입니다. 이 메서드는 소켓의 TTL 기본값을 변경하지 않습니다. 동작은 setInterface 영향을 받는 일이 있습니다.

시큐러티 매니저가 존재하는 경우, 이 메서드는 최초로 어떠한 시큐러티 체크를 실행합니다. p.getAddress(). isMulticastAddress()가 true 이면, 이 메서드는 최초로 시큐러티 매니저의 checkMulticast 메서드를, 인수로서 p.getAddress() 및 ttl를 지정해 호출합니다. 상기의 식의 결과가 false 인 경우, 이 메서드는 대신에 시큐러티 매니저의 checkConnect 메서드를, 인수로서 p.getAddress(). getHostAddress() 및 p.getPort()를 지정해 호출합니다. 이 조작이 허가되어 있지 않은 경우, 시큐러티 매니저의 각 메서드 호출의 결과는 SecurityException가 되는 일이 있습니다.

파라미터:

p - 송신하는 패킷. 패킷에는 행선지 멀티 캐스트 IP 주소와 송신 데이터가 포함된다. 행선지 멀티 캐스트 주소에 패킷을 송신하기 위해서는 그 그룹의 멤버일 필요는 없는

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)