Class DocumentReplaceOptions


  • public final class DocumentReplaceOptions
    extends Object
    Author:
    Mark Vollmary, Michele Rastelli
    • Constructor Detail

      • DocumentReplaceOptions

        public DocumentReplaceOptions()
    • Method Detail

      • getWaitForSync

        public Boolean getWaitForSync()
      • waitForSync

        public DocumentReplaceOptions waitForSync​(Boolean waitForSync)
        Parameters:
        waitForSync - Wait until document has been synced to disk.
        Returns:
        options
      • getIgnoreRevs

        public Boolean getIgnoreRevs()
      • ignoreRevs

        public DocumentReplaceOptions ignoreRevs​(Boolean ignoreRevs)
        Parameters:
        ignoreRevs - By default, or if this is set to true, the _rev attributes in the given document is ignored. If this is set to false, then the _rev attribute given in the body document is taken as a precondition. The document is only replaced if the current revision is the one specified.
        Returns:
        options
      • getIfMatch

        public String getIfMatch()
      • ifMatch

        public DocumentReplaceOptions ifMatch​(String ifMatch)
        Parameters:
        ifMatch - replace a document based on target revision
        Returns:
        options
      • getReturnNew

        public Boolean getReturnNew()
      • returnNew

        public DocumentReplaceOptions returnNew​(Boolean returnNew)
        Parameters:
        returnNew - Return additionally the complete new document under the attribute new in the result.
        Returns:
        options
      • getReturnOld

        public Boolean getReturnOld()
      • returnOld

        public DocumentReplaceOptions returnOld​(Boolean returnOld)
        Parameters:
        returnOld - Return additionally the complete previous revision of the changed document under the attribute old in the result.
        Returns:
        options
      • getSilent

        public Boolean getSilent()
      • silent

        public DocumentReplaceOptions silent​(Boolean silent)
        Parameters:
        silent - If set to true, an empty object will be returned as response. No meta-data will be returned for the created document. This option can be used to save some network traffic.
        Returns:
        options
      • getStreamTransactionId

        public String getStreamTransactionId()
      • streamTransactionId

        public DocumentReplaceOptions streamTransactionId​(String streamTransactionId)
        Parameters:
        streamTransactionId - If set, the operation will be executed within the transaction.
        Returns:
        options
        Since:
        ArangoDB 3.5.0
      • getRefillIndexCaches

        public Boolean getRefillIndexCaches()
      • refillIndexCaches

        public DocumentReplaceOptions refillIndexCaches​(Boolean refillIndexCaches)
        Parameters:
        refillIndexCaches - Whether to update an existing entry in the in-memory edge cache if an edge document is replaced.
        Returns:
        options
        Since:
        ArangoDB 3.11
      • getVersionAttribute

        public String getVersionAttribute()
      • versionAttribute

        public DocumentReplaceOptions versionAttribute​(String versionAttribute)
        You can use the versionAttribute option for external versioning support. If set, the attribute with the name specified by the option is looked up in the stored document and the attribute value is compared numerically to the value of the versioning attribute in the supplied document that is supposed to update/replace it. If the version number in the new document is higher (rounded down to a whole number) than in the document that already exists in the database, then the update/replace operation is performed normally. This is also the case if the new versioning attribute has a non-numeric value, if it is a negative number, or if the attribute doesn't exist in the supplied or stored document. If the version number in the new document is lower or equal to what exists in the database, the operation is not performed and the existing document thus not changed. No error is returned in this case. The attribute can only be a top-level attribute. You can check if _oldRev (if present) and _rev are different to determine if the document has been changed.
        Parameters:
        versionAttribute - the attribute name to use for versioning
        Returns:
        options
        Since:
        ArangoDB 3.12