https://github.com/issue9/query

解析查询参数到相应的结构体中
https://github.com/issue9/query

query query-params

Last synced: about 1 month ago
JSON representation

解析查询参数到相应的结构体中

• Host: GitHub
• URL: https://github.com/issue9/query
• Owner: issue9
• License: mit
• Created: 2018-05-03T12:55:28.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-08-18T20:00:06.000Z (over 1 year ago)
• Last Synced: 2024-11-17T12:30:24.315Z (over 1 year ago)
• Topics: query, query-params
• Language: Go
• Homepage: https://pkg.go.dev/github.com/issue9/query/v3
• Size: 88.9 KB
• Stars: 3
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
query

[![Go](https://github.com/issue9/query/workflows/Go/badge.svg)](https://github.com/issue9/query/actions?query=workflow%3AGo)

![Go version](https://img.shields.io/github/go-mod/go-version/issue9/query)

[![Go Report Card](https://goreportcard.com/badge/github.com/issue9/query)](https://goreportcard.com/report/github.com/issue9/query)

![License](https://img.shields.io/github/license/issue9/query)

[![codecov](https://codecov.io/gh/issue9/query/branch/master/graph/badge.svg)](https://codecov.io/gh/issue9/query)

[![PkgGoDev](https://pkg.go.dev/badge/github.com/issue9/query/v3)](https://pkg.go.dev/github.com/issue9/query/v3)

======

提供了将 web 请求中的查询参数解析到结构体的操作。

```go

type State int8

const (

    StateLocked State = iota+1

    StateDelete

)

// 实现 query.UnmarshalQueryer 接口

func (s *State) UnmarshalQuery(data string) error {

    switch data {

    case "locked":

        *s = StateLocked

    case "delete":

        *s = StateDelete

    default:

        return errors.New("无效的值")

    }

}

type struct Query {

    Page int `query:"page,1"`

    Size int `query:"size,20"`

    States []State `query:"state,normal"`

}

func handle(w http.ResponseWriter, r *http.Request) {

    q := &Query{}

    errors := query.Parse(r.URL.Query(), q)

    if len(errors) > 0 {

        // TODO

        return

    }

    // 请求参数为 /?page=1&size=2&state=normal,delete

    // 则 q 的值为

    // page = 1

    // size = 2

    // states = []State{StateLocked, StateDelete}

    //

    // 参数 state 也可使用以下方式

    // /?page=1&size=2&state=normal&normal=delete

}

```

版权

----

本项目采用 [MIT](https://opensource.org/licenses/MIT) 开源授权许可证，完整的授权说明可在 [LICENSE](LICENSE) 文件中找到。