http_methods_golang

README

http_method_golang

  http_methods_golang is a tiny wrapper for implementing HTTP request methods with Golang, and designed for reuse in every projects which don't have to implement those METHODS, when a simple communication is in need.

Methods

 HTTP Protocol defined serveal request methods for gaining data and contents using Network.

METHOD	STATUS
GET	√
POST	√
HEAD	--
PUT	--
DELETE	--
CONNECT	--
OPTIONS	--
TRACE	--
PATCH	--

OPERATE	STATUS
READ FILE	√
WRITE FILE	√

Install

go get github.com/kwangsing3/http_methods_golang

Usage

• GET

1. Would return HTML file if request target is website.
   
2. Would return bytes if request a data.

//GET: To get data from GET method, need to wait for respone
//<url>: request address.
func GET(url string) ([]byte, error)

• POST

1. Mostly use for encrypt request or requested using <form>.
2. May using for change server status or special request (Depends on the design).

//POST: To get data from POST method, need to wait for respone
//<url>: request address.
//<query>: The query you want to do, mostly are json, but still depends on the server you request.
func POST(url string, query []byte) ([]byte, error) 

Example

package main

import (
	"encoding/json"
	"fmt"
	HMG "github.com/kwangsing3/http_methods_golang"
)

func main() {

	/***GET request***/
	resultGET, errG := HMG.GET("https://example.com")
	if errG != nil {
		fmt.Println(errG.Error())
	} else {
		fmt.Println(string(resultGET))
	}


	// Multi thread example
	go func() {
		resultGET, errG := HMG.GET("https://example.com")
		if errG != nil {
			fmt.Println(errG.Error())
		} else {
			fmt.Println(string(resultGET))
		}
	}()


	/*** POST request***/
	query := struct {
		Msg string
	}{
		Msg: `New Message`, //query Struct depends on the server you request.
	}
	bytedata, _ := json.Marshal(query)
	resultPOST, errP := HMG.POST("https://example.com", bytedata)
	if errP != nil {
		fmt.Println(errP.Error())
	} else {
		fmt.Println(string(resultPOST))
	}

    return
}

Documentation

Index

• func GET(url string) ([]byte, error)
• func POST(url string, query []byte) ([]byte, error)
• func READFile(inputPath string) ([]byte, error)
• func WRITEFile(inputPath string, data []byte) error

Functions

func GET

func GET(url string) ([]byte, error)

GET: To get data from GET method, need to wait for respone <url>: request address.

func POST

func POST(url string, query []byte) ([]byte, error)

POST: To get data from POST method, need to wait for respone <url>: request address. <query>: The query you want to do, mostly are json, but still depends on the server you request.

func READFile

func READFile(inputPath string) ([]byte, error)

ReadFile: Standard Read file operate. <return> []byte.

func WRITEFile

func WRITEFile(inputPath string, data []byte) error

WriteFile: