feat: add support for parsing OData batch operation responses #193

wikando-dt · 2025-11-20T15:35:19Z

No description provided.

Copilot

Pull Request Overview

This PR adds comprehensive support for parsing OData batch operation responses, enabling the library to handle both single and changeset-grouped batch operations. This addresses a key capability gap for clients needing to process multiple OData operations in a single request/response cycle.

Key changes:

Introduced interface hierarchy separating entity-specific methods (IODataEntityResponse) from general response methods (IODataResponse) to support both regular and batch responses
Added ODataResponseFactory to automatically detect and instantiate the appropriate response type based on Content-Type headers
Implemented ODataBatchResponse class with full parsing logic for multipart/mixed batch responses including nested changesets

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 17 comments.

Show a summary per file

File	Description
`src/IODataResponse.php`	Removed entity-specific methods to create a more general base interface
`src/IODataEntityResponse.php`	New interface extending IODataResponse with entity-specific methods (getResponseAsObject, getSkipToken, getId)
`src/ODataResponse.php`	Updated to implement IODataEntityResponse instead of IODataResponse
`src/ODataResponseFactory.php`	New factory class for automatic response type detection and instantiation based on Content-Type
`src/ODataRequest.php`	Modified to use ODataResponseFactory instead of direct ODataResponse instantiation
`src/ODataBatchResponse.php`	New class implementing full batch response parsing with support for boundaries, changesets, and mixed success/error responses
`tests/ODataBatchResponseTest.php`	Comprehensive test suite covering standard batch responses, changesets, and mixed success/error scenarios

Copilot · 2025-11-20T15:44:05Z

src/ODataBatchResponse.php

+    public function getRawBody(): ?string
+    {
+        return $this->body;
+    }


Missing method docblock. Public method getRawBody() should include documentation, following the pattern in ODataResponse.php (lines 112-120).

Copilot · 2025-11-20T15:44:06Z

src/ODataBatchResponse.php

+        $lines = explode("\n", $part);
+        $inHeaders = true;
+        $responseHeaders = array();
+        $responseBody = '';
+        $statusCode = null;
+        $foundHttpResponse = false;
+
+        foreach ($lines as $line) {
+            $line = rtrim($line, "\r");
+
+            if ($inHeaders) {
+                if (trim($line) === '') {
+                    // Only switch to body parsing if we've found an HTTP response line
+                    if ($foundHttpResponse) {
+                        $inHeaders = false;
+                    }
+                    continue;
+                }
+
+                if (strpos($line, 'HTTP/') === 0) {
+                    $statusParts = explode(' ', $line, 3);
+                    $statusCode = (array_key_exists(1, $statusParts) && $statusParts[1] !== null) ? $statusParts[1] : (string)HttpStatusCode::OK;
+                    $foundHttpResponse = true;
+                    continue;
+                }
+
+                // Only parse headers after we've found the HTTP response line
+                if ($foundHttpResponse && strpos($line, ':') !== false) {
+                    list($key, $value) = explode(':', $line, 2);
+                    $responseHeaders[trim($key)] = trim($value);
+                }
+            } else {
+                $responseBody .= $line . "\n";
+            }
+        }


The parseIndividualResponse() method splits the entire part into lines using explode("\n"). For batch responses with many operations or large response bodies, this creates unnecessary line arrays in memory. Consider using a string position-based approach or stream-based parsing for better memory efficiency with large responses.

Copilot · 2025-11-20T15:44:06Z

src/ODataResponseFactory.php

