ЗАМЕЧАНИЕ: Поддержка модулей в этом репозитории завершилась 31 марта 2023 года. Дополнительная информация доступна здесь.

req, err := Prepare(&http.Request{},
	token.WithAuthorization())

resp, err := Send(req,
	WithLogging(logger),
	DoErrorIfStatusCode(http.StatusInternalServerError),
	DoCloseIfError(),
	DoRetryForAttempts(5, time.Second))
err = Ответить(resp,
	ИгнорироватьТело(),
	Закрыть())

req, err := Подготовить(&http.Request{},
	СБазовымURL("https://microsoft.com/"),
	СПути("a"),
	СПути("b"),
	СПути("c"))

https://microsoft.com/a/b/c
```Подготовители и Ответчики могут быть использованы и переиспользованы (при условии, что поддерживаемые декораторы поддерживают это). Эффективное использование достигается путем создания одного или нескольких Подготовителей и Ответчиков, которые используются несколькими go-рутинами, и одного Отправителя, который используется несколькими отправляющими go-рутинами, все они связаны между собой с помощью входных/выходных каналов.Декораторы сохраняют свое состояние, переданное в замыкании (например, компоненты пути в приведенном выше примере). Будьте осторожны при использовании Подготовителей и Ответчиков только в контексте, где такое сохраненное состояние применимо. Например, может не иметь смысла использовать Подготовителя, который применяет строку запроса из фиксированного набора значений. Аналогично, использование Ответчика, который читает тело ответа в переданный структурированный объект (например, `ByUnmarshallingJson`), скорее всего, будет некорректным.

Ошибки, возникающие при работе с объектами и методами autorest, будут соответствовать интерфейсу `autorest.Error`.

Для получения более подробной информации обратитесь к включенным примерам. Для получения деталей о рекомендованном использовании этого пакета сгенерированными клиентами, обратитесь к описанию Клиента ниже.

### Помощники

#### Обработка дат Swagger

Спецификация Swagger (https://swagger.io), которая управляет AutoRest (https://github.com/Azure/autorest/), точно определяет два формата дат: дата и дата-время. Пакет github.com/Azure/go-autorest/autorest/date предоставляет производные объекты `time.Time`, чтобы обеспечить правильное парсинг и форматирование.

#### Обработка пустых значенийВ JSON отсутствующие значения имеют разные семантики по сравнению с пустыми значениями. Это особенно важно для сервисов, использующих HTTP-запрос PATCH. JSON, отправленный с запросом PATCH, обычно содержит только те значения, которые нужно изменить. Отсутствующие значения должны оставаться без изменений. Разработчики, следовательно, требуют способа как указания пустого значения, так и исключения значения из отправленного JSON. Пакет JSON на Go (`encoding/json`) поддерживает тег `omitempty`. Когда он указан, пустые значения исключаются из сгенерированного JSON. Поскольку Go определяет значения по умолчанию для всех базовых типов (например, "" для строки и 0 для int) и не предоставляет способа пометить значение как действительно пустое, пакет JSON рассматривает значения по умолчанию как пустые и исключает их из сгенерированного JSON. Это означает, что, используя базовые типы Go, закодированные через стандартный пакет JSON, невозможно создать JSON для очистки значения на сервере.Рабочее решение в сообществе Go заключается в использовании указателей на базовые типы вместо самих базовых типов в структурах, которые отображаются в JSON. Например, вместо значения типа `string` используется `*string`. Хотя это позволяет отличать пустые значения от тех, которые не должны изменяться, создание указателей на базовый тип (особенно константы или встроенные значения) требует дополнительных переменных. Например,

```go
  s := struct {
    S *string
  }{ S: &"foo" }

  v := "foo"
  s := struct {
    S *string
  }{ S: &v }

  s := struct {
    S *string
  }{ S: to.StringPtr("foo") }

go get github.com/Azure/go-autorest/autorest
go get github.com/Azure/go-autorest/autorest/azure
go get github.com/Azure/go-autorest/autorest/date
go get github.com/Azure/go-autorest/autorest/to