Skip to content

Commit 8a8e74c

Browse files
author
Chris Cho
authored
DOCSP-2157 Java reactive streams driver page (#617)
* DOCSP-2157: Add Java Reactive Streams Pages to drivers list
1 parent aa15e4b commit 8a8e74c

File tree

5 files changed

+349
-1
lines changed

5 files changed

+349
-1
lines changed

‎source/drivers.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ For information on MongoDB licensing, see `MongoDB Licensing
3636
C++ Driver </drivers/cxx>
3737
C# and .NET Driver </drivers/csharp>
3838
Go Driver </drivers/go>
39-
Java Driver </drivers/java>
39+
Java Drivers </drivers/java-drivers>
4040
Node.js Driver </drivers/node>
4141
Perl Driver </drivers/perl>
4242
PHP Driver </drivers/php>

‎source/drivers/java-drivers.txt‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
.. _java-language-center:
2+
3+
====================
4+
Java MongoDB Drivers
5+
====================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 1
13+
14+
Introduction
15+
------------
16+
17+
:doc:`Java Driver </drivers/java>` is the recommended MongoDB Java Driver.
18+
19+
For asynchronous stream processing and reactive streams interoperability,
20+
the :doc:`Reactive Streams Driver </drivers/reactive-streams>` is the
21+
recommended MongoDB Java Driver.
22+
23+
Take the free online course taught by MongoDB
24+
---------------------------------------------
25+
26+
.. list-table::
27+
28+
* - .. cssclass:: bordered-figure
29+
.. figure:: /figures/M220J_hero.jpg
30+
31+
- `M220J: MongoDB for Java Developers <https://university.mongodb.com/courses/M220J/about>`__
32+
33+
Learn the essentials of Java application development with MongoDB.
34+
35+
.. class:: hidden
36+
37+
.. toctree::
38+
:titlesonly:
39+
40+
/drivers/java.txt
41+
/drivers/reactive-streams.txt

‎source/drivers/reactive-streams.txt‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
.. include:: /includes/unicode-checkmark.rst
2+
3+
=============================
4+
MongoDB Java Reactive Streams
5+
=============================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 1
13+
:class: twocols
14+
15+
Introduction
16+
------------
17+
18+
**Java Reactive Streams** is an official Java driver for MongoDB and is the
19+
recommended driver for working with reactive streams in the JVM ecosystem.
20+
21+
- `Tutorials
22+
<http://mongodb.github.io/mongo-java-driver/4.0/driver-reactive/tutorials/>`_
23+
24+
- `Usage Guide
25+
<http://mongodb.github.io/mongo-java-driver/4.0/driver-reactive/>`_
26+
27+
- `API Reference
28+
<https://mongodb.github.io/mongo-java-driver-reactivestreams/1.13/javadoc/>`_
29+
30+
- `Changelog
31+
<https://mongodb.github.io/mongo-java-driver-reactivestreams/1.13/changelog/>`_
32+
33+
- `Source Code
34+
<https://github.com/mongodb/mongo-java-driver-reactivestreams/>`_
35+
36+
Installation
37+
------------
38+
39+
The recommended way to get started using the driver in your project is with
40+
a dependency management system.
41+
See the `Installation Guide
42+
<http://mongodb.github.io/mongo-java-driver-reactivestreams/1.13/getting-started/installation-guide/>`_
43+
for more information.
44+
45+
Connect to MongoDB Atlas
46+
------------------------
47+
48+
To connect to a :atlas:`MongoDB Atlas </>` cluster, use the :atlas:`Atlas
49+
connection string </driver-connection>` for your cluster:
50+
51+
.. code-block:: java
52+
53+
import com.mongodb.ConnectionString;
54+
import com.mongodb.client.MongoClients;
55+
import com.mongodb.client.MongoClient;
56+
import com.mongodb.client.MongoDatabase;
57+
import com.mongodb.MongoClientSettings;
58+
59+
// ...
60+
ConnectionString connString = new ConnectionString(
61+
"mongodb+srv://<username>:<password>@<cluster-address>/test?w=majority"
62+
);
63+
MongoClientSettings settings = MongoClientSettings.builder()
64+
.applyConnectionString(connString)
65+
.retryWrites(true)
66+
.build();
67+
MongoClient mongoClient = MongoClients.create(settings);
68+
MongoDatabase database = mongoClient.getDatabase("test");
69+
70+
See `Connect to MongoDB
71+
<http://mongodb.github.io/mongo-java-driver/4.0/driver-reactive/tutorials/>`_
72+
for more ways to connect.
73+
74+
Compatibility
75+
-------------
76+
77+
MongoDB Compatibility
78+
~~~~~~~~~~~~~~~~~~~~~
79+
80+
.. include:: /includes/mongodb-compatibility-table-java-rs.rst
81+
82+
.. include:: /includes/older-server-versions-unsupported.rst
83+
84+
Language Compatibility
85+
~~~~~~~~~~~~~~~~~~~~~~
86+
87+
.. include:: /includes/extracts/java-rs-driver-compatibility-matrix-language.rst
88+
89+
.. include:: /includes/language-compatibility-table-java-rs.rst
90+
91+
How to get help
92+
---------------
93+
94+
- Join our `Google Group <http://groups.google.com/group/mongodb-user>`_.
95+
- Ask on `Stack Overflow
96+
<https://stackoverflow.com/questions/tagged/mongodb%20java%20reactive>`_.
97+
- Visit our `Support Channels <http://www.mongodb.org/about/support>`_.
98+
- See :java-docs-latest:`Issues & Help <issues-help/>`.

‎source/includes/language-compatibility-table-java-rs.rst‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
.. list-table::
2+
:header-rows: 1
3+
:stub-columns: 1
4+
:class: compatibility-large
5+
6+
* - Java Reactive Streams Driver Version
7+
- Java 6
8+
- Java 7
9+
- Java 8
10+
- Java 11 [*]_
11+
12+
* - 1.13
13+
- |checkmark|
14+
- |checkmark|
15+
- |checkmark|
16+
- |checkmark|
17+
18+
* - 1.12
19+
- |checkmark|
20+
- |checkmark|
21+
- |checkmark|
22+
- |checkmark|
23+
24+
* - 1.11
25+
- |checkmark|
26+
- |checkmark|
27+
- |checkmark|
28+
- |checkmark|
29+
30+
* - 1.10
31+
- |checkmark|
32+
- |checkmark|
33+
- |checkmark|
34+
- |checkmark|
35+
36+
* - 1.9
37+
- |checkmark|
38+
- |checkmark|
39+
- |checkmark|
40+
- |checkmark|
41+
42+
* - 1.7
43+
- |checkmark|
44+
- |checkmark|
45+
- |checkmark|
46+
- |checkmark|
47+
48+
* - 1.6
49+
- |checkmark|
50+
- |checkmark|
51+
- |checkmark|
52+
- |checkmark|
53+
54+
* - 1.5
55+
- |checkmark|
56+
- |checkmark|
57+
- |checkmark|
58+
- |checkmark|
59+
60+
* - 1.3
61+
- |checkmark|
62+
- |checkmark|
63+
- |checkmark|
64+
- |checkmark|
65+
66+
* - 1.2
67+
- |checkmark|
68+
- |checkmark|
69+
- |checkmark|
70+
- |checkmark|
71+
72+
* - 1.1
73+
- |checkmark|
74+
- |checkmark|
75+
- |checkmark|
76+
- |checkmark|
77+
78+
* - 1.0
79+
- |checkmark|
80+
- |checkmark|
81+
- |checkmark|
82+
- |checkmark|
83+
84+
.. [*] Java versions 8 and above are all supported thanks to the JVM backwards compatibility promise. Only LTS versions will be explicitly listed in future.

‎source/includes/mongodb-compatibility-table-java-rs.rst‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
.. include:: /includes/extracts/java-driver-compatibility-matrix-mongodb.rst
2+
3+
.. list-table::
4+
:header-rows: 1
5+
:stub-columns: 1
6+
:class: compatibility-large
7+
8+
* - Java Reactive Streams Driver Version
9+
- MongoDB 4.2
10+
- MongoDB 4.0
11+
- MongoDB 3.6
12+
- MongoDB 3.4
13+
- MongoDB 3.2
14+
- MongoDB 3.0
15+
- MongoDB 2.6
16+
17+
* - 1.13
18+
- |checkmark|
19+
- |checkmark|
20+
- |checkmark|
21+
- |checkmark|
22+
- |checkmark|
23+
- |checkmark|
24+
- |checkmark|
25+
26+
* - 1.12
27+
- |checkmark|
28+
- |checkmark|
29+
- |checkmark|
30+
- |checkmark|
31+
- |checkmark|
32+
- |checkmark|
33+
- |checkmark|
34+
35+
* - 1.11
36+
-
37+
- |checkmark|
38+
- |checkmark|
39+
- |checkmark|
40+
- |checkmark|
41+
- |checkmark|
42+
- |checkmark|
43+
44+
* - 1.10
45+
-
46+
- |checkmark|
47+
- |checkmark|
48+
- |checkmark|
49+
- |checkmark|
50+
- |checkmark|
51+
- |checkmark|
52+
53+
* - 1.9
54+
-
55+
- |checkmark|
56+
- |checkmark|
57+
- |checkmark|
58+
- |checkmark|
59+
- |checkmark|
60+
- |checkmark|
61+
62+
* - 1.7
63+
-
64+
-
65+
- |checkmark|
66+
- |checkmark|
67+
- |checkmark|
68+
- |checkmark|
69+
- |checkmark|
70+
71+
* - 1.6
72+
-
73+
-
74+
-
75+
- |checkmark|
76+
- |checkmark|
77+
- |checkmark|
78+
- |checkmark|
79+
80+
* - 1.5
81+
-
82+
-
83+
-
84+
- |checkmark|
85+
- |checkmark|
86+
- |checkmark|
87+
- |checkmark|
88+
89+
* - 1.3
90+
-
91+
-
92+
-
93+
- |checkmark|
94+
- |checkmark|
95+
- |checkmark|
96+
- |checkmark|
97+
98+
99+
* - 1.2
100+
-
101+
-
102+
-
103+
-
104+
- |checkmark|
105+
- |checkmark|
106+
- |checkmark|
107+
108+
109+
* - 1.1
110+
-
111+
-
112+
-
113+
-
114+
-
115+
- |checkmark|
116+
- |checkmark|
117+
118+
* - 1.0
119+
-
120+
-
121+
-
122+
-
123+
-
124+
- |checkmark|
125+
- |checkmark|

0 commit comments

Comments
 (0)