1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220
|
package amqp_test
import (
"context"
"errors"
"fmt"
"log"
"time"
amqp "github.com/Azure/go-amqp"
)
func Example() {
ctx := context.TODO()
// create connection
conn, err := amqp.Dial(ctx, "amqps://my-namespace.servicebus.windows.net", &amqp.ConnOptions{
SASLType: amqp.SASLTypePlain("access-key-name", "access-key"),
})
if err != nil {
log.Fatal("Dialing AMQP server:", err)
}
defer conn.Close()
// open a session
session, err := conn.NewSession(ctx, nil)
if err != nil {
log.Fatal("Creating AMQP session:", err)
}
// send a message
{
// create a sender
sender, err := session.NewSender(ctx, "/queue-name", nil)
if err != nil {
log.Fatal("Creating sender link:", err)
}
ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
// send message
err = sender.Send(ctx, amqp.NewMessage([]byte("Hello!")), nil)
if err != nil {
log.Fatal("Sending message:", err)
}
sender.Close(ctx)
cancel()
}
// continuously read messages
{
// create a receiver
receiver, err := session.NewReceiver(ctx, "/queue-name", nil)
if err != nil {
log.Fatal("Creating receiver link:", err)
}
defer func() {
ctx, cancel := context.WithTimeout(ctx, 1*time.Second)
receiver.Close(ctx)
cancel()
}()
for {
// receive next message
msg, err := receiver.Receive(ctx, nil)
if err != nil {
log.Fatal("Reading message from AMQP:", err)
}
// accept message
if err = receiver.AcceptMessage(context.TODO(), msg); err != nil {
log.Fatalf("Failure accepting message: %v", err)
}
fmt.Printf("Message received: %s\n", msg.GetData())
}
}
}
func ExampleConnError() {
// *ConnErrors are returned when the underlying connection has been closed.
// this error is propagated to all child Session, Sender, and Receiver instances.
ctx := context.TODO()
// create connection
conn, err := amqp.Dial(ctx, "amqps://my-namespace.servicebus.windows.net", &amqp.ConnOptions{
SASLType: amqp.SASLTypePlain("access-key-name", "access-key"),
})
if err != nil {
log.Fatal("Dialing AMQP server:", err)
}
// open a session
session, err := conn.NewSession(ctx, nil)
if err != nil {
log.Fatal("Creating AMQP session:", err)
}
// create a sender
sender, err := session.NewSender(ctx, "/queue-name", nil)
if err != nil {
log.Fatal("Creating sender link:", err)
}
// close the connection before sending the message
conn.Close()
// attempt to send message on a closed connection
err = sender.Send(ctx, amqp.NewMessage([]byte("Hello!")), nil)
var connErr *amqp.ConnError
if !errors.As(err, &connErr) {
log.Fatalf("unexpected error type %T", err)
}
// similarly, methods on session will fail in the same way
_, err = session.NewReceiver(ctx, "/queue-name", nil)
if !errors.As(err, &connErr) {
log.Fatalf("unexpected error type %T", err)
}
// methods on the connection will also fail
_, err = conn.NewSession(ctx, nil)
if !errors.As(err, &connErr) {
log.Fatalf("unexpected error type %T", err)
}
}
func ExampleSessionError() {
// *SessionErrors are returned when a session has been closed.
// this error is propagated to all child Sender and Receiver instances.
ctx := context.TODO()
// create connection
conn, err := amqp.Dial(ctx, "amqps://my-namespace.servicebus.windows.net", &amqp.ConnOptions{
SASLType: amqp.SASLTypePlain("access-key-name", "access-key"),
})
if err != nil {
log.Fatal("Dialing AMQP server:", err)
}
defer conn.Close()
// open a session
session, err := conn.NewSession(ctx, nil)
if err != nil {
log.Fatal("Creating AMQP session:", err)
}
// create a sender
sender, err := session.NewSender(ctx, "/queue-name", nil)
if err != nil {
log.Fatal("Creating sender link:", err)
}
// close the session before sending the message
session.Close(ctx)
// attempt to send message on a closed session
err = sender.Send(ctx, amqp.NewMessage([]byte("Hello!")), nil)
var sessionErr *amqp.SessionError
if !errors.As(err, &sessionErr) {
log.Fatalf("unexpected error type %T", err)
}
// similarly, methods on session will fail in the same way
_, err = session.NewReceiver(ctx, "/queue-name", nil)
if !errors.As(err, &sessionErr) {
log.Fatalf("unexpected error type %T", err)
}
}
func ExampleLinkError() {
// *LinkError are returned by methods on Senders/Receivers after Close() has been called.
// it can also be returned if the peer has closed the link. in this case, the *RemoteErr
// field should contain additional information about why the peer closed the link.
ctx := context.TODO()
// create connection
conn, err := amqp.Dial(ctx, "amqps://my-namespace.servicebus.windows.net", &amqp.ConnOptions{
SASLType: amqp.SASLTypePlain("access-key-name", "access-key"),
})
if err != nil {
log.Fatal("Dialing AMQP server:", err)
}
defer conn.Close()
// open a session
session, err := conn.NewSession(ctx, nil)
if err != nil {
log.Fatal("Creating AMQP session:", err)
}
// create a sender
sender, err := session.NewSender(ctx, "/queue-name", nil)
if err != nil {
log.Fatal("Creating sender link:", err)
}
// send message
err = sender.Send(ctx, amqp.NewMessage([]byte("Hello!")), nil)
if err != nil {
log.Fatal("Creating AMQP session:", err)
}
// now close the sender
sender.Close(ctx)
// attempt to send a message after close
err = sender.Send(ctx, amqp.NewMessage([]byte("Hello!")), nil)
var linkErr *amqp.LinkError
if !errors.As(err, &linkErr) {
log.Fatalf("unexpected error type %T", err)
}
}
|