<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:57:37 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[JAVA-2591] Bug report from twitter (outdated comments)</title>
                <link>https://jira.mongodb.org/browse/JAVA-2591</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt; Kfir Bloch @kfirondev&lt;br/&gt;
Dear @MongoDB , why the documentation on java driver contains deprecated function? &lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/blob/master/driver/src/main/com/mongodb/DBCollection.java#L93&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/blob/master/driver/src/main/com/mongodb/DBCollection.java#L93&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&amp;#8212;&lt;/p&gt;

&lt;p&gt;Please review if there are any portions in the driver that have outdated comments.&lt;/p&gt;

&lt;p&gt;thank you.&lt;/p&gt;</description>
                <environment></environment>
        <key id="421820">JAVA-2591</key>
            <summary>Bug report from twitter (outdated comments)</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="13202">Works as Designed</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="jay.gordon">Jay Gordon</reporter>
                        <labels>
                    </labels>
                <created>Wed, 30 Aug 2017 14:17:32 +0000</created>
                <updated>Fri, 27 Oct 2023 13:21:11 +0000</updated>
                            <resolved>Wed, 30 Aug 2017 18:33:13 +0000</resolved>
                                                                                        <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="1663728" author="ross@10gen.com" created="Mon, 4 Sep 2017 10:54:44 +0000"  >&lt;p&gt;I replied back on the twitter post and linked back to this ticket.&lt;/p&gt;</comment>
                            <comment id="1660922" author="jay.gordon" created="Wed, 30 Aug 2017 18:41:27 +0000"  >&lt;p&gt;can you just follow up on your own question?&lt;/p&gt;

&lt;p&gt;thanks!&lt;/p&gt;</comment>
                            <comment id="1660913" author="jeff.yemin" created="Wed, 30 Aug 2017 18:32:55 +0000"  >&lt;p&gt;I see that it&apos;s confusing, but there&apos;s a reason.  The DBCollection javadoc references the deprecated &lt;tt&gt;DB Mongo.getDB(String)&lt;/tt&gt; method because a DB instance is the only way to get an instance of DBCollection.   The question is: why aren&apos;t DB and DBCollection deprecated also?&lt;/p&gt;

&lt;p&gt;When we introduced the new CRUD API (&lt;tt&gt;MongoDatabase MongoClient.getDatabase(String)&lt;/tt&gt;) in the 3.0 driver we had to decide what to do about the existing DB/DBCollection CRUD API.  We wanted to gently nudge people towards the new CRUD API but at the same time not make it &lt;em&gt;too&lt;/em&gt; painful for existing applications to upgrade to the 3.x driver.  We decided the best compromise was to only deprecate the entry point into the old API, which is the &lt;tt&gt;DB Mongo.getDB(String)&lt;/tt&gt; method.  That way applications would get a warning at every entry point, but not on every line of code that used the old API.  So that&apos;s why DBCollection itself is not deprecated, and why its javadoc references a deprecated method.&lt;/p&gt;

&lt;p&gt;I hope this clears it up.  Please let us know if there are any other instances of this besides the one you pointed out.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|ht5opj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>