HTTP 처리기 및 HTTP 모듈 개요

업데이트: 2007년 11월

ASP.NET HTTP 처리기는 ASP.NET 웹 응용 프로그램에 대해 이루어진 요청의 응답으로 실행되는 프로세스(일반적으로 "끝점"이라고 함)입니다. 가장 일반적인 처리기는 .aspx 파일을 처리하는 ASP.NET 페이지 처리기입니다. 사용자가 .aspx 파일을 요청하면 페이지에서 페이지 처리기를 통해 요청이 처리됩니다. 사용자 지정 출력을 브라우저로 렌더링하는 고유한 HTTP 처리기를 만들 수 있습니다.

HTTP 모듈은 응용 프로그램에 대한 모든 요청에 따라 호출되는 어셈블리입니다. HTTP 모듈은 ASP.NET 요청 파이프라인의 일부로 호출되며 요청의 사용 기간 동안 모든 이벤트에 액세스할 수 있습니다. 따라서 HTTP 모듈을 사용하면 들어오는 요청과 나가는 요청을 검사하고 요청에 따라 작업을 수행할 수 있습니다.

이 항목의 내용은 다음과 같습니다.

• 시나리오

• HTTP 처리기 및 HTTP 모듈 기능

• 배경

• 코드 예제

• 클래스 참조

시나리오

사용자 지정 HTTP 처리기는 일반적으로 다음과 같이 사용합니다.

• RSS 피드   웹 사이트에 대한 RSS 피드를 만들려면 RSS 형식 XML을 내보내는 처리기를 만들 수 있습니다. 그런 다음 .rss 등의 파일 이름 확장명을 사용자 지정 처리기에 바인딩할 수 있습니다. 사용자가 .rss로 끝나는 사이트를 요청하면 ASP.NET은 이 처리기를 호출하여 요청을 처리합니다.

• 이미지 서버   웹 응용 프로그램에서 다양한 크기의 이미지를 사용하려는 경우 사용자 지정 처리기를 작성하여 이미지 크기를 조정하고, 처리기 응답을 통해 사용자에게 보낼 수 있습니다.

HTTP 모듈은 일반적으로 다음과 같이 사용합니다.

• 보안   들어오는 요청을 검사할 수 있기 때문에 HTTP 모듈에서는 요청된 페이지, XML 웹 서비스 또는 처리기를 호출하기 전에 사용자 지정 인증이나 다른 보안 검사를 수행할 수 있습니다. 통합 모드에서 실행되는 IIS(인터넷 정보 서비스) 7.0의 경우에는 폼 인증을 응용 프로그램의 모든 콘텐츠 형식으로 확장할 수 있습니다.

• 통계와 로깅   HTTP 모듈은 모든 요청에서 호출되기 때문에 개별 페이지 대신 중앙 집중식 모듈에 요청 통계와 로그 정보를 수집할 수 있습니다.

• 사용자 지정 머리글 또는 바닥글   보내는 응답을 수정할 수 있기 때문에 사용자 지정 머리글 정보 같은 내용을 모든 페이지나 XML 웹 서비스 응답에 삽입할 수 있습니다.

맨 위로 이동

기능

HTTP 처리기 및 모듈 기능은 다음과 같습니다.

• IHttpHandler 및 IHttpModule 인터페이스는 처리기와 모듈을 개발하기 위한 시작점입니다.

• IHttpAsyncHandler 인터페이스는 비동기 처리기를 개발하기 위한 시작점입니다.

• 사용자 지정 처리기 및 모듈 소스 코드는 응용 프로그램의 App_Code 폴더에 배치하거나, 컴파일 후 응용 프로그램의 Bin 폴더에 배치할 수 있습니다.

• IIS 6.0용으로 개발된 처리기 및 모듈은 IIS 7.0에서도 거의 변경하지 않고 사용할 수 있습니다. 자세한 내용은 ASP.NET 응용 프로그램을 IIS 6.0에서 IIS 7.0으로 이동을 참조하십시오.

