MongoDB Reactive Streams Java Driver
A reactive streams implementation of the Mongo Java Driver.
Documentation for all the main versions is available on http://mongodb.github.io/mongo-java-driver-reactivestreams
Support / Feedback
For issues with, questions about, or feedback for the MongoDB Java driver, please look into our support channels. Please do not email any of the Java driver developers directly with issues or questions - you're more likely to get an answer on the [mongodb-user] (http://groups.google.com/group/mongodb-user) list on Google Groups.
At a minimum, please include in your description the exact version of the driver that you are using. If you are having connectivity issues, it's often also useful to paste in the line of code where you construct the MongoClient instance, along with the values of all parameters that you pass to the constructor. You should also check your application logs for any connectivity-related exceptions and post those as well.
Bugs / Feature Requests
Think you’ve found a bug? Want to see a new feature in the Java driver? Please open a case in our issue management tool, JIRA:
- Create an account and login.
- Navigate to the JAVARS project.
- Click Create Issue - Please provide as much information as possible about the issue type and how to reproduce it.
Bug reports in JIRA for the driver and the Core Server (i.e. SERVER) project are public.
If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the [instructions here] (http://docs.mongodb.org/manual/tutorial/create-a-vulnerability-report).
Major increments (such as 1.x -> 2.x) will occur when break changes are being made to the public API. All methods and classes removed in a major release will have been deprecated in a prior release of the previous major release branch, and/or otherwise called out in the release notes.
Minor 1.x increments (such as 1.1, 1.2, etc) will occur when non-trivial new functionality is added or significant enhancements or bug fixes occur that may have behavioral changes that may affect some edge cases (such as dependence on behavior resulting from a bug). An example of an enhancement is a method or class added to support new functionality added to the MongoDB server. Minor releases will almost always be binary compatible with prior minor releases from the same major release branch, exept as noted below.
Patch 1.x.y increments (such as 1.0.0 -> 1.0.1, 1.1.1 -> 1.1.2, etc) will occur for bug fixes only and will always be binary compatible with prior patch releases of the same minor release branch.
APIs marked with the
@Beta annotation at the class or method level are subject to change. They can be modified in any way, or even
removed, at any time. If your code is a library itself (i.e. it is used on the CLASSPATH of users outside your own control), you should not
use beta APIs, unless you repackage them (e.g. by using shading, etc).
APIs marked with the
@Deprecated annotation at the class or method level will remain supported until the next major release but it is
recommended to stop using them.
Binaries and dependency information for Maven, Gradle, Ivy and others can be found at http://search.maven.org.
Example for Maven:
<dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-driver-reactivestreams</artifactId> <version>x.y.z</version> </dependency>
Snapshot builds are also published regularly via Sonatype.
Example for Maven:
<repositories> <repository> <id>sonatype-snapshot</id> <url>https://oss.sonatype.org/content/repositories/snapshots/</url> </repository> </repositories>
To build the driver:
$ git clone https://github.com/mongodb/mongo-java-driver-reactivestreams.git $ cd mongo-java-driver-reactivestreams $ ./gradlew check
Some manual configuration steps are required to run the code in IntelliJ:
java: package com.mongodb.reactivestreams.client.internal.build does not exist
Fixes: Any of the following:
- Run the
./gradlew compileBuildConfigor via Gradle > driver-core > Tasks > other > compileBuildConfig
compileBuildConfigto execute Before Build. via Gradle > Tasks > other > right click compileBuildConfig - click on "Execute Before Build"
- Delegate all build actions to Gradle: Settings > Build, Execution, Deployment > Build Tools > Gradle > Runner - tick "Delegate IDE build/run actions to gradle"
Additional contributors can be found here.
YourKit is supporting this open source project with its YourKit Java Profiler.
JetBrains is supporting this open source project with: