// Copyright 2019 The Go Cloud Development Kit Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package natspubsub_test import ( "context" "log" "github.com/nats-io/nats.go" "gocloud.dev/pubsub" "gocloud.dev/pubsub/natspubsub" ) func ExampleOpenTopic() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() natsConn, err := nats.Connect("nats://nats.example.com") if err != nil { log.Fatal(err) } defer natsConn.Close() topic, err := natspubsub.OpenTopic(natsConn, "example.mysubject", nil) if err != nil { log.Fatal(err) } defer topic.Shutdown(ctx) } func ExampleOpenSubscription() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() natsConn, err := nats.Connect("nats://nats.example.com") if err != nil { log.Fatal(err) } defer natsConn.Close() subscription, err := natspubsub.OpenSubscription( natsConn, "example.mysubject", nil) if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) } func ExampleOpenSubscription_queue() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() natsConn, err := nats.Connect("nats://nats.example.com") if err != nil { log.Fatal(err) } defer natsConn.Close() subscription, err := natspubsub.OpenSubscription( natsConn, "example.mysubject", &natspubsub.SubscriptionOptions{Queue: "queue1"}) if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) } func Example_openTopicFromURL() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() // pubsub.OpenTopic creates a *pubsub.Topic from a URL. // This URL will Dial the NATS server at the URL in the environment variable // NATS_SERVER_URL and send messages with subject "example.mysubject". topic, err := pubsub.OpenTopic(ctx, "nats://example.mysubject") if err != nil { log.Fatal(err) } defer topic.Shutdown(ctx) } func Example_openSubscriptionFromURL() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() // pubsub.OpenSubscription creates a *pubsub.Subscription from a URL. // This URL will Dial the NATS server at the URL in the environment variable // NATS_SERVER_URL and receive messages with subject "example.mysubject". subscription, err := pubsub.OpenSubscription(ctx, "nats://example.mysubject") if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) } func Example_openQueueSubscriptionFromURL() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() // pubsub.OpenSubscription creates a *pubsub.Subscription from a URL. // This URL will Dial the NATS server at the URL in the environment variable // NATS_SERVER_URL and receive messages with subject "example.mysubject" // This URL will be parsed and the queue attribute will be used as the Queue parameter when creating the NATS Subscription. subscription, err := pubsub.OpenSubscription(ctx, "nats://example.mysubject?queue=myqueue") if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) } func ExampleOpenSubscriptionV2() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() natsConn, err := nats.Connect("nats://nats.example.com") if err != nil { log.Fatal(err) } defer natsConn.Close() subscription, err := natspubsub.OpenSubscriptionV2( natsConn, "example.mysubject", nil) if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) } func ExampleOpenTopicV2() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() natsConn, err := nats.Connect("nats://nats.example.com") if err != nil { log.Fatal(err) } defer natsConn.Close() topic, err := natspubsub.OpenTopicV2(natsConn, "example.mysubject", nil) if err != nil { log.Fatal(err) } defer topic.Shutdown(ctx) } func Example_openTopicV2FromURL() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() // pubsub.OpenTopic creates a *pubsub.Topic from a URL. // This URL will Dial the NATS server at the URL in the environment variable // NATS_SERVER_URL and send messages with subject "example.mysubject". // This URL will be parsed and the natsv2 attribute will be used to // use NATS v2.2.0+ native message headers as the message metadata. topic, err := pubsub.OpenTopic(ctx, "nats://example.mysubject?natsv2") if err != nil { log.Fatal(err) } defer topic.Shutdown(ctx) } func Example_openSubscriptionV2FromURL() { // PRAGMA: This example is used on gocloud.dev; PRAGMA comments adjust how it is shown and can be ignored. // PRAGMA: On gocloud.dev, add a blank import: _ "gocloud.dev/pubsub/natspubsub" // PRAGMA: On gocloud.dev, hide lines until the next blank line. ctx := context.Background() // pubsub.OpenSubscription creates a *pubsub.Subscription from a URL. // This URL will Dial the NATS server at the URL in the environment variable // NATS_SERVER_URL and receive messages with subject "example.mysubject". // This URL will be parsed and the natsv2 attribute will be used to // use NATS v2.2.0+ native message headers as the message metadata. subscription, err := pubsub.OpenSubscription(ctx, "nats://example.mysubject?natsv2") if err != nil { log.Fatal(err) } defer subscription.Shutdown(ctx) }