Mojo UDP API implementation.

mojo/services/public/interfaces/network/udp_socket.mojom

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 import "mojo/services/public/interfaces/network/net_address.mojom"
 import "mojo/services/public/interfaces/network/network_error.mojom"
 
 module mojo {
 
 [Client=UDPSocketClient]
 interface UDPSocket {
-  // Sets the send buffer size (in bytes) for the socket.
+  // Sets the send buffer size (in bytes) for the socket. The socket must be
+  // bound.
   //
   // Note: This is only treated as a hint. Even if it succeeds, the service
   // doesn't guarantee it will conform to the size.
   SetSendBufferSize(uint32 size) => (NetworkError result);
 
-  // Sets the receive buffer size (in bytes) for the socket.
+  // Sets the receive buffer size (in bytes) for the socket. The socket must be
+  // bound.
   //
   // Note: This is only treated as a hint. Even if it succeeds, the service
   // doesn't guarantee it will conform to the size.
   SetReceiveBufferSize(uint32 size) => (NetworkError result);
 
   // Allows the socket to share the local address to which it will be bound with
   // other processes. Should be called before Bind().
   AllowAddressReuse() => (NetworkError result);
 
   // Binds the socket to the given address.
@@ skipping 14 matching lines @@
   //   ...
   //   service->ReceiveMorePackets(3);
   //   // The client expects 4 more calls to OnReceived().
   ReceiveMorePackets(uint32 number);
 
   // Sends data to the specified destination. The socket must be bound.
   // The method doesn't report the result of the operation.
   SendToAndForget(NetAddress addr, uint8[] data);
 
   // Sends data to the specified destination. The socket must be bound.
   SendTo(NetAddress addr, uint8[] data) => (NetworkError result);

[Matt Perry, 2014/09/29 23:39:08]

Have you considered using a DataPipe for the data transfer? If so, I'm curious
what made you decide to send the data over the message pipe. I have a similar
interface in the WebSocket API, and used DataPipes. The DataPipe way does end up
being more complicated, unfortunately.

 };
 
 interface UDPSocketClient {
   // |addr| and |data| are non-NULL on success.
   OnReceived(NetworkError result, NetAddress? addr, uint8[]? data);
 };
 
 }