213d20e3fb
Define `XPrm` type for each `X` client operation which structures parameters. Export setters of each parameterized value. Emphasize that some parameters are required. Make the client panic when the parameters are incorrectly set. Get rid of vadiadic call options and `CallOption` type. Improve documentation of client behavior. Signed-off-by: Leonard Lyubich <leonard@nspcc.ru>
111 lines
2.9 KiB
Go
111 lines
2.9 KiB
Go
package client
|
|
|
|
import (
|
|
"context"
|
|
|
|
rpcapi "github.com/nspcc-dev/neofs-api-go/v2/rpc"
|
|
"github.com/nspcc-dev/neofs-api-go/v2/rpc/client"
|
|
v2session "github.com/nspcc-dev/neofs-api-go/v2/session"
|
|
"github.com/nspcc-dev/neofs-sdk-go/owner"
|
|
)
|
|
|
|
// CreateSessionPrm groups parameters of CreateSession operation.
|
|
type CreateSessionPrm struct {
|
|
exp uint64
|
|
}
|
|
|
|
// SetExp sets number of the last NepFS epoch in the lifetime of the session after which it will be expired.
|
|
func (x *CreateSessionPrm) SetExp(exp uint64) {
|
|
x.exp = exp
|
|
}
|
|
|
|
// CreateSessionRes groups resulting values of CreateSession operation.
|
|
type CreateSessionRes struct {
|
|
statusRes
|
|
|
|
id []byte
|
|
|
|
sessionKey []byte
|
|
}
|
|
|
|
func (x *CreateSessionRes) setID(id []byte) {
|
|
x.id = id
|
|
}
|
|
|
|
// ID returns identifier of the opened session in a binary NeoFS API protocol format.
|
|
//
|
|
// Client doesn't retain value so modification is safe.
|
|
func (x CreateSessionRes) ID() []byte {
|
|
return x.id
|
|
}
|
|
|
|
func (x *CreateSessionRes) setSessionKey(key []byte) {
|
|
x.sessionKey = key
|
|
}
|
|
|
|
// PublicKey returns public key of the opened session in a binary NeoFS API protocol format.
|
|
func (x CreateSessionRes) PublicKey() []byte {
|
|
return x.sessionKey
|
|
}
|
|
|
|
// CreateSession opens a session with the node server on the remote endpoint.
|
|
// The session lifetime coincides with the server lifetime. Results can be written
|
|
// to session token which can be later attached to the requests.
|
|
//
|
|
// Any client's internal or transport errors are returned as `error`.
|
|
// If WithNeoFSErrorParsing option has been provided, unsuccessful
|
|
// NeoFS status codes are returned as `error`, otherwise, are included
|
|
// in the returned result structure.
|
|
//
|
|
// Immediately panics if parameters are set incorrectly (see CreateSessionPrm docs).
|
|
// Context is required and must not be nil. It is used for network communication.
|
|
//
|
|
// Exactly one return value is non-nil. Server status return is returned in CreateSessionRes.
|
|
// Reflects all internal errors in second return value (transport problems, response processing, etc.).
|
|
func (c *Client) CreateSession(ctx context.Context, prm CreateSessionPrm) (*CreateSessionRes, error) {
|
|
// check context
|
|
if ctx == nil {
|
|
panic(panicMsgMissingContext)
|
|
}
|
|
|
|
ownerID := owner.NewIDFromPublicKey(&c.opts.key.PublicKey)
|
|
|
|
// form request body
|
|
reqBody := new(v2session.CreateRequestBody)
|
|
reqBody.SetOwnerID(ownerID.ToV2())
|
|
reqBody.SetExpiration(prm.exp)
|
|
|
|
// for request
|
|
var req v2session.CreateRequest
|
|
|
|
req.SetBody(reqBody)
|
|
|
|
// init call context
|
|
|
|
var (
|
|
cc contextCall
|
|
res CreateSessionRes
|
|
)
|
|
|
|
c.initCallContext(&cc)
|
|
cc.req = &req
|
|
cc.statusRes = &res
|
|
cc.call = func() (responseV2, error) {
|
|
return rpcapi.CreateSession(c.Raw(), &req, client.WithContext(ctx))
|
|
}
|
|
cc.result = func(r responseV2) {
|
|
resp := r.(*v2session.CreateResponse)
|
|
|
|
body := resp.GetBody()
|
|
|
|
res.setID(body.GetID())
|
|
res.setSessionKey(body.GetSessionKey())
|
|
}
|
|
|
|
// process call
|
|
if !cc.processCall() {
|
|
return nil, cc.err
|
|
}
|
|
|
|
return &res, nil
|
|
}
|