• 모듈은 다양한 요청 파이프라인 알림을 구독할 수 있습니다. 모듈은 HttpApplication 개체 이벤트의 알림을 수신할 수 있습니다.

• IIS 7.0에서 요청 파이프라인은 웹 서버 요청 파이프라인과 통합됩니다. HTTP 모듈은 ASP.NET 요청뿐 아니라 웹 서버에 대한 모든 요청에 사용할 수 있습니다.

맨 위로 이동

배경

HTTP 처리기

ASP.NET HTTP 처리기는 ASP.NET 웹 응용 프로그램에 대해 이루어진 요청의 응답으로 실행되는 프로세스입니다. 가장 일반적인 처리기는 .aspx 파일을 처리하는 ASP.NET 페이지 처리기입니다. 사용자가 .aspx 파일을 요청하면 페이지 처리기를 통해 요청이 처리됩니다.

ASP.NET 페이지 처리기는 단일 형식의 처리기입니다. ASP.NET에는 .asmx 파일을 위한 웹 서비스 처리기와 같은 몇 가지 다른 기본 제공 처리기가 포함되어 있습니다.

ASP.NET의 기본 제공 HTTP 처리기

ASP.NET은 파일 이름 확장명에 따라 HTTP 요청을 HTTP 처리기로 매핑합니다. 각 HTTP 처리기는 응용 프로그램 내에서 개별 HTTP URL 또는 URL 확장 그룹을 처리할 수 있습니다. ASP.NET에는 다음 표에 나열된 몇 가지 기본 제공 HTTP 처리기가 포함됩니다.

사용자 지정 HTTP 처리기 만들기

사용자 지정 HTTP 처리기를 만들려면 IHttpHandler 인터페이스를 구현하는 클래스를 만들어 동기 처리기를 만듭니다. 또한 IHttpAsyncHandler를 구현하여 비동기 처리기를 만들 수도 있습니다. 두 처리기 인터페이스 모두 IsReusable 속성과 ProcessRequest 메서드를 구현해야 합니다. IsReusable 속성은 IHttpHandlerFactory 개체(실제로 해당 처리기를 호출하는 개체)가 처리기를 풀에 집어넣어 성능 향상을 위해 다시 사용할 수 있는지 여부를 지정합니다. 처리기를 풀링할 수 없으면 팩터리에서는 처리기가 필요할 때마다 새 처리기 인스턴스를 만들어야 합니다.

ProcessRequest 메서드는 개별 HTTP 요청을 처리합니다. 이 메서드에서는 처리기에 대한 출력을 생성하는 코드를 작성합니다.

HTTP 처리기는 응용 프로그램 컨텍스트에 액세스할 수 있습니다. 여기에는 요청하는 사용자의 ID(알고 있는 경우), 응용 프로그램의 상태 및 세션 정보가 포함됩니다. HTTP 처리기가 요청되면 ASP.NET은 적절한 처리기의 ProcessRequest 메서드를 호출합니다. 처리기의 ProcessRequest 메서드에 작성하는 코드에서 응답을 만들고, 요청하는 브라우저로 응답이 다시 보내집니다.

파일 이름 확장명 매핑

클래스 파일을 HTTP 처리기로 만드는 경우 처리기는 IIS 및 ASP.NET에 이미 매핑되어 있는 모든 파일 이름 확장명에 응답할 수 있습니다. 예를 들어 RSS 피드를 생성하기 위해 HTTP 처리기를 만드는 경우 처리기를 .rss 파일 이름 확장명에 매핑할 수 있습니다. ASP.NET에서 사용자 지정 파일 이름 확장명에 사용할 처리기를 인식하도록 하려면 IIS에서 해당 확장명을 ASP.NET에 매핑해야 합니다. 그런 다음 응용 프로그램에서 확장명을 사용자 지정 처리기에 매핑해야 합니다.

