public interface UDPDatagramConnection extends DatagramConnection
SocketConnection
.
A UDPDatagramConnection
is returned from
Connector.open()
in response to a request to
open a datagram://
URL connection string.
If the connection string omits both the host
and port
fields in the URL string, then the
system will allocate an available port. The local
address and the local port can be discovered using
the accessor methods within this interface.
The mode
parameter of Connector.open
is not used.
The syntax described here for the datagram URL connection string
is also valid for the Datagram.setAddress()
method
used to assign a destination address to a Datagram
to be sent. For example, datagram://
host:port
The URI must conform to the BNF syntax specified below. If the URI
does not conform to this syntax, an IllegalArgumentException
is thrown.
<datagram_connection_string> | ::= "datagram://" | "datagram://"<hostport> |
<hostport> | ::= host ":" port |
<host> | ::= host name or IP address (omitted for inbound connections) |
<port> | ::= numeric port number (omitted for system assigned port) |
This connection inherits the connection options from DatagramConnection
.
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getLocalAddress()
Gets the local address of this datagram connection.
|
int |
getLocalPort()
Returns the local port of this datagram connection.
|
getAccessPoint, getMaximumLength, getNominalLength, newDatagram, newDatagram, newDatagram, newDatagram, receive, send
close
java.lang.String getLocalAddress() throws java.io.IOException
This method returns the numeric host IP address that can be used to connect to this end of the datagram connection from an external system. For IPV6, the string MUST be formatted as in a URL according to RFC 2732 so it contains the '[' and ']'. Since IP addresses may be dynamically assigned, a remote application will need to be robust in the face of IP number reassignment.
The local hostname (if available) can be accessed from
System.getProperty("microedition.hostname")
java.io.IOException
- if the connection was closed.ServerSocketConnection
int getLocalPort() throws java.io.IOException
java.io.IOException
- if the connection was closed.ServerSocketConnection
Copyright (c) 2014, Oracle and/or its affiliates. All Rights Reserved. Use of this specification is subject to license terms.