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)