OSS.Http의 기본 HttpClient 재구성 및 캡슐화를 완료하고 표준 라이브러리의 세부 도입을 지원합니다.

OSS.Http 프로젝트의 .Net 표준 표준 라이브러리 지원이 마이그레이션되었으며 OSS 오픈 소스 시리즈의 가장 낮은 수준 클래스 라이브러리 2개는 이미 크로스 런타임을 지원하는 기능을 갖추고 있습니다. 이 글은 주로 1. HttpClient 소개, 2. 재구성 아이디어, 3. 쉽게 접할 수 있는 문제를 다루고 있습니다. 매우 좋은 참조 값을 가지고 있으므로 아래 편집기를 사용하여 살펴보겠습니다.

OSS.Http 프로젝트의 .Net 표준 표준 라이브러리 지원이 마이그레이션되었으며 OSS의 가장 낮은 수준 클래스 라이브러리 2개가 있습니다. 오픈 소스 시리즈는 이미 사용 가능합니다. 런타임 전반에 걸쳐 지원하는 기능입니다. OSS.Http 클래스 라이브러리는 RestSharp의 아이디어를 기반으로 몇 년 전에 완성한 경량 HTTP 요청 프레임워크이기 때문입니다. 하위 계층은 오랫동안 HttpWebRequest를 사용해 왔기 때문에 이번에는 기본적으로 완전히 리팩토링되었습니다. 이 기사에는 주로 1. HttpClient 소개, 2. 리팩토링 아이디어, 3. 발생하기 쉬운 문제가 포함되어 있습니다.

1. httpclient 기본 소개

HttpClient는 .net Framework 버전 4.5에서 참조되는 새로운 기능이어야 하며, 그 전에는 일반적으로 HttpWebRequest를 사용했습니다. , 전자가 더 간단하고 명확하며 가장 중요한 것은 .net 표준 API를 완벽하게 지원한다는 것입니다. 이것이 제가 선택한 중요한 이유이기도 합니다.

HttpClient는 구조를 크게 조정하여 완전히 비동기식으로 구현했습니다. 여기서는 먼저 해당 기본 클래스를 소개합니다.

1. HtttpRequestMessage

요청의 기본 정보, 요청 주소, 요청 동작 등. 이 값은 요청을 시작하는 HttpClient 메서드에서 매개 변수로 전달됩니다. , 와 동일하며 HttpResponseMessage

2.HttpContent

요청에 대한 응답 내용 본문에 해당하며 주로 특정 내용을 포함합니다. HtttpRequestMessage의 속성입니다. 둘 다 Headers 속성을 포함하지만 범위가 다르기 때문에 혼동하기 쉽고 실수하기 쉽습니다. 간단한 분류:

HttpRequestMessage의 헤더(HttpRequestHeaders)는 주로 Accept, UserAgent, AcceptEncoding 및 http 링크의 기타 기본 속성과 같은 요청의 속성입니다.

HttpContent의 헤더(HttpContentHeaders)는 주로 Allow, Content-Encoding, Content-Length, Content-Type, Expires, Last-Modified 등을 포함하는 현재 요청 콘텐츠의 속성입니다. 자세한 내용은 공식 클래스 라이브러리를 참조하세요.

HttpContent 시스템은 주로 다음과 같은 여러 기본 구현을 제공합니다.

3. HttpMessageHandler

이 클래스의 주요 기능은 리디렉션 지원 여부, 쿠키 사용 가능 여부, 프록시 프록시 등 요청 콘텐츠 처리 작업 등을 정의하는 것입니다. 이 값은 시스템 설정에 편향되어 전달될 수 있습니다. HttpClient 생성자를 통해 시스템에 기본적으로 제공되는 하위 클래스는 HttpClientHandler입니다.

4. HttpClient

특정 요청 구현 호출 구현, POST, GET, 삭제 및 기타 Http 요청 메소드 전체 구현 최종 호출은 SendAsync 메서드입니다.

위의 네 가지 주요 클래스는 HttpClient 요청의 주요 구현을 구성합니다. 간단히 사용하는 경우 다음과 같이 HttpClient만 신경 쓰면 됩니다.

실제로 HttpRequestMessage 및 HttpClientHandler 할당은 기본적으로 그 안에 구현되었습니다.

간단히 소개했지만 기본적으로 HttpClient의 구현은 매우 명확한 업무 분업을 갖고 있으며 더 이상 모든 설정이 webrequest에 집중되어 있지 않다는 것을 알 수 있습니다. 명확한 작업 분할의 가장 직접적인 이점은 HttpClient를 사용하여 여러 요청을 공유할 수 있다는 것입니다. 블로그 게시물을 참조하세요.

