java.net
클래스 DatagramPacket

java.lang.Object 
  |
  +--java.net.DatagramPacket

public final class DatagramPacket

extends Object

이 클래스는 데이터 그램 패킷을 나타냅니다.

데이터 그램 패킷은 무접속 패킷 배포 서비스를 구현할 때에 사용합니다. 각 메세지는 패킷내에 포함되어 있는 정보만을 기본으로, 어느 머신으로부터 다른 머신에 송신됩니다. 어느 머신으로부터 다른 머신에 복수의 패킷을 송신하는 경우, 각 패킷은 다른 경로에서 송신될 가능성이 있어, 행선지에는 무작위의 순서로 도달할 가능성이 있습니다. 패킷 전달은 프로텍션되지 않습니다.

도입된 버젼:

JDK1. 0

생성자의 개요

DatagramPacket (byte[] buf, int length)
길이가 length 의 패킷을 수신하기 위한 DatagramPacket 를 구축합니다.

DatagramPacket (byte[] buf, int length, InetAddress address, int port)
지정된 호스트의 지정된 포토 번호에 길이 length 의 패킷을 송신하기 위한 , 데이터 그램 패킷을 구축합니다.

DatagramPacket (byte[] buf, int offset, int length)
버퍼에의 오프셋(offset)를 지정해, 길이가 length 의 패킷을 수신하기 위한 DatagramPacket 를 구축합니다.

DatagramPacket (byte[] buf, int offset, int length, InetAddress address, int port)
길이가 length 로 오프셋(offset)가 ioffset 의 패킷을, 지정된 호스트의 지정된 포토 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다.

DatagramPacket (byte[] buf, int offset, int length, SocketAddress address)
길이가 length 로 오프셋(offset)가 ioffset 의 패킷을, 지정된 호스트의 지정된 포토 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다.

DatagramPacket (byte[] buf, int length, SocketAddress address)
지정된 호스트의 지정된 포토 번호에 길이 length 의 패킷을 송신하기 위한 , 데이터 그램 패킷을 구축합니다.

메소드의 개요

InetAddress	getAddress () 이 데이터 그램의 송신지인 머신, 또는 데이터 그램의 송신원인 머신의 IP 주소를 돌려줍니다.
byte[]	getData () 데이터 버퍼를 돌려줍니다.
int	getLength () 송신하는 데이터의 길이, 또는 수신한 데이터의 길이를 돌려줍니다.
int	getOffset () 송신하는 데이터의 오프셋(offset), 또는 수신한 데이터의 오프셋(offset)를 돌려줍니다.
int	getPort () 이 데이터 그램의 송신지 또는 데이터 그램의 송신원의, 리모트 호스트상의 포토 번호를 돌려줍니다.
SocketAddress	getSocketAddress () 이 패킷의 송신지 또는 송신원인 리모트 호스트의 SocketAddress (통상은 IP 주소 + 포토 번호)를 취득합니다.
void	setAddress (InetAddress iaddr) 이 데이터 그램의 송신지인 머신의 IP 주소를 설정합니다.
void	setData (byte[] buf) 이 패킷용의 데이터 버퍼를 설정합니다.
void	setData (byte[] buf, int offset, int length) 이 패킷용의 데이터 버퍼를 설정합니다.
void	setLength (int length) 이 패킷의 길이를 설정합니다.
void	setPort (int iport) 이 데이터 그램의 송신지인 리모트 호스트의 포토 번호를 설정합니다.
void	setSocketAddress (SocketAddress address) 이 데이터 그램의 송신지인 리모트 호스트의 SocketAddress (통상은 IP 주소 + 포토 번호)를 설정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length)

버퍼에의 오프셋(offset)를 지정해, 길이가 length 의 패킷을 수신하기 위한 DatagramPacket 를 구축합니다.

인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 착신 데이터 그램을 보관 유지하기 위한 버퍼

offset - 버퍼에의 오프셋(offset)

length - 읽어들이는 바이트수

도입된 버젼:

JDK1. 2

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length)

길이가 length 의 패킷을 수신하기 위한 DatagramPacket 를 구축합니다.

인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 착신 데이터 그램을 보관 유지하기 위한 버퍼

length - 읽어들이는 바이트수

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      InetAddress  address,
                      int port)

길이가 length 로 오프셋(offset)가 ioffset 의 패킷을, 지정된 호스트의 지정된 포토 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다. 인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 패킷 데이터

offset - 패킷 데이터의 오프셋(offset)

length - 패킷 데이터의 길이

address - 전송처 주소

port - 전송처 포토 번호

도입된 버젼:

JDK1. 2

관련 항목:

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      SocketAddress  address)
               throws SocketException 

길이가 length 로 오프셋(offset)가 ioffset 의 패킷을, 지정된 호스트의 지정된 포토 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다. 인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 패킷 데이터

offset - 패킷 데이터의 오프셋(offset)

length - 패킷 데이터의 길이

address - 전송처 소켓 주소

예외:

SocketException - 주소형이 서포트되어 있지 않은 경우

도입된 버젼:

1.4

관련 항목:

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      InetAddress  address,
                      int port)

지정된 호스트의 지정된 포토 번호에 길이 length 의 패킷을 송신하기 위한 , 데이터 그램 패킷을 구축합니다. 인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 패킷 데이터

