mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12985 from nextcloud/backport/12977/stable31

Browse Source 
[stable31] DAV pagination / deprecation
This commit is contained in:
Benjamin Gaussorgues 2025-04-03 11:56:26 +02:00 committed by GitHub
commit d8a262dc8a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst
View File

@ -280,6 +280,7 @@ Deprecated APIs
- Using ``OCP\TextProcessing\SummaryTaskType`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
- Using ``OCP\TextProcessing\Task`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
- Using ``OCP\TextProcessing\TopicsTaskType`` is deprecated and will be removed in the future. Use ``OCP\TaskProcessing`` instead (see :ref:`Task Processing<task_processing>`). Existing ``TextProcessing`` providers will continue to work with the TaskProcessing API until then.
- Using ``OCP\Group\Backend\ICreateGroupBackend`` interface is deprecated and will be removed in the future. Use ``OCP\Group\Backend\ICreateNamedGroupBackend`` instead.
Removed APIs
^^^^^^^^^^^^

19
developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_31.rst
View File

@ -154,6 +154,24 @@ Changed APIs
- ``DATETIME_TZ`` for fields that will (de)serialized as ``\DateTime`` instances with both the time part set and with timezone information.
- ``DATETIME_TZ_IMMUTABLE`` for fields that will (de)serialized as ``\DateTimeImmutable`` instances with both the time part set and with timezone information.
- It's now possible to paginate DAV requests with new headers.
- First request should contains the following headers:
- ``X-NC-Paginate: true`` enables the functionality
- ``X-NC-Paginate-Count: X`` sets the number of results per page (default 100)
- Server will answer with new headers:
- ``X-NC-Paginate-Total`` indicates the total number of results.
- ``X-NC-Paginate-Token`` gives a token to access other pages of the same result.
- Issue new requests with token:
- ``X-NC-Paginate-Token: xxx`` contains the token as sent by the server
- ``X-NC-Paginate-Count: X`` sets the number of results per page (default 100)
- ``X-NC-Paginate-Offset: Y`` sets the offset (number of ignored results) for the required page (usually "page_number × page_size")
Deprecated APIs
^^^^^^^^^^^^^^^
@ -178,3 +196,4 @@ Removed APIs
- ``OCP\IServerContainer::getLogger`` was removed, use dependency injection with ``Psr\Log\LoggerInterface`` instead.
- The internal class ``OC\AppFramework\Logger`` was removed, it should have been never used by apps.
All using apps should migrate to ``Psr\Log\LoggerInterface``.
- Legacy endpoint to test remote share endpoint (``/testremote``) was removed.