| {"component":{"kind":"component","name":"mongodb","title":"MongoDB","description":"Perform operations on MongoDB documents and collections.","deprecated":false,"firstVersion":"2.19.0","label":"database,nosql","javaType":"org.apache.camel.component.mongodb.MongoDbComponent","supportLevel":"Stable","groupId":"org.apache.camel","artifactId":"camel-mongodb","version":"3.18.1","scheme":"mongodb","extendsScheme":"","syntax":"mongodb:connectionBean","async":false,"api":false,"consumerOnly":false,"producerOnly":false,"lenientProperties":false},"headers":{"CamelMongoDbOperation":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"org.apache.camel.component.mongodb.MongoDbOperation or String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The operation this endpoint will execute against MongoDB.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#OPERATION_HEADER"},"CamelMongoDbResultTotalSize":{"kind":"header","displayName":"","group":"producer findAll","label":"producer findAll","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Number of objects matching the query. This does not take limit/skip into consideration.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#RESULT_TOTAL_SIZE"},"CamelMongoDbResultPageSize":{"kind":"header","displayName":"","group":"producer findAll","label":"producer findAll","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Number of objects matching the query. This does not take limit/skip into consideration.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#RESULT_PAGE_SIZE"},"CamelMongoDbCriteria":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"org.bson.conversions.Bson","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The query to execute against MongoDB.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#CRITERIA"},"CamelMongoDbFieldsProjection":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"org.bson.conversions.Bson","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The project document.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#FIELDS_PROJECTION"},"CamelMongoDbBatchSize":{"kind":"header","displayName":"","group":"producer findAll aggregate","label":"producer findAll aggregate","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The number of documents per batch.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#BATCH_SIZE"},"CamelMongoDbNumToSkip":{"kind":"header","displayName":"","group":"producer findAll","label":"producer findAll","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Discards a given number of elements at the beginning of the cursor.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#NUM_TO_SKIP"},"CamelMongoDbMultiUpdate":{"kind":"header","displayName":"","group":"producer update","label":"producer update","required":false,"javaType":"Boolean","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"If the update should be applied to all objects matching. See http://www.mongodb.org/display/DOCS/AtomicOperationsAtomic Operations","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#MULTIUPDATE"},"CamelMongoDbUpsert":{"kind":"header","displayName":"","group":"producer update","label":"producer update","required":false,"javaType":"Boolean","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"If the database should create the element if it does not exist","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#UPSERT"},"CamelMongoDbRecordsAffected":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"long","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The number of modified or deleted records","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#RECORDS_AFFECTED"},"CamelMongoDbRecordsMatched":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"long","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The number of documents matched by the query.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#RECORDS_MATCHED"},"CamelMongoDbSortBy":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"Bson or Document","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The sort criteria.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#SORT_BY"},"CamelMongoDbDatabase":{"kind":"header","displayName":"","group":"common","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The name of the MongoDB database to target","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#DATABASE"},"CamelMongoDbCollection":{"kind":"header","displayName":"","group":"common","label":"","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The name of the MongoDB collection to bind to this endpoint","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#COLLECTION"},"CamelMongoDbCollectionIndex":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"List<Bson>","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The list of dynamic indexes to create on the fly","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#COLLECTION_INDEX"},"CamelMongoDbLimit":{"kind":"header","displayName":"","group":"producer findAll","label":"producer findAll","required":false,"javaType":"Integer","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Limits the number of elements returned.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#LIMIT"},"CamelMongoDbTailable":{"kind":"header","displayName":"","group":"consumer","label":"consumer","required":false,"javaType":"Boolean","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Is from tailable","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#FROM_TAILABLE"},"CamelMongoWriteResult":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"Object","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The result of the write operation","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#WRITERESULT"},"CamelMongoOid":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"Object or List<Object>","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The OID(s) of the inserted record(s)","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#OID"},"CamelMongoDbDistinctQueryField":{"kind":"header","displayName":"","group":"producer","label":"producer","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The specified field name fow which we want to get the distinct values.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#DISTINCT_QUERY_FIELD"},"CamelMongoDbAllowDiskUse":{"kind":"header","displayName":"","group":"producer findAll aggregate","label":"producer findAll aggregate","required":false,"javaType":"Boolean","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Sets allowDiskUse MongoDB flag. This is supported since MongoDB Server 4.3.1. Using this header with older MongoDB Server version can cause query to fail.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#ALLOW_DISK_USE"},"CamelMongoDbBulkOrdered":{"kind":"header","displayName":"","group":"producer bulkWrite","label":"producer bulkWrite","required":false,"javaType":"Boolean","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"defaultValue":"TRUE","description":"Perform an ordered or unordered operation execution.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#BULK_ORDERED"},"_id":{"kind":"header","displayName":"","group":"consumer changeStreams","label":"consumer changeStreams","required":false,"javaType":"org.bson.types.ObjectId","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"A document that contains the _id of the document created or modified by the insert, replace, delete, update operations (i.e. CRUD operations). For sharded collections, also displays the full shard key for the document. The _id field is not repeated if it is already a part of the shard key.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#MONGO_ID"},"CamelMongoDbStreamOperationType":{"kind":"header","displayName":"","group":"consumer changeStreams","label":"consumer changeStreams","required":false,"javaType":"String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"The type of operation that occurred. Can be any of the following values: insert, delete, replace, update, drop, rename, dropDatabase, invalidate.","constantName":"org.apache.camel.component.mongodb.MongoDbConstants#STREAM_OPERATION_TYPE"}},"properties":{"connectionBean":{"kind":"path","displayName":"Connection Bean","group":"common","label":"","required":true,"type":"string","javaType":"java.lang.String","deprecated":false,"deprecationNote":"","autowired":false,"secret":false,"description":"Sets the connection bean reference used to lookup a client for connecting to a database if no hosts parameter is present."},"collection":{"kind":"parameter","displayName":"Collection","group":"common","label":"","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Sets the name of the MongoDB collection to bind to this endpoint"},"collectionIndex":{"kind":"parameter","displayName":"Collection Index","group":"common","label":"","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Sets the collection index (JSON FORMAT : { field1 : order1, field2 : order2})"},"createCollection":{"kind":"parameter","displayName":"Create Collection","group":"common","label":"","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":true,"description":"Create collection during initialisation if it doesn't exist. Default is true."},"database":{"kind":"parameter","displayName":"Database","group":"common","label":"","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Sets the name of the MongoDB database to target"},"hosts":{"kind":"parameter","displayName":"Hosts","group":"common","label":"","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Host address of mongodb server in host:port format. It's possible also use more than one address, as comma separated list of hosts: host1:port1,host2:port2. If the hosts parameter is specified, the provided connectionBean is ignored."},"mongoConnection":{"kind":"parameter","displayName":"Mongo Connection","group":"common","label":"","required":false,"type":"object","javaType":"com.mongodb.client.MongoClient","deprecated":false,"autowired":false,"secret":false,"description":"Sets the connection bean used as a client for connecting to a database."},"operation":{"kind":"parameter","displayName":"Operation","group":"common","label":"","required":false,"type":"object","javaType":"org.apache.camel.component.mongodb.MongoDbOperation","enum":["findById","findOneByQuery","findAll","findDistinct","insert","save","update","remove","bulkWrite","aggregate","getDbStats","getColStats","count","command"],"deprecated":false,"autowired":false,"secret":false,"description":"Sets the operation this endpoint will execute against MongoDB."},"outputType":{"kind":"parameter","displayName":"Output Type","group":"common","label":"common","required":false,"type":"object","javaType":"org.apache.camel.component.mongodb.MongoDbOutputType","enum":["DocumentList","Document","MongoIterable"],"deprecated":false,"autowired":false,"secret":false,"description":"Convert the output of the producer to the selected type : DocumentList Document or MongoIterable. DocumentList or MongoIterable applies to findAll and aggregate. Document applies to all other operations."},"consumerType":{"kind":"parameter","displayName":"Consumer Type","group":"consumer","label":"consumer","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Consumer type."},"bridgeErrorHandler":{"kind":"parameter","displayName":"Bridge Error Handler","group":"consumer (advanced)","label":"consumer,advanced","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored."},"exceptionHandler":{"kind":"parameter","displayName":"Exception Handler","group":"consumer (advanced)","label":"consumer,advanced","required":false,"type":"object","javaType":"org.apache.camel.spi.ExceptionHandler","optionalPrefix":"consumer.","deprecated":false,"autowired":false,"secret":false,"description":"To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this option is not in use. By default the consumer will deal with exceptions, that will be logged at WARN or ERROR level and ignored."},"exchangePattern":{"kind":"parameter","displayName":"Exchange Pattern","group":"consumer (advanced)","label":"consumer,advanced","required":false,"type":"object","javaType":"org.apache.camel.ExchangePattern","enum":["InOnly","InOut","InOptionalOut"],"deprecated":false,"autowired":false,"secret":false,"description":"Sets the exchange pattern when the consumer creates an exchange."},"lazyStartProducer":{"kind":"parameter","displayName":"Lazy Start Producer","group":"producer (advanced)","label":"producer,advanced","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"Whether the producer should be started lazy (on the first message). By starting lazy you can use this to allow CamelContext and routes to startup in situations where a producer may otherwise fail during starting and cause the route to fail being started. By deferring this startup to be lazy then the startup failure can be handled during routing messages via Camel's routing error handlers. Beware that when the first message is processed then creating and starting the producer may take a little time and prolong the total processing time of the processing."},"cursorRegenerationDelay":{"kind":"parameter","displayName":"Cursor Regeneration Delay","group":"advanced","label":"advanced","required":false,"type":"duration","javaType":"long","deprecated":false,"autowired":false,"secret":false,"defaultValue":"1000","description":"MongoDB tailable cursors will block until new data arrives. If no new data is inserted, after some time the cursor will be automatically freed and closed by the MongoDB server. The client is expected to regenerate the cursor if needed. This value specifies the time to wait before attempting to fetch a new cursor, and if the attempt fails, how long before the next attempt is made. Default value is 1000ms."},"dynamicity":{"kind":"parameter","displayName":"Dynamicity","group":"advanced","label":"advanced","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"Sets whether this endpoint will attempt to dynamically resolve the target database and collection from the incoming Exchange properties. Can be used to override at runtime the database and collection specified on the otherwise static endpoint URI. It is disabled by default to boost performance. Enabling it will take a minimal performance hit."},"readPreference":{"kind":"parameter","displayName":"Read Preference","group":"advanced","label":"advanced","required":false,"type":"string","javaType":"java.lang.String","enum":["PRIMARY","PRIMARY_PREFERRED","SECONDARY","SECONDARY_PREFERRED","NEAREST"],"deprecated":false,"autowired":false,"secret":false,"defaultValue":"PRIMARY","description":"Configure how MongoDB clients route read operations to the members of a replica set. Possible values are PRIMARY, PRIMARY_PREFERRED, SECONDARY, SECONDARY_PREFERRED or NEAREST"},"writeConcern":{"kind":"parameter","displayName":"Write Concern","group":"advanced","label":"advanced","required":false,"type":"string","javaType":"java.lang.String","enum":["ACKNOWLEDGED","W1","W2","W3","UNACKNOWLEDGED","JOURNALED","MAJORITY"],"deprecated":false,"autowired":false,"secret":false,"defaultValue":"ACKNOWLEDGED","description":"Configure the connection bean with the level of acknowledgment requested from MongoDB for write operations to a standalone mongod, replicaset or cluster. Possible values are ACKNOWLEDGED, W1, W2, W3, UNACKNOWLEDGED, JOURNALED or MAJORITY."},"writeResultAsHeader":{"kind":"parameter","displayName":"Write Result As Header","group":"advanced","label":"advanced","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"In write operations, it determines whether instead of returning WriteResult as the body of the OUT message, we transfer the IN message to the OUT and attach the WriteResult as a header."},"streamFilter":{"kind":"parameter","displayName":"Stream Filter","group":"changeStream","label":"consumer,changeStream","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Filter condition for change streams consumer."},"authSource":{"kind":"parameter","displayName":"Auth Source","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"The database name associated with the user's credentials."},"password":{"kind":"parameter","displayName":"Password","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":true,"description":"User password for mongodb connection"},"username":{"kind":"parameter","displayName":"Username","group":"security","label":"security","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":true,"description":"Username for mongodb connection"},"persistentId":{"kind":"parameter","displayName":"Persistent Id","group":"tail","label":"consumer,tail","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"One tail tracking collection can host many trackers for several tailable consumers. To keep them separate, each tracker should have its own unique persistentId."},"persistentTailTracking":{"kind":"parameter","displayName":"Persistent Tail Tracking","group":"tail","label":"consumer,tail","required":false,"type":"boolean","javaType":"boolean","deprecated":false,"autowired":false,"secret":false,"defaultValue":false,"description":"Enable persistent tail tracking, which is a mechanism to keep track of the last consumed message across system restarts. The next time the system is up, the endpoint will recover the cursor from the point where it last stopped slurping records."},"tailTrackCollection":{"kind":"parameter","displayName":"Tail Track Collection","group":"tail","label":"consumer,tail","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Collection where tail tracking information will be persisted. If not specified, MongoDbTailTrackingConfig#DEFAULT_COLLECTION will be used by default."},"tailTrackDb":{"kind":"parameter","displayName":"Tail Track Db","group":"tail","label":"consumer,tail","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Indicates what database the tail tracking mechanism will persist to. If not specified, the current database will be picked by default. Dynamicity will not be taken into account even if enabled, i.e. the tail tracking database will not vary past endpoint initialisation."},"tailTrackField":{"kind":"parameter","displayName":"Tail Track Field","group":"tail","label":"consumer,tail","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Field where the last tracked value will be placed. If not specified, MongoDbTailTrackingConfig#DEFAULT_FIELD will be used by default."},"tailTrackIncreasingField":{"kind":"parameter","displayName":"Tail Track Increasing Field","group":"tail","label":"consumer,tail","required":false,"type":"string","javaType":"java.lang.String","deprecated":false,"autowired":false,"secret":false,"description":"Correlation field in the incoming record which is of increasing nature and will be used to position the tailing cursor every time it is generated. The cursor will be (re)created with a query of type: tailTrackIncreasingField greater than lastValue (possibly recovered from persistent tail tracking). Can be of type Integer, Date, String, etc. NOTE: No support for dot notation at the current time, so the field should be at the top level of the document."}}} |