기본적으로 ASP.NET은 파일 이름 확장명 .ashx를 HTTP 처리기에 매핑합니다. 클래스 파일에 @ WebHandler 지시문을 추가하는 경우 ASP.NET에서는 .ashx 파일 이름 확장명을 기본 HTTP 처리기에 자동으로 매핑합니다. 이는 @ Page 지시문이 사용될 때 ASP.NET에서 .aspx 파일 이름 확장명을 ASP.NET 페이지 처리기에 매핑하는 방식과 비슷합니다. 따라서 파일 이름 확장명이 .ashx인 HTTP 처리기 클래스를 만들면, 이 처리기는 IIS와 ASP.NET에 자동으로 등록됩니다.

처리기에 대한 사용자 지정 파일 이름 확장명을 만드는 경우 해당 확장명을 IIS와 ASP.NET에 명시적으로 등록해야 합니다. .ashx 파일 이름 확장명을 사용하지 않으면 처리기를 서로 다른 확장명 매핑에 다시 사용할 수 있는 이점이 있습니다. 예를 들어 한 응용 프로그램에서는 사용자 지정 처리기가 .rss로 끝나는 요청에 응답할 수 있고, 다른 응용 프로그램에서는 .feed로 끝나는 요청에 응답할 수 있습니다. 또 다른 예로, 동일한 응용 프로그램에서 처리기를 두 파일 이름 확장명에 매핑하고 확장명에 따라 다르게 응답할 수도 있습니다.

처리기의 사용자 지정 파일 이름 확장명을 등록하는 절차는 IIS 7.0과 이전 버전의 IIS에서 각각 다릅니다. 자세한 내용은 방법: HTTP 처리기 등록 및 방법: IIS에서 HTTP 처리기 확장 구성을 참조하십시오.

비동기 및 동기 HTTP 처리기

HTTP 처리기는 동기 또는 비동기일 수 있습니다. 동기 처리기는 호출되고 나면 해당 HTTP 요청의 처리를 완료할 때까지 반환되지 않습니다. 비동기 처리기는 사용자에게 응답을 보내는 것과는 별도로 프로세스를 실행합니다. 실행 시간이 긴 응용 프로그램 프로세스가 시작되었지만, 사용자가 서버로부터 응답을 받기 위해 프로세스가 완료될 때까지 기다릴 필요가 없는 경우에는 비동기 처리기가 유용합니다.

비동기 HTTP 처리기를 사용하면 원격 서버에 대한 메서드 호출 등과 같은 외부 프로세스를 시작할 수 있습니다. 처리기는 외부 프로세스가 완료되기를 기다리지 않고 계속 처리할 수 있습니다. 비동기 HTTP 처리기를 처리하는 동안 ASP.NET에서는 일반적으로 외부 프로세스에 사용될 스레드를 처리기가 외부 프로세스에서 콜백을 받을 때까지 스레드 풀에 다시 넣습니다. 이렇게 하면 제한된 개수의 스레드만 동시에 실행되므로 스레드 차단을 방지하고 성능을 향상시킬 수 있습니다. 외부 프로세스에 의존하는 동기 HTTP 처리기를 여러 사용자가 요청하는 경우, 많은 스레드가 차단되어 외부 프로세스가 끝날 때까지 기다리기 때문에 운영 체제의 스레드가 빨리 부족해질 수 있습니다.

비동기 처리기를 만드는 경우 IHttpAsyncHandler 인터페이스를 구현해야 합니다. 개별 HTTP 요청을 처리하는 비동기 호출을 시작하려면 BeginProcessRequest 메서드도 구현해야 합니다. 또한 프로세스가 끝나면 EndProcessRequest 메서드를 구현하여 정리 코드를 실행해야 합니다.

사용자 지정 IHttpHandlerFactory 클래스

