http

package

v2.1.43 Latest Latest Go to latest Published: Apr 24, 2024 License: Apache-2.0 Imports: 9 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

View Source

const (
	// RangePrefix is prefix of range header.
	RangePrefix = "bytes="

	// RangeSeparator is separator of range header.
	RangeSeparator = "-"
)

View Source

const (
	// DefaultDialTimeout is the default timeout for dialing a http connection.
	DefaultDialTimeout = 30 * time.Second
)

View Source

var ErrNoOverlap = errors.New("invalid range: failed to overlap")

ErrNoOverlap is returned by ParseRange if first-byte-pos of all of the byte-range-spec values is greater than the content size.

func HeaderToMap(header http.Header) map[string]string

HeaderToMap coverts request headers to map[string]string.

func MapToHeader(m map[string]string) http.Header

MapToHeader coverts map[string]string to request headers.

func NewSafeDialer() *net.Dialer

NewSafeDialer returns a new net.Dialer with safe socket control.

func PickHeader(header http.Header, key, defaultValue string) string

PickHeader pick header with key.

type Range struct {
	Start, Length int64
}

Range specifies the byte range to be sent to the client.

func MustParseRange(s string, size int64) Range

MustParseRange is like ParseRange but panics if the range cannot be parsed.

func ParseOneRange(s string, size int64) (Range, error)

ParseOneRange parses only one range of Range header string as per RFC 7233.

func ParseRange(s string, size int64) ([]Range, error)

ParseRange parses a Range header string as per RFC 7233. ErrNoOverlap is returned if none of the ranges overlap. Example:

"Range": "bytes=100-200"
"Range": "bytes=-50"
"Range": "bytes=150-"
"Range": "bytes=0-0,-1"

copy from go/1.15.2 net/http/fs.go ParseRange

func ParseURLMetaRange(s string, size int64) (Range, error)

ParseRange parses a Range string of grpc UrlMeta. Example:

"Range": "100-200"
"Range": "-50"
"Range": "150-"

func (r *Range) String() string

String specifies the string of http header.

func (r *Range) URLMetaString() string

String specifies the string of url meta.