+            strpos($contentType, 'multipart/mixed') === 0 &&
+            strpos($contentType, 'boundary=batchresponse_') !== false) {


The batch response detection logic is overly strict by checking for 'boundary=batchresponse_' specifically. According to the OData specification, any boundary string is valid as long as Content-Type is 'multipart/mixed'. The current implementation would fail for batch responses with custom boundary names that don't start with 'batchresponse_'. Consider checking only for 'multipart/mixed' content type and then letting the ODataBatchResponse class validate the boundary pattern internally.

Suggested change

strpos($contentType, 'multipart/mixed') === 0 &&

strpos($contentType, 'boundary=batchresponse_') !== false) {

strpos($contentType, 'multipart/mixed') === 0) {

Copilot · 2025-11-20T15:44:06Z

src/ODataBatchResponse.php

+    public function getBody(): array
+    {
+        $bodies = array();
+        foreach ($this->responses as $response) {
+            $bodies[] = $response->getBody();
+        }
+        return $bodies;
+    }


Missing method docblock. Public method getBody() should include documentation describing that it returns an array of decoded bodies from all individual responses, following the documentation pattern used in the codebase (e.g., ODataResponse.php lines 102-106).

Copilot · 2025-11-20T15:44:07Z

src/ODataBatchResponse.php

+    public function getResponse(int $index): ?ODataResponse
+    {
+        return (array_key_exists($index, $this->responses) && $this->responses[$index] !== null) ? $this->responses[$index] : null;
+    }


Missing method docblock. Public method getResponse() should include documentation describing the @param and @return values.

Copilot · 2025-11-20T15:44:09Z

src/ODataBatchResponse.php

+    public function getHeaders(): array
+    {
+        return $this->headers;
+    }


Missing method docblock. Public method getHeaders() should include documentation, following the pattern in ODataResponse.php (lines 132-140).

Copilot · 2025-11-20T15:44:09Z

src/ODataBatchResponse.php

+    public function getResponses(): array
+    {
+        return $this->responses;
+    }


Missing method docblock. Public method getResponses() should include documentation describing that it returns an array of ODataResponse objects parsed from the batch response.

Copilot · 2025-11-20T15:44:09Z

src/ODataResponseFactory.php

+<?php
+
+namespace SaintSystems\OData;
+
+class ODataResponseFactory
+{
+    public static function create(IODataRequest $request,  ?string $body = null, ?string $statusCode = null, array $headers = array())
+    {
+        $contentType = self::getContentType($headers);
+
+        // Batch response detection - Microsoft uses multipart/mixed with batchresponse_ boundary
+        if ($contentType !== null &&
+            strpos($contentType, 'multipart/mixed') === 0 &&
+            strpos($contentType, 'boundary=batchresponse_') !== false) {
+            return new ODataBatchResponse($request, $body, $statusCode, $headers);
+        }
+
+        return new ODataResponse($request, $body, $statusCode, $headers);
+    }


Missing class-level and method docblocks. The factory class and its methods should include documentation describing their purpose, parameters, and return types, following the existing codebase convention seen in ODataResponse.php.

Copilot · 2025-11-20T15:44:10Z

src/ODataBatchResponse.php

+        if ($contentType !== null && $contentType !== '' && preg_match('/boundary=(["\']?)([^"\';]+)\1/', $contentType, $matches)) {
+            $boundary = $matches[2];
+
+            if (strpos(strtolower($boundary), 'batchresponse') !== false) {
+                return $boundary;


The regex pattern /boundary=(["\']?)([^"\';]+)\1/ doesn't handle boundaries that might contain special regex characters or have spaces. Additionally, the pattern [^"\';]+ will stop at semicolons, which means if the boundary value is followed by additional parameters (e.g., boundary=xyz; charset=utf-8), it will work, but boundary values containing semicolons would fail. While semicolons in boundaries are rare, consider using a more robust parsing approach or document this limitation.

Suggested change

if ($contentType !== null && $contentType !== '' && preg_match('/boundary=(["\']?)([^"\';]+)\1/', $contentType, $matches)) {

$boundary = $matches[2];

if (strpos(strtolower($boundary), 'batchresponse') !== false) {

return $boundary;

if ($contentType !== null && $contentType !== '') {

// Improved regex: matches boundary=foo, boundary="foo;bar", boundary='foo bar', etc.

if (preg_match('/boundary\s*=\s*(?:"([^"]+)"|\'([^\']+)\'|([^\s;]+))/i', $contentType, $matches)) {

// $matches[1]: double-quoted, $matches[2]: single-quoted, $matches[3]: unquoted

$boundary = $matches[1] ?? $matches[2] ?? $matches[3] ?? null;

if ($boundary !== null && strpos(strtolower($boundary), 'batchresponse') !== false) {

return $boundary;

}

Copilot · 2025-11-20T15:44:10Z

src/IODataEntityResponse.php

+
+namespace SaintSystems\OData;
+


Missing file-level and interface docblocks. The interface should include documentation describing its purpose and relationship to IODataResponse, following the codebase convention (e.g., as seen in other interface files).

Suggested change

namespace SaintSystems\OData;

/**

* IODataEntityResponse interface file.

*

* Defines the contract for OData entity response objects, which represent

* responses containing single entities or collections of entities from an OData service.

* Extends IODataResponse to provide additional methods for entity-specific

* operations such as object conversion, skip token retrieval, and ID access.

*

* @package SaintSystems\OData

*/

namespace SaintSystems\OData;

/**

* Interface for OData entity response objects.

*

* Extends IODataResponse to provide methods for converting the response

* to SDK objects, retrieving skip tokens for pagination, and accessing

* the entity ID after insert operations. Used by ODataClient to represent

* responses containing entities or entity sets from an OData service.

*

* @see IODataResponse

*/

feat: add support for parsing OData batch operation responses

b2d07cc

anderly requested a review from Copilot November 20, 2025 15:36

Copilot started reviewing on behalf of anderly November 20, 2025 15:37 View session

wikando-dt closed this Nov 20, 2025

Copilot finished reviewing on behalf of anderly November 20, 2025 15:40

Copilot AI reviewed Nov 20, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add support for parsing OData batch operation responses #193

feat: add support for parsing OData batch operation responses #193

Uh oh!

wikando-dt commented Nov 20, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Copilot AI Nov 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		strpos($contentType, 'multipart/mixed') === 0 &&
		strpos($contentType, 'boundary=batchresponse_') !== false) {

-        if ($contentType !== null && $contentType !== '' && preg_match('/boundary=(["\']?)([^"\';]+)\1/', $contentType, $matches)) {
-            $boundary = $matches[2];
-            if (strpos(strtolower($boundary), 'batchresponse') !== false) {
-                return $boundary;
+        if ($contentType !== null && $contentType !== '') {
+            // Improved regex: matches boundary=foo, boundary="foo;bar", boundary='foo bar', etc.
+            if (preg_match('/boundary\s*=\s*(?:"([^"]+)"|\'([^\']+)\'|([^\s;]+))/i', $contentType, $matches)) {
+                // $matches[1]: double-quoted, $matches[2]: single-quoted, $matches[3]: unquoted
+                $boundary = $matches[1] ?? $matches[2] ?? $matches[3] ?? null;
+                if ($boundary !== null && strpos(strtolower($boundary), 'batchresponse') !== false) {
+                    return $boundary;
+                }

-namespace SaintSystems\OData;
+/**
+ * IODataEntityResponse interface file.
+ *
+ * Defines the contract for OData entity response objects, which represent
+ * responses containing single entities or collections of entities from an OData service.
+ * Extends IODataResponse to provide additional methods for entity-specific
+ * operations such as object conversion, skip token retrieval, and ID access.
+ *
+ * @package SaintSystems\OData
+ */
+namespace SaintSystems\OData;
+/**
+ * Interface for OData entity response objects.
+ *
+ * Extends IODataResponse to provide methods for converting the response
+ * to SDK objects, retrieving skip tokens for pagination, and accessing
+ * the entity ID after insert operations. Used by ODataClient to represent
+ * responses containing entities or entity sets from an OData service.
+ *
+ * @see IODataResponse
+ */

feat: add support for parsing OData batch operation responses #193

feat: add support for parsing OData batch operation responses #193

Uh oh!

Conversation

wikando-dt commented Nov 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 20, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

wikando-dt commented Nov 20, 2025 •

edited

Loading