Package com.mongodb

Class InsertOptions


  • public final class InsertOptions
extends Object
    Options related to insertion of documents into MongoDB. The setter methods return this so that a chaining style can be used.
    Since:
    2.13
    MongoDB documentation
    Insert Tutorial

    • Constructor Detail

      • InsertOptions

        public InsertOptions​()

    • Method Detail

      • writeConcern

        public InsertOptions writeConcern​(@Nullable
                                  WriteConcern writeConcern)
        Set the write concern to use for the insert.
        Parameters:
        writeConcern - the write concern
        Returns:
        this

      • continueOnError

        public InsertOptions continueOnError​(boolean continueOnError)
        Set whether documents will continue to be inserted after a failure to insert one.
        Parameters:
        continueOnError - whether to continue on error
        Returns:
        this

      • dbEncoder

        public InsertOptions dbEncoder​(@Nullable
                               DBEncoder dbEncoder)
        Set the encoder to use for the documents.
        Parameters:
        dbEncoder - the encoder
        Returns:
        this

      • getWriteConcern

        @Nullable
public WriteConcern getWriteConcern​()
        The write concern to use for the insertion. By default the write concern configured for the DBCollection instance will be used.
        Returns:
        the write concern, or null if the default will be used.

      • isContinueOnError

        public boolean isContinueOnError​()
        Whether documents will continue to be inserted after a failure to insert one (most commonly due to a duplicate key error). Note that this only is relevant for multi-document inserts. The default value is false.
        Returns:
        whether insertion will continue on error.

      • getDbEncoder

        @Nullable
public DBEncoder getDbEncoder​()
        The encoder to use for the documents. By default the codec configured for the DBCollection instance will be used.
        Returns:
        the encoder, or null if the default will be used

      • getBypassDocumentValidation

        @Nullable
public Boolean getBypassDocumentValidation​()
        Gets whether to bypass document validation, or null if unspecified. The default is null.
        Returns:
        whether to bypass document validation, or null if unspecified.
        Since:
        2.14
        Since server release
        3.2

      • bypassDocumentValidation

        public InsertOptions bypassDocumentValidation​(@Nullable
                                              Boolean bypassDocumentValidation)
        Sets whether to bypass document validation.
        Parameters:
        bypassDocumentValidation - whether to bypass document validation, or null if unspecified
        Returns:
        this
        Since:
        2.14
        Since server release
        3.2