AsyncChannel (Groovy 6.0.0-SNAPSHOT)

```
public interface AsyncChannel<T>
extends Iterable
```
An asynchronous channel for inter-task communication with optional buffering.
A channel coordinates producers and consumers without exposing explicit locks or shared mutable state, following the CSP (Communicating Sequential Processes) paradigm popularized by Go's channels.
Channels support both unbuffered (rendezvous) and buffered modes:
- Unbuffered — create() or create(0). Each send suspends until a matching receive arrives.
- Buffered — create(n). Values are enqueued until the buffer fills, then senders suspend.
Channels implement Iterable, so they work with for await and regular for loops — iteration yields received values until the channel is closed and drained:
```
def ch = AsyncChannel.create(2)
 async { ch.send('a'); ch.send('b'); ch.close() 
 for await (item in ch) {
     println item   // prints 'a', then 'b'
 }
 }
```
Type Parameters:
T - the payload type
See Also:
Awaitable
Since:
6.0.0

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public boolean`	`close()` Closes this channel.
`<T>`	`public static AsyncChannel<T>`	`create()` Creates an unbuffered (rendezvous) channel.
`<T>`	`public static AsyncChannel<T>`	`create(int capacity)` Creates a channel with the specified buffer capacity.
	`public int`	`getBufferedSize()` Returns the number of values currently buffered.
	`public int`	`getCapacity()` Returns this channel's buffer capacity.
	`public boolean`	`isClosed()` Returns `true` if this channel has been closed.
	`public Awaitable<T>`	`receive()` Receives the next value from this channel.
	`public Awaitable<Void>`	`send(T value)` Sends a value through this channel.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`interface Iterable`	`forEach, iterator, spliterator`

- Method Detail
  - public boolean close()
    
    Closes this channel. Idempotent.
    Buffered values remain receivable. Pending senders fail with ChannelClosedException. After all buffered values are drained, subsequent receives also fail.
    Returns:
    true if this call actually closed the channel
  - <T> public static AsyncChannel<T> create()
    
    Creates an unbuffered (rendezvous) channel.
  - <T> public static AsyncChannel<T> create(int capacity)
    
    Creates a channel with the specified buffer capacity.
    Parameters:
    capacity - the maximum buffer size; 0 for unbuffered
  - public int getBufferedSize()
    
    Returns the number of values currently buffered.
  - public int getCapacity()
    
    Returns this channel's buffer capacity.
  - public boolean isClosed()
    
    Returns true if this channel has been closed.
  - public Awaitable<T> receive()
    
    Receives the next value from this channel.
    The returned Awaitable completes when a value is available. Receiving from a closed, empty channel fails with ChannelClosedException.
    Returns:
    an Awaitable that yields the next value
  - public Awaitable<Void> send(T value)
    
    Sends a value through this channel.
    The returned Awaitable completes when the value has been delivered to a receiver or buffered. Sending to a closed channel fails immediately with ChannelClosedException.
    throws:
    NullPointerException if value is null
    
    Parameters:
    value - the value to send; must not be null
    Returns:
    an Awaitable that completes when the send succeeds

Summary:
Method

| Detail:
Method

[Java] Interface AsyncChannel<T>

Methods Summary

Inherited Methods Summary

Method Detail

public boolean close()

<T> public static AsyncChannel<T> create()

<T> public static AsyncChannel<T> create(int capacity)

public int getBufferedSize()

public int getCapacity()

public boolean isClosed()

public Awaitable<T> receive()

public Awaitable<Void> send(T value)