[#48] client: Split container methods by files

Signed-off-by: Evgenii Stratonikov <e.stratonikov@yadro.com>

client/container_get.go

@@ -0,0 +1,114 @@
+package client
+
+import (
+	"context"
+	"errors"
+	"fmt"
+
+	v2container "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/container"
+	"git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/refs"
+	rpcapi "git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/rpc"
+	"git.frostfs.info/TrueCloudLab/frostfs-api-go/v2/rpc/client"
+	"git.frostfs.info/TrueCloudLab/frostfs-sdk-go/container"
+	cid "git.frostfs.info/TrueCloudLab/frostfs-sdk-go/container/id"
+)
+
+// PrmContainerGet groups parameters of ContainerGet operation.
+type PrmContainerGet struct {
+	prmCommonMeta
+
+	idSet bool
+	id    cid.ID
+}
+
+// SetContainer sets identifier of the container to be read.
+// Required parameter.
+func (x *PrmContainerGet) SetContainer(id cid.ID) {
+	x.id = id
+	x.idSet = true
+}
+
+// ResContainerGet groups resulting values of ContainerGet operation.
+type ResContainerGet struct {
+	statusRes
+
+	cnr container.Container
+}
+
+// Container returns structured information about the requested container.
+//
+// Client doesn't retain value so modification is safe.
+func (x ResContainerGet) Container() container.Container {
+	return x.cnr
+}
+
+// ContainerGet reads FrostFS container by ID.
+//
+// Exactly one return value is non-nil. By default, server status is returned in res structure.
+// Any client's internal or transport errors are returned as `error`.
+// If PrmInit.ResolveFrostFSFailures has been called, unsuccessful
+// FrostFS status codes are returned as `error`, otherwise, are included
+// in the returned result structure.
+//
+// Returns an error if parameters are set incorrectly (see PrmContainerGet docs).
+// Context is required and must not be nil. It is used for network communication.
+//
+// Return statuses:
+//   - global (see Client docs);
+//   - *apistatus.ContainerNotFound.
+func (c *Client) ContainerGet(ctx context.Context, prm PrmContainerGet) (*ResContainerGet, error) {
+	switch {
+	case ctx == nil:
+		return nil, errorMissingContext
+	case !prm.idSet:
+		return nil, errorMissingContainer
+	}
+
+	var cidV2 refs.ContainerID
+	prm.id.WriteToV2(&cidV2)
+
+	// form request body
+	reqBody := new(v2container.GetRequestBody)
+	reqBody.SetContainerID(&cidV2)
+
+	// form request
+	var req v2container.GetRequest
+
+	req.SetBody(reqBody)
+
+	// init call context
+
+	var (
+		cc  contextCall
+		res ResContainerGet
+	)
+
+	c.initCallContext(&cc)
+	cc.meta = prm.prmCommonMeta
+	cc.req = &req
+	cc.statusRes = &res
+	cc.call = func() (responseV2, error) {
+		return rpcapi.GetContainer(&c.c, &req, client.WithContext(ctx))
+	}
+	cc.result = func(r responseV2) {
+		resp := r.(*v2container.GetResponse)
+
+		cnrV2 := resp.GetBody().GetContainer()
+		if cnrV2 == nil {
+			cc.err = errors.New("missing container in response")
+			return
+		}
+
+		cc.err = res.cnr.ReadFromV2(*cnrV2)
+		if cc.err != nil {
+			cc.err = fmt.Errorf("invalid container in response: %w", cc.err)
+		}
+	}
+
+	// process call
+	if !cc.processCall() {
+		return nil, cc.err
+	}
+
+	return &res, nil
+}