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) offset 의 패킷이 지정된 호스트상의 지정된 포트 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다.

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

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 - 읽어들이는 바이트수

도입된 버젼:

1.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) offset 의 패킷이 지정된 호스트상의 지정된 포트 번호에 송신하기 위한 데이터 그램 패킷을 구축합니다. 인수 length 의 값은,buf.length 의 값이하가 아니면 안됩니다.

파라미터:

buf - 패킷 데이터

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

length - 패킷 데이터의 길이

address - 전송처 주소

port - 전송처 포트 번호

도입된 버젼:

1.2

관련 항목:

InetAddress

DatagramPacket

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

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

파라미터:

buf - 패킷 데이터

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

length - 패킷 데이터의 길이

address - 전송처 소켓 주소

예외:

IllegalArgumentException - 주소형이 지원되어 있지 않은 경우

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 - 전송처 주소

예외:

IllegalArgumentException - 주소형이 지원되어 있지 않은 경우

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)

도입된 버젼:

1.2

getLength

public int getLength()

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

반환값:

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

관련 항목:

setLength(int)

setData

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

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

파라미터:

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

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

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

예외:

NullPointerException - 인수가 null 의 경우

도입된 버젼:

1.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 는, 오프셋(offset)와 패킷 버퍼장을 더한 값이하가 아니면 안됩니다.

파라미터:

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

예외:

IllegalArgumentException - length 가 부의 경우, 또는 length 가 패킷의 데이터 버퍼보다 큰 경우 length

도입된 버젼:

JDK1. 1

관련 항목:

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