IHttpHandlerFactory 클래스는 요청을 수신하고 적합한 HTTP 처리기로 요청을 전달하는 역할을 담당합니다. IHttpHandlerFactory 인터페이스를 구현하는 클래스를 만들어 사용자 지정 HTTP 처리기 팩터리를 만들 수 있습니다. 사용자 지정 처리기 팩터리는 런타임 조건에 따라 다른 처리기를 만들어 HTTP 요청이 처리되는 방식을 좀 더 세밀하게 제어할 수 있습니다. 예를 들어, 사용자 지정 HTTP 처리기 팩터리를 사용하면 HTTP 요청 메서드가 PUT인 경우의 파일 형식에 대한 HTTP 처리기를 인스턴스화하고, 메서드가 GET인 경우의 파일 형식에 대한 또 다른 HTTP 처리기를 인스턴스화할 수 있습니다.

처리기 팩터리에 대해 사용자 지정 확장을 등록하려면 처리기에 대한 사용자 지정 확장 등록을 위한 단계를 따르십시오. 처리기 팩터리를 만들고 등록하는 방법에 대한 예제를 보려면 연습: HTTP 처리기 팩터리 만들기 및 등록를 참조하십시오.

HTTP 모듈

HTTP 모듈은 응용 프로그램에 대한 모든 요청에 따라 호출되는 어셈블리입니다. HTTP 모듈은 요청 파이프라인의 일부로 호출되며 요청의 사용 기간 동안 모든 이벤트에 액세스할 수 있습니다. 따라서 HTTP 모듈을 사용하면 들어오는 요청을 검사하고 요청에 따라 작업을 수행할 수 있습니다. 또한 나가는 응답을 검사하고 수정할 수도 있습니다.

IIS 6.0에서는 ASP.NET 요청 파이프라인이 웹 서버 요청 파이프라인과 분리됩니다. IIS 7.0에서는 ASP.NET 요청 파이프라인과 웹 서버 요청 파이프라인이 공통 요청 파이프라인으로 통합될 수 있습니다. IIS 7.0에서는 이를 통합 모드라고 합니다. 통합 파이프라인에는 ASP.NET 개발자를 위한 다양한 이점이 있습니다. 예를 들어 통합 파이프라인을 사용하면 요청이 ASP.NET 리소스를 위한 것이 아니어도 관리 코드 모듈에서 모든 요청에 대해 파이프라인 알림을 수신할 수 있습니다. 하지만 원하는 경우에는 클래식 모드에서 IIS 7.0을 실행하여 IIS 6.0에서 실행되는 ASP.NET을 에뮬레이트할 수 있습니다. 자세한 내용은 IIS 7.0의 ASP.NET 응용 프로그램 수명 주기 개요를 참조하십시오.

ASP.NET HTTP 모듈은 모든 요청에 대해 호출된다는 점에서 ISAPI 필터와 유사합니다. 그러나 관리 코드로 작성되며 ASP.NET 응용 프로그램의 수명 주기와 완전히 통합됩니다. 사용자 지정 모듈 소스 코드는 응용 프로그램의 App_Code 폴더에 배치하거나, 응용 프로그램의 Bin 폴더에서 사용자 지정 모듈을 어셈블리로 컴파일할 수 있습니다.

ASP.NET에서는 폼 인증, 캐싱, 세션 상태, 클라이언트 스크립트 서비스 등의 다양한 응용 프로그램 기능을 구현하기 위해 모듈을 사용합니다. 각각의 경우에 해당 서비스가 활성화되어 있으면 모듈이 요청의 일부로 호출되어 단일 페이지 요청 범위 이외의 작업을 수행합니다. 모듈은 응용 프로그램 이벤트를 사용할 수 있으며 Global.asax 파일에서 처리할 수 있는 이벤트를 발생시킬 수도 있습니다. 응용 프로그램 이벤트에 대한 자세한 내용은 IIS 5.0 및 6.0의 ASP.NET 응용 프로그램 수명 주기 개요 및 IIS 7.0의 ASP.NET 응용 프로그램 수명 주기 개요를 참조하십시오.

