Merge pull request #139 from microsoftgraph/Middleware_Options

Implementation of Middleware Options

Author: muthurathinam

.vscode/launch.json

@@ -35,6 +35,20 @@
                 "${workspaceRoot}/spec/development/workload/*.js"
             ],
             "cwd": "${workspaceRoot}",
+            "preLaunchTask": "Run Build",
+            "outFiles": [],
+            "internalConsoleOptions": "openOnSessionStart"
+        },
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Run middleware tests",
+            "program": "${workspaceRoot}/node_modules/mocha/bin/_mocha",
+            "args": [
+                "${workspaceRoot}/spec/middleware/*.js"
+            ],
+            "cwd": "${workspaceRoot}",
+            "preLaunchTask": "Run Build",
             "outFiles": [],
             "internalConsoleOptions": "openOnSessionStart"
         }

docs/CustomMiddlewareChain.md

@@ -8,7 +8,7 @@ As name suggests it comes in middle of something and that is request and respons
 
 ### Implement Middlewares
 
-Create a custom middleware pipeline by implementing the [Middleware](../src/IMiddleware.ts) interface. The following examples demonstrate how to create a custom logging middleware and how to create a custom http request a response handler.
+Create a custom middleware pipeline by implementing the [Middleware](../src/middleware/IMiddleware.ts) interface. The following examples demonstrate how to create a custom logging middleware and how to create a custom http request a response handler.
 
 First middleware is passed with the context object containing request, and other middleware specific options. One has to explicitly make call to execute method of the next middleware with context object once the current middleware work is over.
 
@@ -146,4 +146,4 @@ export class MyLoggingHandler implements Middleware {
 }
 ```
 
-Refer [MiddlewareOptions](../src/IMiddlewareOptions.ts) interface to know its structure.
+Refer [MiddlewareOptions](../src/middleware/option/IMiddlewareOption.ts) interface to know its structure.

docs/OtherAPIs.md

@@ -74,6 +74,21 @@ try {
 }
 ```
 
+## MIDDLEWAREOPTIONS
+
+You can override the client middleware behavior by setting per request middleware options. Use the `.middlewareOptions()` request builder method to add custom middleware behavior for a specific request. The `middlewareOptions()` method takes an array of strongly typed middleware options. These middleware options are an implementation of the [MiddlewareOption](../src/middleware/option/IMiddlewareOption.ts) interface.
+
+```typescript
+try {
+    let res = await client.api("/me/messages").middlewareOptions([
+        new RetryHandlerOption(5000)
+    ]).get();
+    console.log(res);
+} catch (error) {
+    throw error;
+}
+```
+
 ## RESPONSETYPE
 
 To set a custom response type, use the`.responseType(<ResponseType>)` method. Refer [ResponseType.ts](./src/ResponseType.ts) for available options.
@@ -85,4 +100,4 @@ try {
 } catch (error) {
     throw error;
 }
-````
+````