ASP.NET Core가 있는 OWIN(Open Web Interface for .NET)

작성자: Steve Smith 및 Rick Anderson

ASP.NET Core:

• OWIN(Open Web Interface for .NET)을 지원합니다.
• Microsoft.Owin.*(Katana) 라이브러리에 대한 .NET Core 호환 대체 항목이 있습니다.

OWIN을 사용하면 웹 앱을 웹 서버에서 분리할 수 있습니다. 미들웨어를 파이프라인에서 사용하고 요청 및 관련된 응답을 처리하기 위한 표준 방법을 정의합니다. ASP.NET Core 애플리케이션 및 미들웨어는 OWIN 기반 애플리케이션, 서버 및 미들웨어와 상호 운용할 수 있습니다.

OWIN은 서로 다른 개체 모델이 있는 두 프레임워크를 함께 사용할 수 있도록 허용하는 분리 계층을 제공합니다. Microsoft.AspNetCore.Owin 패키지는 두 개의 어댑터 구현을 제공합니다.

• ASP.NET Core에서 OWIN으로
• OWIN에서 ASP.NET Core로

이렇게 하면 ASP.NET Core를 OWIN 호환 가능한 서버/호스트를 기반으로 호스팅하거나 다른 OWIN 호환 가능한 구성 요소를 ASP.NET Core를 기반으로 실행되도록 할 수 있습니다.

참고 항목

이러한 어댑터를 사용하면 성능 비용이 수반됩니다. ASP.NET Core 구성 요소만을 사용하는 앱은 Microsoft.AspNetCore.Owin 패키지 또는 어댑터를 사용하면 안 됩니다.

샘플 코드 보기 및 다운로드(다운로드 방법)

ASP.NET Core 파이프라인에서 OWIN 미들웨어 실행

ASP.NET Core의 OWIN 지원은 Microsoft.AspNetCore.Owin 패키지의 일부로 배포됩니다. 이 패키지를 설치하여 OWIN 지원을 프로젝트로 가져올 수 있습니다.

OWIN 미들웨어는 Func<IDictionary<string, object>, Task> 인터페이스 및 특정 키 설정(예: owin.ResponseBody)이 필요한 OWIN 사양을 준수합니다. 다음과 같은 간단한 OWIN 미들웨어는 "Hello World"를 표시합니다.

public Task OwinHello(IDictionary<string, object> environment)
{
    string responseText = "Hello World via OWIN";
    byte[] responseBytes = Encoding.UTF8.GetBytes(responseText);

    // OWIN Environment Keys: https://owin.org/spec/spec/owin-1.0.0.html
    var responseStream = (Stream)environment["owin.ResponseBody"];
    var responseHeaders = (IDictionary<string, string[]>)environment["owin.ResponseHeaders"];

    responseHeaders["Content-Length"] = new string[] { responseBytes.Length.ToString(CultureInfo.InvariantCulture) };
    responseHeaders["Content-Type"] = new string[] { "text/plain" };

    return responseStream.WriteAsync(responseBytes, 0, responseBytes.Length);
}

샘플 서명은 Task를 반환하고 OWIN에 필요한 IDictionary<string, object>를 수락합니다.

다음 코드는 UseOwin 확장 메서드로 OwinHello 미들웨어(위에 표시된)를 ASP.NET Core 파이프라인에 추가하는 방법을 보여줍니다.

public void Configure(IApplicationBuilder app)
{
    app.UseOwin(pipeline =>
    {
        pipeline(next => OwinHello);
    });
}

OWIN 파이프라인 내에서 수행하도록 기타 작업을 구성할 수 있습니다.

참고 항목

응답 헤더는 응답 스트림에 대한 최초 작성 전에 수정되어야 합니다.

참고 항목

UseOwin에 대한 여러 번의 호출은 성능상의 이유로 권장되지 않습니다. OWIN 구성 요소는 함께 그룹화하는 경우 가장 잘 작동합니다.

app.UseOwin(pipeline =>
{
    pipeline(next =>
    {
        return async environment =>
        {
            // Do something before.
            await next(environment);
            // Do something after.
        };
    });
});

OWIN 기반 서버에서 ASP.NET Core 실행 및 해당 WebSocket 지원 사용

