UdpChannel (Aeron Message Transport)

java.lang.Object
- io.aeron.driver.media.UdpChannel

```
public final class UdpChannel
extends Object
```
The media configuration for Aeron UDP channels as an instantiation of the socket addresses for a ChannelUri.

See Also:

ChannelUri, ChannelUriStringBuilder

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`canonicalForm()` The canonical form for the channel
`static String`	`canonicalise(String localParamValue, InetSocketAddress localData, String remoteParamValue, InetSocketAddress remoteData)` Return a string which is a canonical form of the channel suitable for use as a file or directory name and also as a method of hashing, etc.
`ChannelUri`	`channelUri()` Get the `ChannelUri` for this channel.
`String`	`description()` Used for debugging to get a human readable description of the channel.
`static InetSocketAddress`	`destinationAddress(ChannelUri uri, NameResolver nameResolver)` Get the endpoint destination address from the URI.
`boolean`	`equals(Object o)` Channels are considered equal if the `canonicalForm()` is equal.
`boolean`	`hasExplicitControl()` Does the channel have an explicit control address as used with multi-destination-cast or not?
`boolean`	`hasExplicitEndpoint()` Does the channel have an explicit endpoint address?
`int`	`hashCode()` The hash code for the `canonicalForm()`.
`boolean`	`hasMulticastTtl()` Has this channel got a multicast TTL value set so that `multicastTtl()` is valid.
`boolean`	`hasTag()` Has the URI a tag to indicate entity relationships and if `tag()` is valid.
`boolean`	`isDynamicControlMode()` Does the channel have dynamic control mode specified.
`boolean`	`isManualControlMode()` Does the channel have manual control mode specified.
`boolean`	`isMulticast()` Is the channel UDP multicast.
`boolean`	`isMultiDestination()` Is the channel configured as multi-destination.
`InetSocketAddress`	`localControl()` Local control address and port.
`InetSocketAddress`	`localData()` Local data address and port.
`NetworkInterface`	`localInterface()` Local interface to be used by the channel.
`boolean`	`matchesTag(UdpChannel udpChannel)` Does this channel have a tag match to another channel having INADDR_ANY endpoints.
`int`	`multicastTtl()` Multicast TTL value.
`String`	`originalUriString()` Original URI of the channel URI.
`static UdpChannel`	`parse(String channelUriString)` Parse channel URI and create a `UdpChannel` using the default name resolver..
`static UdpChannel`	`parse(String channelUriString, NameResolver nameResolver)` Parse channel URI and create a `UdpChannel`.
`static UdpChannel`	`parse(String channelUriString, NameResolver nameResolver, boolean isDestination)` Parse channel URI and create a `UdpChannel`.
`static int`	`parseBufferLength(ChannelUri channelUri, String paramName)` Parse a buffer length for a given URI paramName with a format specified by `SystemUtil.parseSize(String, String)`, clamping the range to 0 <= x <= Integer.MAX_VALUE.
`ProtocolFamily`	`protocolFamily()` Get the `ProtocolFamily` for this channel.
`int`	`receiverWindowLength()` Get the receiver window length used as the initial window length for congestion control.
`int`	`receiverWindowLengthOrDefault(int defaultValue)` Get the receiver window length used as the initial window length for congestion control.
`InetSocketAddress`	`remoteControl()` Remote control address information
`InetSocketAddress`	`remoteData()` Remote data address and port.
`static InetSocketAddress`	`resolve(String endpoint, String uriParamName, boolean isReResolution, NameResolver nameResolver)` Resolve and endpoint into a `InetSocketAddress`.
`int`	`socketRcvbufLength()` Get the socket receive buffer length.
`int`	`socketRcvbufLengthOrDefault(int defaultValue)` Get the socket receive buffer length.
`int`	`socketSndbufLength()` Get the socket send buffer length.
`int`	`socketSndbufLengthOrDefault(int defaultValue)` Get the socket send buffer length.
`long`	`tag()` Get the tag value on the channel which is only valid if `hasTag()` is true.
`String`	`toString()` The `canonicalForm()` for the channel.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - parse
```
public static UdpChannel parse(String channelUriString)
```
    Parse channel URI and create a UdpChannel using the default name resolver..
    
    Parameters:
    
    channelUriString - to parse.
    
    Returns:
    
    a new UdpChannel as the result of parsing.
    
    Throws:
    
    InvalidChannelException - if an error occurs.
  - parse
