PHP - Request Adapter

abstractions/php/src/RequestAdapter.php

@@ -10,11 +10,11 @@ interface RequestAdapter {
     /**
      * Executes the HTTP request specified by the given RequestInformation and returns the deserialized response model.
      * @param RequestInformation $requestInfo the request info to execute.
-     * @param mixed|null $targetClass the class of the response model to deserialize the response into.
+     * @param string $targetClass the class of the response model to deserialize the response into.
      * @param ResponseHandler|null $responseHandler The response handler to use for the HTTP request instead of the default handler.
      * @return Promise with the deserialized response model.
      */
-    public function sendAsync(RequestInformation $requestInfo, $targetClass = null, ?ResponseHandler $responseHandler = null): Promise;
+    public function sendAsync(RequestInformation $requestInfo, string $targetClass, ?ResponseHandler $responseHandler = null): Promise;
 
     /**
      * Gets the serialization writer factory currently in use for the HTTP core service.
@@ -25,12 +25,37 @@ public function getSerializationWriterFactory(): SerializationWriterFactory;
     /**
      * Executes the HTTP request specified by the given RequestInformation and returns the deserialized response model collection.
      * @param RequestInformation $requestInfo
-     * @param mixed $targetClass the request info to execute.
+     * @param string $targetClass the request info to execute.
      * @param ResponseHandler|null $responseHandler
      * @return Promise with the deserialized response model collection.
      */
-    public function sendCollectionAsync(RequestInformation $requestInfo, $targetClass = null, ?ResponseHandler $responseHandler = null): Promise;
+    public function sendCollectionAsync(RequestInformation $requestInfo, string $targetClass, ?ResponseHandler $responseHandler = null): Promise;
 
+    /**
+     * Executes the HTTP request specified by the given RequestInformation and returns the deserialized primitive response model.
+     * @param RequestInformation $requestInfo
+     * @param string $primitiveType e.g. int, bool
+     * @param ResponseHandler|null $responseHandler
+     * @return Promise
+     */
+    public function sendPrimitiveAsync(RequestInformation $requestInfo, string $primitiveType, ?ResponseHandler $responseHandler = null): Promise;
+
+    /**
+     * Executes the HTTP request specified by the given RequestInformation and returns the deserialized primitive response model collection.
+     * @param RequestInformation $requestInfo
+     * @param string $primitiveType e.g. int, bool
+     * @param ResponseHandler|null $responseHandler
+     * @return Promise
+     */
+    public function sendPrimitiveCollectionAsync(RequestInformation $requestInfo, string $primitiveType, ?ResponseHandler $responseHandler = null): Promise;
+
+    /**
+     * Executes the HTTP request specified by the given RequestInformation with no return content.
+     * @param RequestInformation $requestInfo
+     * @param ResponseHandler|null $responseHandler
+     * @return Promise
+     */
+    public function sendNoContentAsync(RequestInformation $requestInfo, ?ResponseHandler $responseHandler = null): Promise;
     /**
      * Enables the backing store proxies for the SerializationWriters and ParseNodes in use.
      * @param BackingStoreFactory $backingStoreFactory The backing store factory to use.

abstractions/php/src/RequestInformation.php

@@ -10,7 +10,7 @@
 
 class RequestInformation {
     /** @var string $RAW_URL_KEY */
-    private static string $RAW_URL_KEY = 'request-raw-url';
+    public static string $RAW_URL_KEY = 'request-raw-url';
     /** @var string $urlTemplate The url template for the current request */
     public string $urlTemplate;
     /**
@@ -19,8 +19,8 @@ class RequestInformation {
      */
     public array $pathParameters = [];
 
-    /** @var string|null $uri */
-    private ?string $uri;
+    /** @var string $uri */
+    private string $uri;
     /**
      * @var string The HTTP method for the request
      */
@@ -36,12 +36,12 @@ class RequestInformation {
     /** @var string $binaryContentType */
     private static string $binaryContentType = 'application/octet-stream';
     /** @var string $contentTypeHeader */
-    private static string $contentTypeHeader = 'Content-Type';
+    public static string $contentTypeHeader = 'Content-Type';
 
     /** Gets the URI of the request.
      * @return string
      */
-    public function getUri(): ?string {
+    public function getUri(): string {
         if (!empty($this->uri)) {
             return $this->uri;
         }

abstractions/php/src/Serialization/ParseNode.php

@@ -39,12 +39,6 @@ public function getIntegerValue(): int;
      */
     public function getFloatValue(): float;
 
-    /**
-     * Gets the Long value of the node.
-     * @return int the Long value of the node.
-     */
-    public function getLongValue(): int;
-
     /**
      * Gets the UUID value of the node.
      * @return string the UUID value of the node.
@@ -55,7 +49,21 @@ public function getUUIDValue(): string;
      * Gets the model object value of the node.
      * @return object the model object value of the node.
      */
-    public function getObjectValue(): object;
+    public function getObjectValue(string $targetClass): object;
+
+    /**
+     * Gets the collection of model object values from the node
+     * @param string $targetClass
+     * @return object[]
+     */
+    public function getCollectionOfObjectValues(string $targetClass): array;
+
+    /**
+     * Gets the collection of primitive values from the node
+     * @param string $primitiveType
+     * @return array<mixed>
+     */
+    public function getCollectionOfPrimitiveValues(string $primitiveType): array;
 
     /**
      * Gets the OffsetDateTime value of the node.

abstractions/php/src/Serialization/ParseNodeFactory.php

@@ -15,7 +15,7 @@ interface ParseNodeFactory {
      * @param StreamInterface $rawResponse the content type of the {@link StreamInterface}.
      * @return ParseNode a {@link ParseNode} that can deserialize the given {@link StreamInterface}.
      */
-    public function getParseNode(string $contentType, StreamInterface $rawResponse): ParseNode;
+    public function getRootParseNode(string $contentType, StreamInterface $rawResponse): ParseNode;
 
     /**
      * Returns the content type this factory's parse nodes can deserialize.

abstractions/php/src/Serialization/ParseNodeFactoryRegistry.php

@@ -30,12 +30,12 @@ class ParseNodeFactoryRegistry implements ParseNodeFactory {
      * @param StreamInterface $rawResponse
      * @return ParseNode
      */
-    public function getParseNode(string $contentType, StreamInterface $rawResponse): ParseNode {
+    public function getRootParseNode(string $contentType, StreamInterface $rawResponse): ParseNode {
         if (empty(trim($contentType))) {
             throw new InvalidArgumentException('$contentType cannot be empty.');
         }
         if (array_key_exists($contentType, $this->contentTypeAssociatedFactories)) {
-            return $this->contentTypeAssociatedFactories[$contentType]->getParseNode($contentType, $rawResponse);
+            return $this->contentTypeAssociatedFactories[$contentType]->getRootParseNode($contentType, $rawResponse);
         }
         throw new UnexpectedValueException('Content type ' . $contentType . ' does not have a factory to be parsed');
     }

abstractions/php/src/Serialization/ParseNodeProxyFactory.php

@@ -41,8 +41,8 @@ public function __construct(ParseNodeFactory $concreteParseNodeFactory, ?callabl
      * @param StreamInterface $rawResponse
      * @return ParseNode
      */
-    public function getParseNode(string $contentType, StreamInterface $rawResponse): ParseNode {
-        $node = $this->concreteParseNodeFactory->getParseNode($contentType, $rawResponse);
+    public function getRootParseNode(string $contentType, StreamInterface $rawResponse): ParseNode {
+        $node = $this->concreteParseNodeFactory->getRootParseNode($contentType, $rawResponse);
         $originalBefore  = $node->getOnBeforeAssignFieldValues();
         $originalAfter  = $node->getOnAfterAssignFieldValues();
 

http/php/guzzle/composer.json

@@ -2,10 +2,18 @@
     "name": "microsoft/kiota-http-guzzle",
     "description": "Kiota Request Adapter implementation",
     "type": "library",
+	"repositories": [
+		{
+			"type": "path",
+			"url": "../../../abstractions/php",
+			"only": ["microsoft/kiota-abstractions"]
+		}
+	],
 	"require": {
 		"php": "^7.4 | ^8.0",
         "php-http/guzzle7-adapter": "^1.0",
         "php-http/httplug": "^2.2",
+		"microsoft/kiota-abstractions": "*@dev",
 		"ext-zlib": "*"
 	},
     "require-dev": {