134 lines
3.9 KiB
Go
134 lines
3.9 KiB
Go
package client
|
|
|
|
import (
|
|
"context"
|
|
|
|
v2object "github.com/nspcc-dev/neofs-api-go/v2/object"
|
|
v2refs "github.com/nspcc-dev/neofs-api-go/v2/refs"
|
|
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"
|
|
cid "github.com/nspcc-dev/neofs-sdk-go/container/id"
|
|
oid "github.com/nspcc-dev/neofs-sdk-go/object/id"
|
|
"github.com/nspcc-dev/neofs-sdk-go/session"
|
|
"github.com/nspcc-dev/neofs-sdk-go/token"
|
|
)
|
|
|
|
// PrmObjectDelete groups parameters of ObjectDelete operation.
|
|
type PrmObjectDelete struct {
|
|
meta v2session.RequestMetaHeader
|
|
|
|
body v2object.DeleteRequestBody
|
|
|
|
addr v2refs.Address
|
|
}
|
|
|
|
// WithinSession specifies session within which object should be read.
|
|
//
|
|
// Creator of the session acquires the authorship of the request.
|
|
// This may affect the execution of an operation (e.g. access control).
|
|
//
|
|
// Must be signed.
|
|
func (x *PrmObjectDelete) WithinSession(t session.Token) {
|
|
x.meta.SetSessionToken(t.ToV2())
|
|
}
|
|
|
|
// WithBearerToken attaches bearer token to be used for the operation.
|
|
//
|
|
// If set, underlying eACL rules will be used in access control.
|
|
//
|
|
// Must be signed.
|
|
func (x *PrmObjectDelete) WithBearerToken(t token.BearerToken) {
|
|
x.meta.SetBearerToken(t.ToV2())
|
|
}
|
|
|
|
// FromContainer specifies NeoFS container of the object.
|
|
// Required parameter.
|
|
func (x *PrmObjectDelete) FromContainer(id cid.ID) {
|
|
x.addr.SetContainerID(id.ToV2())
|
|
}
|
|
|
|
// ByID specifies identifier of the requested object.
|
|
// Required parameter.
|
|
func (x *PrmObjectDelete) ByID(id oid.ID) {
|
|
x.addr.SetObjectID(id.ToV2())
|
|
}
|
|
|
|
// ResObjectDelete groups resulting values of ObjectDelete operation.
|
|
type ResObjectDelete struct {
|
|
statusRes
|
|
|
|
idTomb *v2refs.ObjectID
|
|
}
|
|
|
|
// ReadTombstoneID reads identifier of the created tombstone object.
|
|
// Returns false if ID is missing (not read).
|
|
func (x ResObjectDelete) ReadTombstoneID(dst *oid.ID) bool {
|
|
if x.idTomb != nil {
|
|
*dst = *oid.NewIDFromV2(x.idTomb) // need smth better
|
|
return true
|
|
}
|
|
|
|
return false
|
|
}
|
|
|
|
// ObjectDelete marks an object for deletion from the container using NeoFS API protocol.
|
|
// As a marker, a special unit called a tombstone is placed in the container.
|
|
// It confirms the user's intent to delete the object, and is itself a container object.
|
|
// Explicit deletion is done asynchronously, and is generally not guaranteed.
|
|
//
|
|
// Returns a list of checksums in raw form: the format of hashes and their number
|
|
// is left for the caller to check. Client preserves the order of the server's response.
|
|
//
|
|
// 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 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 PrmObjectDelete docs).
|
|
// Context is required and must not be nil. It is used for network communication.
|
|
//
|
|
// Return statuses:
|
|
// - global (see Client docs).
|
|
func (c *Client) ObjectDelete(ctx context.Context, prm PrmObjectDelete) (*ResObjectDelete, error) {
|
|
switch {
|
|
case ctx == nil:
|
|
panic(panicMsgMissingContext)
|
|
case prm.addr.GetContainerID() == nil:
|
|
panic(panicMsgMissingContainer)
|
|
case prm.addr.GetObjectID() == nil:
|
|
panic("missing object")
|
|
}
|
|
|
|
// form request body
|
|
prm.body.SetAddress(&prm.addr)
|
|
|
|
// form request
|
|
var req v2object.DeleteRequest
|
|
req.SetBody(&prm.body)
|
|
req.SetMetaHeader(&prm.meta)
|
|
|
|
// init call context
|
|
var (
|
|
cc contextCall
|
|
res ResObjectDelete
|
|
)
|
|
|
|
c.initCallContext(&cc)
|
|
cc.req = &req
|
|
cc.statusRes = &res
|
|
cc.call = func() (responseV2, error) {
|
|
return rpcapi.DeleteObject(c.Raw(), &req, client.WithContext(ctx))
|
|
}
|
|
cc.result = func(r responseV2) {
|
|
res.idTomb = r.(*v2object.DeleteResponse).GetBody().GetTombstone().GetObjectID()
|
|
}
|
|
|
|
// process call
|
|
if !cc.processCall() {
|
|
return nil, cc.err
|
|
}
|
|
|
|
return &res, nil
|
|
}
|