```
public static UdpChannel parse(String channelUriString,
                               NameResolver nameResolver)
```
    Parse channel URI and create a UdpChannel.
    
    Parameters:
    
    channelUriString - to parse.
    
    nameResolver - to use for resolving names.
    
    Returns:
    
    a new UdpChannel as the result of parsing.
    
    Throws:
    
    InvalidChannelException - if an error occurs.
  - parse
```
public static UdpChannel parse(String channelUriString,
                               NameResolver nameResolver,
                               boolean isDestination)
```
    Parse channel URI and create a UdpChannel.
    
    Parameters:
    
    channelUriString - to parse.
    
    nameResolver - to use for resolving names.
    
    isDestination - to identify if it is a destination within a channel.
    
    Returns:
    
    a new UdpChannel as the result of parsing.
    
    Throws:
    
    InvalidChannelException - if an error occurs.
  - parseBufferLength
```
public static int parseBufferLength(ChannelUri channelUri,
                                    String paramName)
```
    Parse a buffer length for a given URI paramName with a format specified by SystemUtil.parseSize(String, String), clamping the range to 0 <= x <= Integer.MAX_VALUE.
    
    Parameters:
    
    channelUri - to get the value from
    
    paramName - key for the parameter
    
    Returns:
    
    value as an integer
    
    See Also:
    
    SystemUtil.parseSize(String, String)
  - canonicalise
```
public static String canonicalise(String localParamValue,
                                  InetSocketAddress localData,
                                  String remoteParamValue,
                                  InetSocketAddress remoteData)
```
    Return a string which is a canonical form of the channel suitable for use as a file or directory name and also as a method of hashing, etc.
    The general format is: UDP-interface:localPort-remoteAddress:remotePort
    
    Parameters:
    
    localParamValue - interface or MDC control param value or null for not set.
    
    localData - address/interface for the channel.
    
    remoteParamValue - endpoint param value or null if not set.
    
    remoteData - address for the channel.
    
    Returns:
    
    canonical representation as a string.
  - remoteData
```
public InetSocketAddress remoteData()
```
    Remote data address and port.
    
    Returns:
    
    remote data address and port.
  - localData
```
public InetSocketAddress localData()
```
    Local data address and port.
    
    Returns:
    
    local data address port.
  - remoteControl
```
public InetSocketAddress remoteControl()
```
    Remote control address information
    
    Returns:
    
    remote control address information
  - localControl
```
public InetSocketAddress localControl()
```
    Local control address and port.
    
    Returns:
    
    local control address and port.
  - channelUri
```
public ChannelUri channelUri()
```
    Get the ChannelUri for this channel.
    
    Returns:
    
    the ChannelUri for this channel.
  - hasMulticastTtl
```
public boolean hasMulticastTtl()
```
    Has this channel got a multicast TTL value set so that multicastTtl() is valid.
    
    Returns:
    
    true if this channel is a multicast TTL set otherwise false.
  - multicastTtl
```
public int multicastTtl()
```
    Multicast TTL value.
    
    Returns:
    
    multicast TTL value.
  - canonicalForm
```
public String canonicalForm()
```
    The canonical form for the channel
    canonicalise(java.lang.String, java.net.InetSocketAddress, java.lang.String, java.net.InetSocketAddress)
    
    Returns:
    
    canonical form for channel.
  - toString
```
public String toString()
```
    The canonicalForm() for the channel.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    the canonicalForm() for the channel.
  - isMulticast
```
public boolean isMulticast()
```
    Is the channel UDP multicast.
    
    Returns:
    
    true if the channel is UDP multicast.
  - localInterface
```
public NetworkInterface localInterface()
```
    Local interface to be used by the channel.
    
    Returns:
    
    NetworkInterface for the local interface used by the channel.
  - originalUriString
```
public String originalUriString()
```
    Original URI of the channel URI.
    
    Returns:
    
    the original uri string from the client.
  - protocolFamily
```
public ProtocolFamily protocolFamily()
```
    Get the ProtocolFamily for this channel.
    
    Returns:
    
    the ProtocolFamily for this channel.
  - tag
```
public long tag()
```
    Get the tag value on the channel which is only valid if hasTag() is true.
    
    Returns:
    
    the tag value on the channel.
  - isManualControlMode
```
public boolean isManualControlMode()
```
    Does the channel have manual control mode specified.
    
    Returns:
    
    does channel have manual control mode specified.
  - isDynamicControlMode
```
public boolean isDynamicControlMode()
```
    Does the channel have dynamic control mode specified.
    
    Returns:
    
    does channel have dynamic control mode specified.
  - hasExplicitEndpoint
```
public boolean hasExplicitEndpoint()
```
    Does the channel have an explicit endpoint address?
    
    Returns:
    
    does channel have an explicit endpoint address or not?
  - hasExplicitControl
