epugh opened a new pull request, #4177:
URL: https://github.com/apache/solr/pull/4177
The V2 JAX-RS update API has meaningful behavioral differences from V1
update handlers that aren't documented anywhere in the Ref Guide.
## New: `indexing-with-v2-apis.adoc`
Documents the V2 update endpoints with emphasis on the critical behavioral
difference: `/update` and `/update/json` in V2 are **document-only** — they
rewrite internally to `/update/json/docs` and do not support the JSON update
command syntax (commit/delete/optimize in the request body). Full comparison:
| Feature | V1 | V2 |
|---|---|---|
| Base path | `/solr/{collection}/update` |
`/api/collections/{collection}/update` |
| JSON documents | `/update` or `/update/json/docs` | `/update` or
`/update/json` |
| JSON update commands | `/update` | not supported via `/update` or
`/update/json` |
| XML updates | `/update` (via Content-Type) | `/update/xml` |
| CSV updates | `/update/csv` | `/update/csv` |
| JavaBin updates | `/update` (via Content-Type) | `/update/bin` |
Covers all five sub-paths (`/update`, `/update/json`, `/update/xml`,
`/update/csv`, `/update/bin`) with `curl` examples, commit/rollback patterns,
and a V1↔V2 comparison table.
## Updated: `indexing-with-update-handlers.adoc`
Added a `NOTE` at the top cross-referencing the new V2 doc, and added
`indexing-with-v2-apis` to `:page-children:`.
## Updated: `indexing-nav.adoc`
Added `indexing-with-v2-apis.adoc` as a child entry under
`indexing-with-update-handlers.adoc` in the sidebar nav.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