참고:
HTTP 모듈은 HTTP 처리기와 다릅니다. HTTP 처리기는 파일 이름 확장명 또는 파일 이름 확장명 패밀리에 의해 식별되는 요청에 대해 응답을 반환합니다. 이와 반대로 HTTP 모듈은 모든 요청 및 응답에 대해 생성되며, 요청 파이프라인의 이벤트 알림을 구독하고 등록된 이벤트 처리기에서 코드를 실행할 수 있도록 합니다. 모듈이 사용되는 작업은 응용 프로그램 및 해당 응용 프로그램의 모든 리소스 요청에 대해 일반적입니다.

HTTP 모듈 작동 방식

요청 파이프라인에서 알림을 수신하려면 모듈을 등록해야 합니다. HTTP 모듈을 등록하는 가장 일반적인 방법은 응용 프로그램의 Web.config 파일에서 수행하는 것입니다. IIS 7.0에서는 통합 요청 파이프라인을 사용하여 모듈을 IIS 관리자 및 Appcmd.exe 명령줄 도구 등과 같은 다른 방식을 통해 등록할 수도 있습니다. 자세한 내용은 Configuring Handler Mappings in IIS 7.0 및 Start Appcmd.exe를 참조하십시오.

ASP.NET에서 응용 프로그램을 나타내는 HttpApplication 클래스 인스턴스를 만들 때 등록된 모든 모듈의 인스턴스가 만들어집니다. 모듈을 만들 때는 해당 Init 메서드가 호출되며 모듈이 자체적으로 초기화됩니다. 자세한 내용은 IIS 5.0 및 6.0의 ASP.NET 응용 프로그램 수명 주기 개요 및 ASP.NET IIS 7.0의 ASP.NET 응용 프로그램 수명 주기 개요를 참조하십시오.

모듈의 Init 메서드에서 사용자는 BeginRequest 또는 EndRequest와 같은 여러 응용 프로그램 이벤트를 모듈의 메서드에 바인딩하여 이러한 이벤트를 구독할 수 있습니다.

참고:
IIS 7.0 통합 파이프라인에서 작동하는 모듈의 경우에는 Init 메서드에서 이벤트 처리기를 등록해야 합니다.

응용 프로그램 이벤트가 발생하면 모듈의 해당 메서드가 호출됩니다. 메서드는 인증 검사나 로깅 요청 정보와 같은 필요한 논리를 수행할 수 있습니다. 이벤트 처리 중에 모듈은 현재 요청의 Context 속성에 액세스할 수 있습니다. 따라서 요청을 다른 페이지로 리디렉션하거나 요청을 수정하거나 기타 다른 요청 조작을 수행할 수 있습니다. 예를 들어 모듈에서 인증을 검사하는 경우 모듈은 자격 증명이 잘못되어 있으면 로그인이나 오류 페이지로 리디렉션할 수 있습니다. 그렇지 않은 경우 모듈의 이벤트 처리기가 실행을 완료하면 ASP.NET에서는 파이프라인에서 다음 프로세스를 호출합니다. 이는 또 다른 모듈이거나 요청에 대한 적절한 HTTP 처리기(예: .aspx 파일)일 수 있습니다.

HTTP 모듈과 Global.asax 파일

사용자는 응용 프로그램의 Global.asax 파일에서 모듈의 여러 기능을 구현하여 응용 프로그램 이벤트에 응답할 수 있습니다. 하지만 모듈은 캡슐화되고, 한 번만 만들면 여러 응용 프로그램에서 사용할 수 있다는 점에서 Global.asax 파일에 비해 장점이 있습니다. 모듈을 전역 어셈블리 캐시에 추가하고 Machine.config 파일에 등록하면 여러 응용 프로그램에서 모듈을 다시 사용할 수 있습니다. 자세한 내용은 전역 어셈블리 캐시를 참조하십시오.

참고:
IIS 7.0에서 통합 파이프라인을 사용하면 관리되는 모듈에서 ASP.NET 리소스에 대한 요청뿐 아니라 모든 요청에 대해 파이프라인 알림을 구독할 수 있습니다. Global.asax 파일의 이벤트 처리기는 응용 프로그램에서 리소스에 대한 요청이 발생하는 동안 알림에 대해서만 호출됩니다. 통합 모드의 사용자 모듈 범위는 응용 프로그램의 요청에 대해서만 이벤트 알림을 수신하도록 명시적으로 제한될 수 있습니다. 그렇지 않으면 사용자 지정 모듈에서 응용 프로그램의 모든 요청에 대해 이벤트 알림을 수신하게 됩니다. modules 섹션에 대한 add 요소의 precondition 특성이 "managedHandler"로 설정되어 있으면 모듈의 범위가 애플리케이션으로 제한됩니다.