ASP.NET Core에서 OWIN 기반 서버 기능을 활용할 수 있는 방법의 또 다른 예는 WebSocket과 같은 기능에 대한 액세스입니다. 이전 예제에서 사용된 .NET OWIN 웹 서버는 ASP.NET Core 애플리케이션에서 활용할 수 있는 WebSocket을 기본적으로 지원합니다. 아래 예제에서는 WebSocket을 지원하고 WebSockets를 통해 서버로 전송된 모든 항목을 다시 에코하는 간단한 웹앱을 보여 줍니다.

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            if (context.WebSockets.IsWebSocketRequest)
            {
                WebSocket webSocket = await context.WebSockets.AcceptWebSocketAsync();
                await EchoWebSocket(webSocket);
            }
            else
            {
                await next();
            }
        });

        app.Run(context =>
        {
            return context.Response.WriteAsync("Hello World");
        });
    }

    private async Task EchoWebSocket(WebSocket webSocket)
    {
        byte[] buffer = new byte[1024];
        WebSocketReceiveResult received = await webSocket.ReceiveAsync(
            new ArraySegment<byte>(buffer), CancellationToken.None);

        while (!webSocket.CloseStatus.HasValue)
        {
            // Echo anything we receive
            await webSocket.SendAsync(new ArraySegment<byte>(buffer, 0, received.Count), 
                received.MessageType, received.EndOfMessage, CancellationToken.None);

            received = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer), 
                CancellationToken.None);
        }

        await webSocket.CloseAsync(webSocket.CloseStatus.Value, 
            webSocket.CloseStatusDescription, CancellationToken.None);
    }
}

OWIN 환경

HttpContext를 사용하여 OWIN 환경을 구성할 수 있습니다.

   var environment = new OwinEnvironment(HttpContext);
   var features = new OwinFeatureCollection(environment);

OWIN 키

OWIN은 HTTP 요청/응답 교환 전체에서 정보를 전달하는 IDictionary<string,object> 개체에 따라 달라집니다. ASP.NET Core는 아래에 나열된 키를 구현합니다. 기본 사양, 확장 및 OWIN 키 지침 및 공통 키를 참조하세요.

요청 데이터(OWIN v1.0.0)

키	값(형식)	설명
owin.RequestScheme	String
owin.RequestMethod	String
owin.RequestPathBase	String
owin.RequestPath	String
owin.RequestQueryString	String
owin.RequestProtocol	String
owin.RequestHeaders	IDictionary<string,string[]>
owin.RequestBody	Stream

요청 데이터(OWIN v1.1.0)

키	값(형식)	설명
owin.RequestId	String	선택 사항

응답 데이터(OWIN v1.0.0)

키	값(형식)	설명
owin.ResponseStatusCode	int	선택 사항
owin.ResponseReasonPhrase	String	선택 사항
owin.ResponseHeaders	IDictionary<string,string[]>
owin.ResponseBody	Stream

기타 데이터(OWIN v1.0.0)

키	값(형식)	설명
owin.CallCancelled	CancellationToken
owin.Version	String

공통 키

키	값(형식)	설명
ssl.ClientCertificate	X509Certificate
ssl.LoadClientCertAsync	Func<Task>
server.RemoteIpAddress	String
server.RemotePort	String
server.LocalIpAddress	String
server.LocalPort	String
server.OnSendingHeaders	Action<Action<object>,object>

SendFiles v0.3.0

키	값(형식)	설명
sendfile.SendAsync	대리자 시그니처 참조	요청당

불투명 v0.3.0

키	값(형식)	설명
opaque.Version	String
opaque.Upgrade	OpaqueUpgrade	대리자 시그니처 참조
opaque.Stream	Stream
opaque.CallCancelled	CancellationToken

WebSocket v0.3.0

키	값(형식)	설명
websocket.Version	String
websocket.Accept	WebSocketAccept	대리자 시그니처 참조
websocket.AcceptAlt		비-사양
websocket.SubProtocol	String	RFC6455 Section 4.2.2 5.5단계 참조
websocket.SendAsync	WebSocketSendAsync	대리자 시그니처 참조
websocket.ReceiveAsync	WebSocketReceiveAsync	대리자 시그니처 참조
websocket.CloseAsync	WebSocketCloseAsync	대리자 시그니처 참조
websocket.CallCancelled	CancellationToken
websocket.ClientCloseStatus	int	선택 사항
websocket.ClientCloseDescription	String	선택 사항

추가 리소스

• 번역 계층에서 지원되는 OWIN 키용 GitHub의 소스를 참조하세요.
• 미들웨어
• 서버