resty
v2.16.2
ไลบรารี HTTP และ REST Simple สำหรับ GO (ได้รับแรงบันดาลใจจาก Ruby Rest-client)
ส่วนคุณสมบัติอธิบายรายละเอียดเกี่ยวกับความสามารถในการพักผ่อน
string , []byte , struct , map , slice และ io.Reader ด้วยContent-Typeio.Reader*http.Request สามารถเข้าถึงได้ในระหว่างมิดเดิลแวร์และคำขอดำเนินการผ่าน Request.RawRequestRequest.RawRequest.GetBody()[]byte อาร์เรย์ - response.Body() หรือเข้าถึงเป็น string - response.String()response.Time() และเมื่อเรา response.ReceivedAt()JSON และ XMLJSON หากคุณจัดหา struct/map โดยไม่มี Content-Type ส่วนหัวapplication/problem+json & application/problem+xmlmultipart/form-dataRequest.SetContext รองรับBasicAuth และ BearerContentLength value สำหรับคำขอทั้งหมดหรือคำขอเฉพาะcurl -o Flag ดู SetOutputDirectory & SetOutputTimeout RedirectPolicy Proxy TLSClientConfig Transport ฯลฯContent-Type ที่คาดหวังเมื่อส่วนหัว Content-Type ตอบสนองหายไป อ้างถึง #92resty.New()http.RoundTripper ดู setTransportRequestAttempt และวัตถุ Request มีแอตทริบิวต์ AttemptHTTP/2 และ HTTP/1.1 และ HTTP/3 สามารถใช้กับการพักผ่อนดูความคิดเห็นนี้ได้ แนะนำให้ใช้ go1.20 ขึ้นไป
Resty เริ่มแรกเริ่มสนับสนุน go modules ตั้งแต่การเปิดตัว v1.10.0
การเริ่มต้น Resty V2 และเวอร์ชันที่สูงขึ้นมันจะรวบรวมแพ็คเกจ GO Modules อย่างเต็มที่ ต้องใช้เวอร์ชัน GO ที่มีความสามารถในการทำความเข้าใจ /vN :
Resty Author ยังเผยแพร่โครงการต่อไปนี้สำหรับชุมชน GO
struct # Go Modules
require github.com/go-resty/resty/v2 v2.16.2ตัวอย่างต่อไปนี้จะช่วยให้คุณสบายใจที่สุดเท่าที่จะเป็นไปได้ด้วยห้องสมุด Resty
// Import resty into your code and refer it as `resty`.
import "github.com/go-resty/resty/v2" // Create a Resty Client
client := resty . New ()
resp , err := client . R ().
EnableTrace ().
Get ( "https://httpbin.org/get" )
// Explore response object
fmt . Println ( "Response Info:" )
fmt . Println ( " Error :" , err )
fmt . Println ( " Status Code:" , resp . StatusCode ())
fmt . Println ( " Status :" , resp . Status ())
fmt . Println ( " Proto :" , resp . Proto ())
fmt . Println ( " Time :" , resp . Time ())
fmt . Println ( " Received At:" , resp . ReceivedAt ())
fmt . Println ( " Body : n " , resp )
fmt . Println ()
// Explore trace info
fmt . Println ( "Request Trace Info:" )
ti := resp . Request . TraceInfo ()
fmt . Println ( " DNSLookup :" , ti . DNSLookup )
fmt . Println ( " ConnTime :" , ti . ConnTime )
fmt . Println ( " TCPConnTime :" , ti . TCPConnTime )
fmt . Println ( " TLSHandshake :" , ti . TLSHandshake )
fmt . Println ( " ServerTime :" , ti . ServerTime )
fmt . Println ( " ResponseTime :" , ti . ResponseTime )
fmt . Println ( " TotalTime :" , ti . TotalTime )
fmt . Println ( " IsConnReused :" , ti . IsConnReused )
fmt . Println ( " IsConnWasIdle :" , ti . IsConnWasIdle )
fmt . Println ( " ConnIdleTime :" , ti . ConnIdleTime )
fmt . Println ( " RequestAttempt:" , ti . RequestAttempt )
fmt . Println ( " RemoteAddr :" , ti . RemoteAddr . String ())
/* Output
Response Info:
Error : <nil>
Status Code: 200
Status : 200 OK
Proto : HTTP/2.0
Time : 457.034718ms
Received At: 2020-09-14 15:35:29.784681 -0700 PDT m=+0.458137045
Body :
{
"args": {},
"headers": {
"Accept-Encoding": "gzip",
"Host": "httpbin.org",
"User-Agent": "go-resty/2.4.0 (https://github.com/go-resty/resty)",
"X-Amzn-Trace-Id": "Root=1-5f5ff031-000ff6292204aa6898e4de49"
},
"origin": "0.0.0.0",
"url": "https://httpbin.org/get"
}
Request Trace Info:
DNSLookup : 4.074657ms
ConnTime : 381.709936ms
TCPConnTime : 77.428048ms
TLSHandshake : 299.623597ms
ServerTime : 75.414703ms
ResponseTime : 79.337µs
TotalTime : 457.034718ms
IsConnReused : false
IsConnWasIdle : false
ConnIdleTime : 0s
RequestAttempt: 1
RemoteAddr : 3.221.81.55:443
*/ // Create a Resty Client
client := resty . New ()
resp , err := client . R ().
SetQueryParams ( map [ string ] string {
"page_no" : "1" ,
"limit" : "20" ,
"sort" : "name" ,
"order" : "asc" ,
"random" : strconv . FormatInt ( time . Now (). Unix (), 10 ),
}).
SetHeader ( "Accept" , "application/json" ).
SetAuthToken ( "BC594900518B4F7EAC75BD37F019E08FBC594900518B4F7EAC75BD37F019E08F" ).
Get ( "/search_result" )
// Sample of using Request.SetQueryString method
resp , err := client . R ().
SetQueryString ( "productId=232&template=fresh-sample&cat=resty&source=google&kw=buy a lot more" ).
SetHeader ( "Accept" , "application/json" ).
SetAuthToken ( "BC594900518B4F7EAC75BD37F019E08FBC594900518B4F7EAC75BD37F019E08F" ).
Get ( "/show_product" )
// If necessary, you can force response content type to tell Resty to parse a JSON response into your struct
resp , err := client . R ().
SetResult ( result ).
ForceContentType ( "application/json" ).
Get ( "v2/alpine/manifests/latest" ) // Create a Resty Client
client := resty . New ()
// POST JSON string
// No need to set content type, if you have client level setting
resp , err := client . R ().
SetHeader ( "Content-Type" , "application/json" ).
SetBody ( `{"username":"testuser", "password":"testpass"}` ).
SetResult ( & AuthSuccess {}). // or SetResult(AuthSuccess{}).
Post ( "https://myapp.com/login" )
// POST []byte array
// No need to set content type, if you have client level setting
resp , err := client . R ().
SetHeader ( "Content-Type" , "application/json" ).
SetBody ([] byte ( `{"username":"testuser", "password":"testpass"}` )).
SetResult ( & AuthSuccess {}). // or SetResult(AuthSuccess{}).
Post ( "https://myapp.com/login" )
// POST Struct, default is JSON content type. No need to set one
resp , err := client . R ().
SetBody ( User { Username : "testuser" , Password : "testpass" }).
SetResult ( & AuthSuccess {}). // or SetResult(AuthSuccess{}).
SetError ( & AuthError {}). // or SetError(AuthError{}).
Post ( "https://myapp.com/login" )
// POST Map, default is JSON content type. No need to set one
resp , err := client . R ().
SetBody ( map [ string ] interface {}{ "username" : "testuser" , "password" : "testpass" }).
SetResult ( & AuthSuccess {}). // or SetResult(AuthSuccess{}).
SetError ( & AuthError {}). // or SetError(AuthError{}).
Post ( "https://myapp.com/login" )
// POST of raw bytes for file upload. For example: upload file to Dropbox
fileBytes , _ := os . ReadFile ( "/Users/jeeva/mydocument.pdf" )
// See we are not setting content-type header, since go-resty automatically detects Content-Type for you
resp , err := client . R ().
SetBody ( fileBytes ).
SetContentLength ( true ). // Dropbox expects this value
SetAuthToken ( "<your-auth-token>" ).
SetError ( & DropboxError {}). // or SetError(DropboxError{}).
Post ( "https://content.dropboxapi.com/1/files_put/auto/resty/mydocument.pdf" ) // for upload Dropbox supports PUT too
// Note: resty detects Content-Type for request body/payload if content type header is not set.
// * For struct and map data type defaults to 'application/json'
// * Fallback is plain text content type คุณสามารถใช้ชุดค่า PUT ที่หลากหลายเช่นแสดงให้เห็นถึง POST
// Note: This is one sample of PUT method usage, refer POST for more combination
// Create a Resty Client
client := resty . New ()
// Request goes as JSON content type
// No need to set auth token, error, if you have client level settings
resp , err := client . R ().
SetBody ( Article {
Title : "go-resty" ,
Content : "This is my article content, oh ya!" ,
Author : "Jeevanandam M" ,
Tags : [] string { "article" , "sample" , "resty" },
}).
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
SetError ( & Error {}). // or SetError(Error{}).
Put ( "https://myapp.com/article/1234" ) คุณสามารถใช้ชุด PATCH แบบต่างๆที่หลากหลายเช่นแสดงให้เห็นถึง POST
// Note: This is one sample of PUT method usage, refer POST for more combination
// Create a Resty Client
client := resty . New ()
// Request goes as JSON content type
// No need to set auth token, error, if you have client level settings
resp , err := client . R ().
SetBody ( Article {
Tags : [] string { "new tag1" , "new tag2" },
}).
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
SetError ( & Error {}). // or SetError(Error{}).
Patch ( "https://myapp.com/articles/1234" ) // Create a Resty Client
client := resty . New ()
// DELETE a article
// No need to set auth token, error, if you have client level settings
resp , err := client . R ().
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
SetError ( & Error {}). // or SetError(Error{}).
Delete ( "https://myapp.com/articles/1234" )
// DELETE a articles with payload/body as a JSON string
// No need to set auth token, error, if you have client level settings
resp , err := client . R ().
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
SetError ( & Error {}). // or SetError(Error{}).
SetHeader ( "Content-Type" , "application/json" ).
SetBody ( `{article_ids: [1002, 1006, 1007, 87683, 45432] }` ).
Delete ( "https://myapp.com/articles" )
// HEAD of resource
// No need to set auth token, if you have client level settings
resp , err := client . R ().
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
Head ( "https://myapp.com/videos/hi-res-video" )
// OPTIONS of resource
// No need to set auth token, if you have client level settings
resp , err := client . R ().
SetAuthToken ( "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ).
Options ( "https://myapp.com/servers/nyc-dc-01" ) ผู้ใช้สามารถลงทะเบียนตัวเลือกของไลบรารี JSON/XML ลงใน Resty หรือเขียนของคุณเอง โดยค่าเริ่มต้นการลงทะเบียน encoding/json และ encoding/xml ตามลำดับ
// Example of registering json-iterator
import jsoniter "github.com/json-iterator/go"
json := jsoniter . ConfigCompatibleWithStandardLibrary
client := resty . New ().
SetJSONMarshaler ( json . Marshal ).
SetJSONUnmarshaler ( json . Unmarshal )
// similarly user could do for XML too with -
client . SetXMLMarshaler ( xml . Marshal ).
SetXMLUnmarshaler ( xml . Unmarshal ) profileImgBytes , _ := os . ReadFile ( "/Users/jeeva/test-img.png" )
notesBytes , _ := os . ReadFile ( "/Users/jeeva/text-file.txt" )
// Create a Resty Client
client := resty . New ()
resp , err := client . R ().
SetFileReader ( "profile_img" , "test-img.png" , bytes . NewReader ( profileImgBytes )).
SetFileReader ( "notes" , "text-file.txt" , bytes . NewReader ( notesBytes )).
SetFormData ( map [ string ] string {
"first_name" : "Jeevanandam" ,
"last_name" : "M" ,
}).
Post ( "http://myapp.com/upload" ) // Create a Resty Client
client := resty . New ()
// Single file scenario
resp , err := client . R ().
SetFile ( "profile_img" , "/Users/jeeva/test-img.png" ).
Post ( "http://myapp.com/upload" )
// Multiple files scenario
resp , err := client . R ().
SetFiles ( map [ string ] string {
"profile_img" : "/Users/jeeva/test-img.png" ,
"notes" : "/Users/jeeva/text-file.txt" ,
}).
Post ( "http://myapp.com/upload" )
// Multipart of form fields and files
resp , err := client . R ().
SetFiles ( map [ string ] string {
"profile_img" : "/Users/jeeva/test-img.png" ,
"notes" : "/Users/jeeva/text-file.txt" ,
}).
SetFormData ( map [ string ] string {
"first_name" : "Jeevanandam" ,
"last_name" : "M" ,
"zip_code" : "00001" ,
"city" : "my city" ,
"access_token" : "C6A79608-782F-4ED0-A11D-BD82FAD829CD" ,
}).
Post ( "http://myapp.com/profile" ) // Create a Resty Client
client := resty . New ()
// just mentioning about POST as an example with simple flow
// User Login
resp , err := client . R ().
SetFormData ( map [ string ] string {
"username" : "jeeva" ,
"password" : "mypass" ,
}).
Post ( "http://myapp.com/login" )
// Followed by profile update
resp , err := client . R ().
SetFormData ( map [ string ] string {
"first_name" : "Jeevanandam" ,
"last_name" : "M" ,
"zip_code" : "00001" ,
"city" : "new city update" ,
}).
Post ( "http://myapp.com/profile" )
// Multi value form data
criteria := url. Values {
"search_criteria" : [] string { "book" , "glass" , "pencil" },
}
resp , err := client . R ().
SetFormDataFromValues ( criteria ).
Post ( "http://myapp.com/search" ) // Create a Resty Client
client := resty . New ()
// Setting output directory path, If directory not exists then resty creates one!
// This is optional one, if you're planning using absolute path in
// `Request.SetOutput` and can used together.
client . SetOutputDirectory ( "/Users/jeeva/Downloads" )
// HTTP response gets saved into file, similar to curl -o flag
_ , err := client . R ().
SetOutput ( "plugin/ReplyWithHeader-v5.1-beta.zip" ).
Get ( "http://bit.ly/1LouEKr" )
// OR using absolute path
// Note: output directory path is not used for absolute path
_ , err := client . R ().
SetOutput ( "/MyDownloads/plugin/ReplyWithHeader-v5.1-beta.zip" ).
Get ( "http://bit.ly/1LouEKr" )Resty ให้พารามิเตอร์เส้นทาง URL คำขอแบบไดนามิกที่ใช้งานง่าย พารามิเตอร์สามารถตั้งค่าได้ที่ไคลเอนต์และระดับคำขอ ค่าพารามิเตอร์ระดับไคลเอนต์สามารถถูกแทนที่ที่ระดับคำขอ
// Create a Resty Client
client := resty . New ()
client . R (). SetPathParams ( map [ string ] string {
"userId" : "[email protected]" ,
"subAccountId" : "100002" ,
}).
Get ( "/v1/users/{userId}/{subAccountId}/details" )
// Result:
// Composed URL - /v1/users/[email protected]/100002/details Resty ให้ความสามารถมิดเดิลแวร์ในการจัดการสำหรับการร้องขอและการตอบกลับ มันมีความยืดหยุ่นมากกว่าวิธีการโทรกลับ
// Create a Resty Client
client := resty . New ()
// Registering Request Middleware
client . OnBeforeRequest ( func ( c * resty. Client , req * resty. Request ) error {
// Now you have access to Client and current Request object
// manipulate it as per your need
return nil // if its success otherwise return error
})
// Registering Response Middleware
client . OnAfterResponse ( func ( c * resty. Client , resp * resty. Response ) error {
// Now you have access to Client and current Response object
// manipulate it as per your need
return nil // if its success otherwise return error
})Resty ให้ hooks onerror ที่อาจเรียกเพราะ:
หากมีการตอบสนองจากเซิร์ฟเวอร์ข้อผิดพลาดดั้งเดิมจะถูกห่อหุ้มด้วย *resty.ResponseError ซึ่งมีการตอบสนองล่าสุดที่ได้รับ
// Create a Resty Client
client := resty . New ()
client . OnError ( func ( req * resty. Request , err error ) {
if v , ok := err .( * resty. ResponseError ); ok {
// v.Response contains the last response from the server
// v.Err contains the original error
}
// Log the error, increment a metric, etc...
})อ้างอิง: curl_cmd_test.go
// Create a Resty Client
client := resty . New ()
resp , err := client . R ().
SetDebug ( true ).
EnableGenerateCurlOnDebug (). // CURL command generated when debug mode enabled with this option
SetBody ( map [ string ] string { "name" : "Alex" }).
Post ( "https://httpbin.org/post" )
curlCmdExecuted := resp . Request . GenerateCurlCommand ()
// Explore curl command
fmt . Println ( "Curl Command: n " , curlCmdExecuted + " n " )
/* Output
Curl Command:
curl -X POST -H 'Content-Type: application/json' -H 'User-Agent: go-resty/2.14.0 (https://github.com/go-resty/resty)' -d '{"name":"Alex"}' https://httpbin.org/post
*/ Resty ให้นโยบายการเปลี่ยนเส้นทางไม่กี่อย่างที่สนับสนุนนโยบายหลายอย่างด้วยกัน
// Create a Resty Client
client := resty . New ()
// Assign Client Redirect Policy. Create one as per you need
client . SetRedirectPolicy ( resty . FlexibleRedirectPolicy ( 15 ))
// Wanna multiple policies such as redirect count, domain name check, etc
client . SetRedirectPolicy ( resty . FlexibleRedirectPolicy ( 20 ),
resty . DomainCheckRedirectPolicy ( "host1.com" , "host2.org" , "host3.net" ))ใช้อินเทอร์เฟซ RedirectPolicy และลงทะเบียนกับ Resty Client ดูเปลี่ยนเส้นทางไปดูข้อมูลเพิ่มเติม
// Create a Resty Client
client := resty . New ()
// Using raw func into resty.SetRedirectPolicy
client . SetRedirectPolicy ( resty . RedirectPolicyFunc ( func ( req * http. Request , via [] * http. Request ) error {
// Implement your logic here
// return nil for continue redirect otherwise return error to stop/prevent redirect
return nil
}))
//---------------------------------------------------
// Using struct create more flexible redirect policy
type CustomRedirectPolicy struct {
// variables goes here
}
func ( c * CustomRedirectPolicy ) Apply ( req * http. Request , via [] * http. Request ) error {
// Implement your logic here
// return nil for continue redirect otherwise return error to stop/prevent redirect
return nil
}
// Registering in resty
client . SetRedirectPolicy ( CustomRedirectPolicy { /* initialize variables */ }) // Create a Resty Client
client := resty . New ()
// Custom Root certificates, just supply .pem file.
// you can add one or more root certificates, its get appended
client . SetRootCertificate ( "/path/to/root/pemFile1.pem" )
client . SetRootCertificate ( "/path/to/root/pemFile2.pem" )
// ... and so on!
// Adding Client Certificates, you add one or more certificates
// Sample for creating certificate object
// Parsing public/private key pair from a pair of files. The files must contain PEM encoded data.
cert1 , err := tls . LoadX509KeyPair ( "certs/client.pem" , "certs/client.key" )
if err != nil {
log . Fatalf ( "ERROR client certificate: %s" , err )
}
// ...
// You add one or more certificates
client . SetCertificates ( cert1 , cert2 , cert3 ) // Custom Root certificates from string
// You can pass you certificates through env variables as strings
// you can add one or more root certificates, its get appended
client . SetRootCertificateFromString ( "-----BEGIN CERTIFICATE-----content-----END CERTIFICATE-----" )
client . SetRootCertificateFromString ( "-----BEGIN CERTIFICATE-----content-----END CERTIFICATE-----" )
// ... and so on!
// Adding Client Certificates, you add one or more certificates
// Sample for creating certificate object
// Parsing public/private key pair from a pair of files. The files must contain PEM encoded data.
cert1 , err := tls . X509KeyPair ([] byte ( "-----BEGIN CERTIFICATE-----content-----END CERTIFICATE-----" ), [] byte ( "-----BEGIN CERTIFICATE-----content-----END CERTIFICATE-----" ))
if err != nil {
log . Fatalf ( "ERROR client certificate: %s" , err )
}
// ...
// You add one or more certificates
client . SetCertificates ( cert1 , cert2 , cert3 ) Go เริ่มต้นรองรับพร็อกซีผ่านตัวแปรสภาพแวดล้อม HTTP_PROXY Resty ให้การสนับสนุนผ่าน SetProxy & RemoveProxy เลือกตามความต้องการของคุณ
การตั้งค่า พร็อกซีระดับไคลเอนต์ ใช้กับคำขอทั้งหมด
// Create a Resty Client
client := resty . New ()
// Setting a Proxy URL and Port
client . SetProxy ( "http://proxyserver:8888" )
// Want to remove proxy setting
client . RemoveProxy ()Resty ใช้ backoff เพื่อเพิ่มช่วงเวลาใหม่หลังจากความพยายามแต่ละครั้ง
ตัวอย่างการใช้งาน:
// Create a Resty Client
client := resty . New ()
// Retries are configured per client
client .
// Set retry count to non zero to enable retries
SetRetryCount ( 3 ).
// You can override initial retry wait time.
// Default is 100 milliseconds.
SetRetryWaitTime ( 5 * time . Second ).
// MaxWaitTime can be overridden as well.
// Default is 2 seconds.
SetRetryMaxWaitTime ( 20 * time . Second ).
// SetRetryAfter sets callback to calculate wait time between retries.
// Default (nil) implies exponential backoff with jitter
SetRetryAfter ( func ( client * resty. Client , resp * resty. Response ) (time. Duration , error ) {
return 0 , errors . New ( "quota exceeded" )
})โดยค่าเริ่มต้น Resty จะลองคำขอที่ส่งคืนข้อผิดพลาดที่ไม่ใช่ NIL ระหว่างการดำเนินการ ดังนั้นการตั้งค่าข้างต้นจะส่งผลให้เกิดการร้องขอการลองใหม่ที่มีข้อผิดพลาดที่ไม่ใช่ NIL ถึง 3 ครั้งโดยการล่าช้าเพิ่มขึ้นหลังจากการพยายามแต่ละครั้ง
คุณสามารถเลือกให้ลูกค้าได้ด้วยเงื่อนไขการลองใหม่ที่กำหนดเอง:
// Create a Resty Client
client := resty . New ()
client . AddRetryCondition (
// RetryConditionFunc type is for retry condition function
// input: non-nil Response OR request execution error
func ( r * resty. Response , err error ) bool {
return r . StatusCode () == http . StatusTooManyRequests
},
) ตัวอย่างข้างต้นจะทำให้การร้องขอ Resty Retry ซึ่งลงท้ายด้วยรหัสสถานะ 429 Too Many Requests เป็นสิ่งสำคัญที่จะต้องทราบว่าเมื่อคุณระบุเงื่อนไขโดยใช้ AddRetryCondition มันจะแทนที่พฤติกรรมการลองใหม่เริ่มต้นซึ่งลองใช้ข้อผิดพลาดที่พบในระหว่างการร้องขอ หากคุณต้องการลองอีกครั้งในข้อผิดพลาดที่พบในระหว่างการร้องขอคล้ายกับพฤติกรรมเริ่มต้นคุณจะต้องกำหนดค่าดังนี้:
// Create a Resty Client
client := resty . New ()
client . AddRetryCondition (
func ( r * resty. Response , err error ) bool {
// Including "err != nil" emulates the default retry behavior for errors encountered during the request.
return err != nil || r . StatusCode () == http . StatusTooManyRequests
},
)สามารถเพิ่มเงื่อนไขการลองหลายครั้งได้ โปรดทราบว่าหากมีการระบุหลายเงื่อนไขการลองใหม่จะเกิดขึ้นหากตรงตามเงื่อนไขใด ๆ
นอกจากนี้ยังเป็นไปได้ที่จะใช้ resty.Backoff(...) เพื่อให้มีการใช้สถานการณ์ใหม่โดยพลการ อ้างอิง.
// Create a Resty Client
client := resty . New ()
// Allow GET request with Payload. This is disabled by default.
client . SetAllowGetMethodPayload ( true ) // Here you go!
// Client 1
client1 := resty . New ()
client1 . R (). Get ( "http://httpbin.org" )
// ...
// Client 2
client2 := resty . New ()
client2 . R (). Head ( "http://httpbin.org" )
// ...
// Bend it as per your need!!! // Create a Resty Client
client := resty . New ()
// Unique settings at Client level
//--------------------------------
// Enable debug mode
client . SetDebug ( true )
// Assign Client TLSClientConfig
// One can set custom root-certificate. Refer: http://golang.org/pkg/crypto/tls/#example_Dial
client . SetTLSClientConfig ( & tls. Config { RootCAs : roots })
// or One can disable security check (https)
client . SetTLSClientConfig ( & tls. Config { InsecureSkipVerify : true })
// Set client timeout as per your need
client . SetTimeout ( 1 * time . Minute )
// You can override all below settings and options at request level if you want to
//--------------------------------------------------------------------------------
// Host URL for all request. So you can use relative URL in the request
client . SetBaseURL ( "http://httpbin.org" )
// Headers for all request
client . SetHeader ( "Accept" , "application/json" )
client . SetHeaders ( map [ string ] string {
"Content-Type" : "application/json" ,
"User-Agent" : "My custom User Agent String" ,
})
// Cookies for all request
client . SetCookie ( & http. Cookie {
Name : "go-resty" ,
Value : "This is cookie value" ,
Path : "/" ,
Domain : "sample.com" ,
MaxAge : 36000 ,
HttpOnly : true ,
Secure : false ,
})
client . SetCookies ( cookies )
// URL query parameters for all request
client . SetQueryParam ( "user_id" , "00001" )
client . SetQueryParams ( map [ string ] string { // sample of those who use this manner
"api_key" : "api-key-here" ,
"api_secret" : "api-secret" ,
})
client . R (). SetQueryString ( "productId=232&template=fresh-sample&cat=resty&source=google&kw=buy a lot more" )
// Form data for all request. Typically used with POST and PUT
client . SetFormData ( map [ string ] string {
"access_token" : "BC594900-518B-4F7E-AC75-BD37F019E08F" ,
})
// Basic Auth for all request
client . SetBasicAuth ( "myuser" , "mypass" )
// Bearer Auth Token for all request
client . SetAuthToken ( "BC594900518B4F7EAC75BD37F019E08FBC594900518B4F7EAC75BD37F019E08F" )
// Enabling Content length value for all request
client . SetContentLength ( true )
// Registering global Error object structure for JSON/XML request
client . SetError ( & Error {}) // or resty.SetError(Error{}) unixSocket := "/var/run/my_socket.sock"
// Create a Go's http.Transport so we can set it in resty.
transport := http. Transport {
Dial : func ( _ , _ string ) (net. Conn , error ) {
return net . Dial ( "unix" , unixSocket )
},
}
// Create a Resty Client
client := resty . New ()
// Set the previous transport that we created, set the scheme of the communication to the
// socket and set the unixSocket as the HostURL.
client . SetTransport ( & transport ). SetScheme ( "http" ). SetBaseURL ( unixSocket )
// No need to write the host's URL on the request, just the path.
client . R (). Get ( "http://localhost/index.html" )Resty สามารถสร้างทดสอบและพึ่งพาผ่าน Bazel ตัวอย่างเช่นในการเรียกใช้การทดสอบทั้งหมด:
bazel test :resty_test ในการเยาะเย้ยคำขอ HTTP เมื่อทดสอบแอปพลิเคชันของคุณคุณสามารถใช้ไลบรารี httpmock
เมื่อใช้ไคลเอนต์ Resty เริ่มต้นคุณควรส่งไคลเอนต์ไปยังไลบรารีดังต่อไปนี้:
// Create a Resty Client
client := resty . New ()
// Get the underlying HTTP Client and set it to Mock
httpmock . ActivateNonDefault ( client . GetClient ())ตัวอย่างรายละเอียดเพิ่มเติมเกี่ยวกับการเยาะเย้ย Resty HTTP คำขอโดยใช้ Ginko สามารถพบได้ที่นี่
Resty เผยแพร่เวอร์ชันตามเวอร์ชันความหมาย
gopkg.in สำหรับการกำหนดเวอร์ชันห้องสมุดgo mod อย่างเต็มที่ตั้งแต่การเปิดตัว v1.10.0gopkg.in เพื่อจัดสรรเวอร์ชัน gopkg.in/resty.vX ชี้ไปที่เวอร์ชันที่ติดแท็กที่เหมาะสม X หมายถึงหมายเลขซีรีย์เวอร์ชันและเป็นรุ่นที่เสถียรสำหรับการใช้งานการผลิต สำหรับเช่น gopkg.in/resty.v0ฉันยินดีต้อนรับการมีส่วนร่วมของคุณ! หากคุณพบการปรับปรุงหรือปัญหาใด ๆ ที่คุณต้องการแก้ไขอย่าลังเลที่จะส่งคำขอดึงฉันชอบคำขอดึงที่มีกรณีทดสอบสำหรับการแก้ไข/การปรับปรุง ฉันพยายามอย่างเต็มที่ที่จะนำความครอบคลุมของรหัสที่ดีงาม อย่าลังเลที่จะเขียนการทดสอบ
BTW ฉันอยากรู้ว่าคุณคิดอย่างไรเกี่ยวกับ Resty กรุณาเปิดปัญหาหรือส่งอีเมลถึงฉัน มันมีความหมายกับฉันมาก
Jeevanandam M. ([email protected])
ดูหน้าสมาชิก
ดูหน้าผู้มีส่วนร่วม
Resty เปิดตัวภายใต้ใบอนุญาต MIT อ้างอิงไฟล์ใบอนุญาต
