<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:54:46 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-1502] BSONObject et al.: wrong return value in JavaDoc for put(k,v)</title>
                <link>https://jira.mongodb.org/browse/JAVA-1502</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt;&lt;tt&gt;BSONObject&lt;/tt&gt;, &lt;tt&gt;BasicBSONObject&lt;/tt&gt;, etc. claim to return the value passed to it, but they appear to rely on java.util.HashMap which returns the &lt;b&gt;previous&lt;/b&gt; value: &lt;a href=&quot;http://docs.oracle.com/javase/7/docs/api/java/util/HashMap.html#put(K,%20V&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.oracle.com/javase/7/docs/api/java/util/HashMap.html#put(K,%20V&lt;/a&gt;)&lt;/p&gt;

&lt;p&gt;example of JavaDoc of BSONObject, BasicBSONObject, ...:&lt;br/&gt;
{{&lt;br/&gt;
@return &amp;lt;tt&amp;gt;v&amp;lt;/tt&amp;gt;&lt;br/&gt;
@return the &amp;lt;code&amp;gt;val&amp;lt;/code&amp;gt; parameter&lt;br/&gt;
}}&lt;/p&gt;

&lt;p&gt;P.s.: I was actually hoping it would return the BSONObject itself so I could chain put() operations together&lt;/p&gt;</description>
                <environment></environment>
        <key id="163902">JAVA-1502</key>
            <summary>BSONObject et al.: wrong return value in JavaDoc for put(k,v)</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</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="9">Done</resolution>
                                        <assignee username="jeff.yemin@mongodb.com">Jeffrey Yemin</assignee>
                                    <reporter username="jgrivolla">Jens Grivolla</reporter>
                        <labels>
                    </labels>
                <created>Thu, 16 Oct 2014 09:36:07 +0000</created>
                <updated>Fri, 30 Jan 2015 18:44:11 +0000</updated>
                            <resolved>Mon, 27 Oct 2014 16:35:04 +0000</resolved>
                                    <version>2.12.3</version>
                                    <fixVersion>2.13.0</fixVersion>
                    <fixVersion>3.0.0</fixVersion>
                                    <component>Documentation</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="817965" author="xgen-internal-githook" created="Fri, 30 Jan 2015 18:44:11 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;jyemin&apos;, u&apos;name&apos;: u&apos;Jeff Yemin&apos;, u&apos;email&apos;: u&apos;jeff.yemin@10gen.com&apos;}
&lt;p&gt;Message: Fixed documentation of return value for BSONObject.put to indicate that it returns the previous value associated with the given key.&lt;/p&gt;

&lt;p&gt;  &lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-1502&quot; title=&quot;BSONObject et al.: wrong return value in JavaDoc for put(k,v)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-1502&quot;&gt;&lt;del&gt;JAVA-1502&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/af69a7948160482469babaee56e484a5c5e7e462&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/af69a7948160482469babaee56e484a5c5e7e462&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="749369" author="xgen-internal-githook" created="Mon, 27 Oct 2014 16:34:58 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;jyemin&apos;, u&apos;name&apos;: u&apos;Jeff Yemin&apos;, u&apos;email&apos;: u&apos;jeff.yemin@10gen.com&apos;}
&lt;p&gt;Message: Fixed documentation of return value for BSONObject.put to indicate that it returns the previous value associated with the given key.&lt;/p&gt;

&lt;p&gt;  &lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-1502&quot; title=&quot;BSONObject et al.: wrong return value in JavaDoc for put(k,v)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-1502&quot;&gt;&lt;del&gt;JAVA-1502&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: 3.0.x&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/af69a7948160482469babaee56e484a5c5e7e462&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/af69a7948160482469babaee56e484a5c5e7e462&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="749262" author="xgen-internal-githook" created="Mon, 27 Oct 2014 15:16:00 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;jyemin&apos;, u&apos;name&apos;: u&apos;Jeff Yemin&apos;, u&apos;email&apos;: u&apos;jeff.yemin@10gen.com&apos;}
&lt;p&gt;Message: Fixed documentation of return value for  BSONObject.put to indicate that it returns the previous value associated with the given key.&lt;br/&gt;
Also fixed some Javadoc in BSONObject implementations.&lt;/p&gt;

&lt;p&gt;  &lt;a href=&quot;https://jira.mongodb.org/browse/JAVA-1502&quot; title=&quot;BSONObject et al.: wrong return value in JavaDoc for put(k,v)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;JAVA-1502&quot;&gt;&lt;del&gt;JAVA-1502&lt;/del&gt;&lt;/a&gt;&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-java-driver/commit/2c0c54226ca33afe0add3be23abc14c643e4fe6d&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-java-driver/commit/2c0c54226ca33afe0add3be23abc14c643e4fe6d&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="742715" author="jeff.yemin" created="Thu, 16 Oct 2014 13:08:50 +0000"  >&lt;p&gt;Yep, this is plain wrong.  Thanks for catching it.&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|hs340v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>142958</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                    <customfield id="customfield_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="321">Java Sprint 10</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </customfields>
    </item>
</channel>
</rss>