length - 패킷의 길이

address - 전송처 주소

port - 전송처 포토 번호

관련 항목:

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      SocketAddress  address)
               throws SocketException 

지정된 호스트의 지정된 포토 번호에 길이 length 의 패킷을 송신하기 위한 , 데이터 그램 패킷을 구축합니다. 인수 length 의 값은 buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 패킷 데이터

length - 패킷의 길이

address - 전송처 주소

예외:

SocketException - 주소형이 서포트되어 있지 않은 경우

도입된 버젼:

1.4

관련 항목:

InetAddress

메소드의 상세

getAddress

public InetAddress  getAddress()

이 데이터 그램의 송신지인 머신, 또는 데이터 그램의 송신원인 머신의 IP 주소를 돌려줍니다.

반환값:

이 데이터 그램의 송신지인 머신, 또는 데이터 그램의 송신원인 머신의 IP 주소

관련 항목:

InetAddress , setAddress(java.net.InetAddress)

getPort

public int getPort()

이 데이터 그램의 송신지 또는 데이터 그램의 송신원의, 리모트 호스트상의 포토 번호를 돌려줍니다.

반환값:

이 데이터 그램의 송신지 또는 데이터 그램의 송신원의, 리모트 호스트상의 포토 번호

관련 항목:

setPort(int)

getData

public byte[] getData()

데이터 버퍼를 돌려줍니다. 수신한 데이터 또는 송신하는 데이터는 버퍼의 offset 로부터 개시해,length 의 사이 동작합니다.

반환값:

데이터를 수신 또는 송신하는데 사용하는 버퍼

관련 항목:

setData(byte[], int, int)

getOffset

public int getOffset()

송신하는 데이터의 오프셋(offset), 또는 수신한 데이터의 오프셋(offset)를 돌려줍니다.

반환값:

송신하는 데이터의 오프셋(offset), 또는 수신한 데이터의 오프셋(offset)

도입된 버젼:

JDK1. 2

getLength

public int getLength()

송신하는 데이터의 길이, 또는 수신한 데이터의 길이를 돌려줍니다.

반환값:

송신하는 데이터의 길이, 또는 수신한 데이터의 길이

관련 항목:

setLength(int)

setData

public void setData(byte[] buf,
                    int offset,
                    int length)

이 패킷용의 데이터 버퍼를 설정합니다. 패킷의 데이터, 길이, 및 오프셋(offset)를 설정합니다.

파라미터:

buf - 이 패킷용으로서 설정하는 버퍼

offset - 데이터에의 오프셋(offset)

length - 데이터의 길이, 또는 데이터를 수신하는데 사용하는 버퍼의 길이, 혹은 그 양쪽 모두

예외:

NullPointerException - 인수가 null 의 경우

도입된 버젼:

JDK1. 2

관련 항목:

getData() , getOffset() , getLength()

setAddress

public void setAddress(InetAddress  iaddr)

이 데이터 그램의 송신지인 머신의 IP 주소를 설정합니다.

파라미터:

iaddr - InetAddress

도입된 버젼:

JDK1. 1

관련 항목:

getAddress()

setPort

public void setPort(int iport)

이 데이터 그램의 송신지인 리모트 호스트의 포토 번호를 설정합니다.

파라미터:

iport - 포토 번호

도입된 버젼:

JDK1. 1

관련 항목:

getPort()

setSocketAddress

public void setSocketAddress(SocketAddress  address)

이 데이터 그램의 송신지인 리모트 호스트의 SocketAddress (통상은 IP 주소 + 포토 번호)를 설정합니다.

파라미터:

address - SocketAddress

예외:

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

도입된 버젼:

1.4

관련 항목:

getSocketAddress()

getSocketAddress

public SocketAddress  getSocketAddress()

이 패킷의 송신지 또는 송신원인 리모트 호스트의 SocketAddress (통상은 IP 주소 + 포토 번호)를 취득합니다.

반환값:

SocketAddress

도입된 버젼:

1.4

관련 항목:

setSocketAddress(java.net.SocketAddress)

setData

public void setData(byte[] buf)

이 패킷용의 데이터 버퍼를 설정합니다. 이 DatagramPacket 의 오프셋(offset)는 0 에, 길이는 buf 의 길이로 설정됩니다.

파라미터:

buf - 이 패킷용으로서 설정하는 버퍼

예외:

NullPointerException - 인수가 null 의 경우

도입된 버젼:

JDK1. 1

관련 항목:

getLength() , getData()

setLength

public void setLength(int length)

이 패킷의 길이를 설정합니다. 패킷의 길이는 송신되는 패킷의 데이터 버퍼에 있는 바이트수, 혹은 데이터의 수신에 사용하는 패킷용 데이터 버퍼의 바이트수입니다. length 의 값은 패킷의 버퍼의 length 의 값과 오프셋(offset)를 더한 값이하가 아니면 안됩니다.

파라미터:

length - 이 패킷용으로서 설정하는 길이

예외:

IllegalArgumentException - length 가 부의 값의 경우, 혹은 패킷의 데이터 버퍼보다 큰 경우

도입된 버젼:

JDK1. 1

관련 항목:

getLength() , setData(byte[], int, int)