aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/github.com/Azure/azure-storage-blob-go/2018-03-28/azblob/zc_pipeline.go
blob: af5fcd6c7f88e002233b5f5369d73f5a419eeca6 (plain) (blame)
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
package azblob

import (
    "github.com/Azure/azure-pipeline-go/pipeline"
)

// PipelineOptions is used to configure a request policy pipeline's retry policy and logging.
type PipelineOptions struct {
    // Log configures the pipeline's logging infrastructure indicating what information is logged and where.
    Log pipeline.LogOptions

    // Retry configures the built-in retry policy behavior.
    Retry RetryOptions

    // RequestLog configures the built-in request logging policy.
    RequestLog RequestLogOptions

    // Telemetry configures the built-in telemetry policy behavior.
    Telemetry TelemetryOptions
}

// NewPipeline creates a Pipeline using the specified credentials and options.
func NewPipeline(c Credential, o PipelineOptions) pipeline.Pipeline {
    if c == nil {
        panic("c can't be nil")
    }

    // Closest to API goes first; closest to the wire goes last
    f := []pipeline.Factory{
        NewTelemetryPolicyFactory(o.Telemetry),
        NewUniqueRequestIDPolicyFactory(),
        NewRetryPolicyFactory(o.Retry),
    }

    if _, ok := c.(*anonymousCredentialPolicyFactory); !ok {
        // For AnonymousCredential, we optimize out the policy factory since it doesn't do anything
        // NOTE: The credential's policy factory must appear close to the wire so it can sign any
        // changes made by other factories (like UniqueRequestIDPolicyFactory)
        f = append(f, c)
    }
    f = append(f,
        pipeline.MethodFactoryMarker(), // indicates at what stage in the pipeline the method factory is invoked
        NewRequestLogPolicyFactory(o.RequestLog))

    return pipeline.NewPipeline(f, pipeline.Options{HTTPSender: nil, Log: o.Log})
}