기본 HttpClient는 단일 HttpClient 전송을 시작할 수 있는 가장 간단한 방법입니다. 원하는 만큼 많은 HTTP 요청을 동시에 보내는 데 사용할 수 있으므로 많은 시나리오에서 하나의 HttpClient를 생성한 다음 이를 모든 요청에 ​​사용할 수 있습니다.

즉, 시스템에서는 HttpWebReqest처럼 하나의 HttpClient를 공유할 수 있습니다. 기본적으로 모든 요청은 리소스 소비를 줄이기 위해 개체를 재정의해야 합니다.

2. OSS.Http 리팩터링

주제로 돌아가서 앞서 말했듯이 .Net Standard에서는 전혀 제공되지 않습니다. httpWebRequest의 지원으로 인해 다시 구현하기로 결정하게 되었습니다. 과거에는 httpWebRequest가 조잡했기 때문에 기본적으로 상위 계층에서는 특정 기본 구현을 전혀 건드릴 필요가 없었습니다. RestSharp의 핵심을 이해했다면 관심 있는 학생들은 OSS.Http 코드 아래의 Old 브랜치를 참조할 수 있습니다.

재구성하기 전에는 HttpClient에 대해 잘 몰랐기 때문에 기존 프레임워크 프로세스를 계속 유지하고 구현을 변환하고 싶었습니다. 그러나 클라이언트 문서를 검토하고 조사한 결과 많은 캡슐화가 완전히 불필요하고 프로세스도 변경되었음을 발견하여 원래 프레임워크에서 많은 것을 삭제하고 최종 구현을 재구성했습니다.

물론 현재 HttpClient 자체의 구현은 충분히 간단하고 명확하지만 많은 경우 POST, GET 및 기타 메서드를 직접 호출하면 일부 코드의 재사용이 줄어듭니다. 예를 들어 OSS.Social 프로젝트에서는 전역 요청 제어를 달성하려면 하단에 RestCommon 메서드를 구현해야 하며 호출자는 Url, HttpMothed 및 Parameter만 제공하면 됩니다.

여기서는 프리젠테이션으로 간단한 흐름도를 그렸습니다.

기본적으로 코드는 Github에 있으니 큰 차이는 없습니다.

Mos 파일 아래: Enum.cs 열거형 클래스, FileParameter.cs 파일 매개변수 클래스, FormParameter 양식 양식 매개변수 클래스, OsHttpRequest 요청 매개변수 클래스,

OsRest. cs는 현재 구현되고 있는 주요 캡슐화 클래스이며, HttpClient 자체가 범용 기능을 갖출 수 있도록 OsRest는 HttpClient를 상속하고 RestSend 메서드도 제공하는데, 여기서 프로세스가 완료되고 최종적으로 SendAsync 메서드가 호출되어 요청이 실행된다.

RestUtil.cs 보조 클래스는 전역 OsRest(HttpClient) 공유를 완료하고 기본 HttpClientHandler 구현을 정의합니다. 이 클래스를 직접 호출할 수 있습니다.

프로세스의 실행 사용자 정의 설정은 OSHttpRequest의 RequestSet 위임 속성에서 설정할 수 있습니다. 예를 들어 액세스 유형을 json으로 설정할 수 있습니다.

3. 발생하기 쉬운 문제

전체 재구성 후 코드가 많지는 않지만 여전히 모두가 공유할 수 있는 문제가 있을 것입니다

1. 헤더 할당 문제는 제 첫 번째 부분을 참조하세요. 서로 다른 헤더를 구별하세요. 그렇지 않으면 잘못된 값 오류가 보고될 수 있습니다.

2 . 위의 순서도에서 "Get인지 여부"에 대한 판단이 있음을 알 수 있습니다. 왜냐하면 Get 요청인 경우 HttpWebReqest와 마찬가지로 Content에 값을 할당할 수 없기 때문입니다. get 요청이 GetRequestStream 메서드를 호출하면 이 조건자 유형에 대해 "Content-body" 오류가 포함된 요청을 보낼 수 없습니다. 물론, OSS.Http를 요청으로 사용한다면 그런 문제는 없을 것입니다.

3. 업로드된 파일과 동시에 업로드된 폼 매개변수는 별도의 폼 매개변수 제출과 다르므로 취급에 주의하시기 바랍니다. OsRest 클래스를 참조하는 방법을 알았습니다. 이제 처리되었습니다.

위는 표준 라이브러리를 지원하기 위한 OSS.Http의 기본 HttpClient 재구성 및 캡슐화에 대한 자세한 소개입니다. 더 많은 관련 내용을 보려면 PHP 중국어 웹사이트를 참고하세요. (www.php.cn)!