Global.asax 파일을 사용할 경우에는 Session_Start 및 Session_End 등의 다른 등록된 이벤트를 처리할 수 있다는 장점이 있습니다. 또한 Global.asax 파일을 사용하면 응용 프로그램 전체에서 사용할 수 있는 전역 개체를 인스턴스화할 수 있습니다.

다음 조건을 충족하고 응용 프로그램 이벤트에 의존하는 코드를 만들어야 할 때는 항상 모듈을 사용해야 합니다.

• 다른 응용 프로그램에서 모듈을 다시 사용하려는 경우

• Global.asax 파일에 복잡한 코드를 넣지 않으려는 경우

• 모듈이 파이프라인의 모든 요청에 적용되는 경우(IIS 7.0 통합 모드에만 해당)

응용 프로그램 이벤트에 의존하는 코드를 만들어야 하고 이를 응용 프로그램 간에 다시 사용할 필요가 없는 경우에는 항상 Global.asax 파일에 코드를 추가해야 합니다. 또한 Session_Start 등의 모듈에서 사용할 수 없는 이벤트를 구독해야 하는 경우에도 Global.asax 파일을 사용할 수 있습니다.

HTTP 모듈 만들기

HTTP 모듈을 작성하는 일반적인 프로세스는 다음과 같습니다.

• IHttpModule 인터페이스를 구현하는 클래스를 만듭니다.

• Init 메서드에 대한 처리기를 작성합니다. 초기화 메서드는 모듈을 초기화하고 필요한 응용 프로그램 이벤트를 구독합니다. 예를 들어 응답에 항목을 추가하려는 경우 EndRequest 이벤트를 구독할 수 있습니다. 사용자 지정 인증 논리를 수행하려는 경우에는 AuthenticateRequest 이벤트를 구독할 수 있습니다. 응용 프로그램 이벤트에 대한 자세한 내용은 IIS 5.0 및 6.0의 ASP.NET 응용 프로그램 수명 주기 개요를 참조하십시오.

• 구독한 이벤트에 대한 코드를 작성합니다.

• 모듈에 정리가 필요한 경우에는 선택적으로 Dispose 메서드를 구현합니다.

• Web.config 파일에 모듈을 등록합니다. 자세한 내용은 연습: 사용자 지정 HTTP 모듈 만들기 및 등록을 참조하십시오.

IIS 6.0 또는 이전 버전에서 실행되는 응용 프로그램에서 IIS 7.0에서 실행되는 응용 프로그램으로 모듈을 이동하는 방법에 대한 자세한 내용은 ASP.NET 응용 프로그램을 IIS 6.0에서 IIS 7.0으로 이동을 참조하십시오.

맨 위로 이동

코드 예제

퀵 스타트

HTTP Handlers and Factories

방법 및 연습 항목

방법: HTTP 처리기 등록

방법: IIS에서 HTTP 처리기 확장 구성

연습: 동기 HTTP 처리기 만들기

방법: 비동기 HTTP 처리기 만들기

연습: HTTP 처리기 팩터리 만들기 및 등록

연습: 사용자 지정 HTTP 모듈 만들기 및 등록

맨 위로 이동

클래스 참조

다음 표에서는 HTTP 모듈 및 HTTP 처리기와 관련된 핵심 서버 클래스를 보여 줍니다.

맨 위로 이동

참고 항목

개념

IIS 5.0 및 6.0의 ASP.NET 응용 프로그램 수명 주기 개요

IIS 7.0의 ASP.NET 응용 프로그램 수명 주기 개요

참조

맨 위로 이동