<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:57:21 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-2491] Clarify &quot;upserted items&quot; in javadoc for BulkWriteResult.getUpserts()</title>
                <link>https://jira.mongodb.org/browse/JAVA-2491</link>
                <project id="10006" key="JAVA">Java Driver</project>
                    <description>&lt;p&gt;The javadoc for BulkWriteResult.getUpserts() says&lt;br/&gt;
&amp;gt; Gets an unmodifiable list of *&lt;b&gt;upserted&lt;/b&gt;* items, or the empty list if there were none.&lt;/p&gt;

&lt;p&gt;Arguably, &quot;upserted items&quot; is a bit ambiguous as a user might expect that to be populated when there&apos;s an update. The mongo shell documentation for &lt;a href=&quot;https://docs.mongodb.com/manual/reference/method/BulkWriteResult/#BulkWriteResult.upserted&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mongodb.com/manual/reference/method/BulkWriteResult/#BulkWriteResult.upserted&lt;/a&gt; is a little more specific, as it states:&lt;br/&gt;
&amp;gt; An array of documents that contains information for each document *&lt;b&gt;inserted&lt;/b&gt;* through operations with the Bulk.find.upsert() option.&lt;/p&gt;</description>
                <environment></environment>
        <key id="373802">JAVA-2491</key>
            <summary>Clarify &quot;upserted items&quot; in javadoc for BulkWriteResult.getUpserts()</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="10038" iconUrl="https://jira.mongodb.org/images/icons/subtask.gif" description="">Backlog</status>
                    <statusCategory id="2" key="new" colorName="default"/>
                                    <resolution id="-1">Unresolved</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="mark.helmstetter@mongodb.com">Mark Helmstetter</reporter>
                        <labels>
                            <label>roadmap</label>
                    </labels>
                <created>Thu, 13 Apr 2017 14:45:39 +0000</created>
                <updated>Sat, 10 Jun 2023 21:23:21 +0000</updated>
                                                                            <component>Documentation</component>
                                        <votes>1</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="5490306" author="jeff.yemin" created="Sat, 10 Jun 2023 21:23:21 +0000"  >&lt;p&gt;Just FYI, the server&apos;s &lt;tt&gt;update&lt;/tt&gt; command does not include the list of updated &lt;tt&gt;_id&lt;/tt&gt; values (nor the list of deleted &lt;tt&gt;_id&lt;/tt&gt; values for the &lt;tt&gt;delete&lt;/tt&gt; command.&lt;br/&gt;
I don&apos;t know the history behind that decision, but I suspect it&apos;s because the list is essentially unbounded so there are performance implications of maintaining the list on the server and returning it to the client.  I also think that for most multi updates and deletes, the application doesn&apos;t need the list, and we wouldn&apos;t want to make all users pay the cost of it.  But regardless, there would be no way for the Java driver to do this without a corresponding change on the server.&lt;/p&gt;</comment>
                            <comment id="4834673" author="JIRAUSER1271132" created="Fri, 16 Sep 2022 18:28:56 +0000"  >&lt;p&gt;I agree with Sam. That&apos;s not what the user would want/expect. And if so, where would a user be able to find the updated ids?&lt;/p&gt;</comment>
                            <comment id="1772663" author="srperetz" created="Fri, 12 Jan 2018 13:52:44 +0000"  >&lt;p&gt;Why doesn&apos;t &lt;tt&gt;BulkWriteResult&lt;/tt&gt; include both updated ids as well as inserted ids?  It should have &lt;tt&gt;getUpdated()&lt;/tt&gt; that returns the former and &lt;tt&gt;getInserted()&lt;/tt&gt; that returns the latter.  Or, at the very least, &lt;tt&gt;getUpserted()&lt;/tt&gt; should return both updated &lt;em&gt;and&lt;/em&gt; inserted ids.&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_14266" key="com.atlassian.jira.plugin.system.customfieldtypes:textarea">
                        <customfieldname>Documentation Changes Summary</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>&lt;p&gt;1.  What would you like to communicate to the user about this feature?&lt;br/&gt;
2.  Would you like the user to see examples of the syntax and/or executable code and its output?&lt;br/&gt;
3.  Which versions of the driver/connector does this apply to?&lt;/p&gt;</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_21553" key="com.atlassian.jira.plugin.system.customfieldtypes:labels">
                        <customfieldname>Quarter</customfieldname>
                        <customfieldvalues>
                                        <label>FY24Q2</label>
    
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|i1p9st:</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>