```
public boolean hasExplicitControl()
```
    Does the channel have an explicit control address as used with multi-destination-cast or not?
    
    Returns:
    
    does channel have an explicit control address or not?
  - hasTag
```
public boolean hasTag()
```
    Has the URI a tag to indicate entity relationships and if tag() is valid.
    
    Returns:
    
    true if the channel has a tag.
  - isMultiDestination
```
public boolean isMultiDestination()
```
    Is the channel configured as multi-destination.
    
    Returns:
    
    true if he channel configured as multi-destination.
  - socketRcvbufLength
```
public int socketRcvbufLength()
```
    Get the socket receive buffer length.
    
    Returns:
    
    socket receive buffer length or 0 if not specified.
  - socketRcvbufLengthOrDefault
```
public int socketRcvbufLengthOrDefault(int defaultValue)
```
    Get the socket receive buffer length.
    
    Parameters:
    
    defaultValue - to be used if the UdpChannel's value is 0 (unspecified).
    
    Returns:
    
    socket receive buffer length or 0 if not specified.
  - socketSndbufLength
```
public int socketSndbufLength()
```
    Get the socket send buffer length.
    
    Returns:
    
    socket send buffer length or 0 if not specified.
  - socketSndbufLengthOrDefault
```
public int socketSndbufLengthOrDefault(int defaultValue)
```
    Get the socket send buffer length.
    
    Parameters:
    
    defaultValue - to be used if the UdpChannel's value is 0 (unspecified).
    
    Returns:
    
    socket send buffer length or defaultValue if not specified.
  - receiverWindowLength
```
public int receiverWindowLength()
```
    Get the receiver window length used as the initial window length for congestion control.
    
    Returns:
    
    receiver window length or 0 if not specified.
  - receiverWindowLengthOrDefault
```
public int receiverWindowLengthOrDefault(int defaultValue)
```
    Get the receiver window length used as the initial window length for congestion control.
    
    Parameters:
    
    defaultValue - to be used if the UdpChannel's value is 0 (unspecified).
    
    Returns:
    
    receiver window length or defaultValue if not specified.
  - matchesTag
```
public boolean matchesTag(UdpChannel udpChannel)
```
    Does this channel have a tag match to another channel having INADDR_ANY endpoints.
    
    Parameters:
    
    udpChannel - to match against.
    
    Returns:
    
    true if there is a match otherwise false.
  - description
```
public String description()
```
    Used for debugging to get a human readable description of the channel.
    
    Returns:
    
    a human readable description of the channel.
  - equals
```
public boolean equals(Object o)
```
    Channels are considered equal if the canonicalForm() is equal.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    o - object to be compared with.
    
    Returns:
    
    true if the canonicalForm() is equal, otherwise false.
  - hashCode
```
public int hashCode()
```
    The hash code for the canonicalForm().
    
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    the hash code for the canonicalForm().
  - destinationAddress
```
public static InetSocketAddress destinationAddress(ChannelUri uri,
                                                   NameResolver nameResolver)
```
    Get the endpoint destination address from the URI.
    
    Parameters:
    
    uri - to check.
    
    nameResolver - to use for resolution
    
    Returns:
    
    endpoint address for URI.
  - resolve
```
public static InetSocketAddress resolve(String endpoint,
                                        String uriParamName,
                                        boolean isReResolution,
                                        NameResolver nameResolver)
                                 throws UnknownHostException
```
    Resolve and endpoint into a InetSocketAddress.
    
    Parameters:
    
    endpoint - to resolve
    
    uriParamName - for the resolution
    
    isReResolution - for the resolution
    
    nameResolver - to be used for hostname.
    
    Returns:
    
    address for endpoint
    
    Throws:
    
    UnknownHostException - if the endpoint can not be resolved.

Class UdpChannel

Method Summary

Methods inherited from class java.lang.Object

Method Detail

parse

parse

parse

parseBufferLength

canonicalise

remoteData

localData

remoteControl

localControl

channelUri

hasMulticastTtl

multicastTtl

canonicalForm

toString

isMulticast

localInterface

originalUriString

protocolFamily

tag

isManualControlMode

isDynamicControlMode

hasExplicitEndpoint

hasExplicitControl

hasTag

isMultiDestination

socketRcvbufLength

socketRcvbufLengthOrDefault

socketSndbufLength

socketSndbufLengthOrDefault

receiverWindowLength

receiverWindowLengthOrDefault

matchesTag

description

equals

hashCode

destinationAddress

resolve