InnerHttpContext

Definition

Assembly: CloudNimble.EasyAF.Http.dll Namespace: CloudNimble.EasyAF.Http Inheritance: System.Object

Syntax

CloudNimble.EasyAF.Http.InnerHttpContext

Summary

Copies origin, identity, and headers from an outer HttpContext onto an inner in-process request so the inner pipeline sees the public URL and the same user.

Remarks

The caller constructs the inner HttpContext (typically new DefaultHttpContext() in an ASP.NET Core app, or IFeatureCollection)). This type stays on Microsoft.AspNetCore.Http.Abstractions and does not construct a context.

Examples

var inner = new DefaultHttpContext
{
    RequestServices = scope.ServiceProvider,
    RequestAborted = cancellationToken
};
InnerHttpContext.CopyFromOuter(inner, outer);
InnerHttpContext.ConfigureRequest(inner, "GET", "/odata/Customers", QueryString.Empty);
inner.Request.Headers["Accept"] = "application/json";
inner.Response.Body = new MemoryStream();

Methods

ConfigureRequest

Sets method, path, and query on inner, and optionally replaces the request body.

Syntax

public static void ConfigureRequest(Microsoft.AspNetCore.Http.HttpContext inner, string method, string path, Microsoft.AspNetCore.Http.QueryString query, System.IO.Stream body = null, string contentType = null)

Parameters

Name	Type	Description
`inner`	`Microsoft.AspNetCore.Http.HttpContext`	The inner context to configure.
`method`	`string`	The HTTP method, for example `GET`.
`path`	`string`	The request path, including a leading slash.
`query`	`Microsoft.AspNetCore.Http.QueryString`	The query string, or Empty.
`body`	`System.IO.Stream`	An optional replacement request body. When `null`, the body is left unchanged.
`contentType`	`string`	The content type to set when body is provided.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when inner is `null`.
`ArgumentException`	Thrown when method or path is blank.

CopyFromOuter

Copies scheme, host, path base, user, and non-skipped headers from outer onto inner. When outer is null, uses http / localhost and an empty principal.

Syntax

public static void CopyFromOuter(Microsoft.AspNetCore.Http.HttpContext inner, Microsoft.AspNetCore.Http.HttpContext outer)

Parameters

Name	Type	Description
`inner`	`Microsoft.AspNetCore.Http.HttpContext`	The inner context to fill.
`outer`	`Microsoft.AspNetCore.Http.HttpContext`	The incoming context, or `null` when there is no outer request.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when inner is `null`.

Remarks

Scheme, host, and path base come from the outer request so generated links match the public URL. Other request headers are copied except hop-by-hop, entity-body, and HTTP conditionals (see InnerHttpContext.SkippedRequestHeaders).

CopyIncomingHeaders

Copies outer request headers onto the inner call, skipping InnerHttpContext.SkippedRequestHeaders.

Syntax

public static void CopyIncomingHeaders(Microsoft.AspNetCore.Http.HttpContext inner, Microsoft.AspNetCore.Http.HttpContext outer)

Parameters

Name	Type	Description
`inner`	`Microsoft.AspNetCore.Http.HttpContext`	The inner context.
`outer`	`Microsoft.AspNetCore.Http.HttpContext`	The incoming context.

Exceptions

Exception	Description
`ArgumentNullException`	Thrown when inner or outer is `null`.

Getting Started

Guides

API Reference

InnerHttpContext

Definition

Syntax

Summary

Remarks

Examples

Methods

ConfigureRequest

Syntax

Parameters

Exceptions

CopyFromOuter

Syntax

Parameters

Exceptions

Remarks

CopyIncomingHeaders

Syntax

Parameters

Exceptions

​Definition

​Syntax

​Summary

​Remarks

​Examples

​Methods

​ ConfigureRequest

​Syntax

​Parameters

​Exceptions

​ CopyFromOuter

​Syntax

​Parameters

​Exceptions

​Remarks

​ CopyIncomingHeaders

​Syntax

​Parameters

​Exceptions

Definition

Syntax

Summary

Remarks

Examples

Methods

ConfigureRequest

Syntax

Parameters

Exceptions

CopyFromOuter

Syntax

Parameters

Exceptions

Remarks

CopyIncomingHeaders

Syntax

Parameters

Exceptions