Method handleGetAttachment

db/blip_handler.go:1473–1522

Received a "getAttachment" request

(rq *blip.Message)

// Received a "getAttachment" request
func (bh *blipHandler) handleGetAttachment(rq *blip.Message) error {

	getAttachmentParams := newGetAttachmentParams(rq)
	bh.logEndpointEntry(rq.Profile(), getAttachmentParams.String())

	digest := getAttachmentParams.digest()
	if digest == "" {
		return base.HTTPErrorf(http.StatusBadRequest, "Missing 'digest'")
	}

	docID := ""
	attachmentAllowedKey := digest
	if bh.activeCBMobileSubprotocol >= CBMobileReplicationV3 {
		docID = getAttachmentParams.docID()
		if docID == "" {
			return base.HTTPErrorf(http.StatusBadRequest, "Missing 'docID'")
		}
		attachmentAllowedKey = docID + digest
	}

	// attachmentName should only be used for logging, it is one possible name of an attachment for a given document if multiple attachments share the same digest.
	allowedAttachment := bh.allowedAttachment(attachmentAllowedKey)
	if allowedAttachment.counter <= 0 {
		return base.HTTPErrorf(http.StatusForbidden, "Attachment's doc not being synced")
	}

	if bh.activeCBMobileSubprotocol <= CBMobileReplicationV2 {
		docID = allowedAttachment.docID
	}

	attachmentKey := MakeAttachmentKey(allowedAttachment.version, docID, digest)
	attachment, err := bh.collection.GetAttachment(attachmentKey)
	if err != nil {
		return err

	}
	base.DebugfCtx(bh.loggingCtx, base.KeySync, "Sending attachment with digest=%q (%.2f KB)", digest, float64(len(attachment))/float64(1024))
	response := rq.Response()
	response.SetBody(attachment)
	response.SetCompressed(rq.Properties[BlipCompress] == trueProperty)
	bh.replicationStats.HandleGetAttachment.Add(1)
	bh.replicationStats.HandleGetAttachmentBytes.Add(int64(len(attachment)))
	base.Audit(bh.loggingCtx, base.AuditIDAttachmentRead, base.AuditFields{
		base.AuditFieldDocID:        docID,
		base.AuditFieldDocVersion:   allowedAttachment.docVersion,
		base.AuditFieldAttachmentID: allowedAttachment.name,
	})

	return nil
}

var errNoBlipHandler = fmt.Errorf("404 - No handler for BLIP request")