guuid

package module
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 11, 2022 License: MIT Imports: 12 Imported by: 0

README

Guuid

Guuid 是一款由 Go 语言开发的 UUID 生成服务.


UUID(Universally Unique Identifier)全局唯一标识符,是指在一台机器上生成的数字,它保证对在同一时空中的所有机器都是唯一的。

Guuid使用了服务器主机名、运行的进程ID、时间戳、随机数、时序元素等一系列元素来保证生成UUID的唯一性。

UUID 16 bytes, 构成:

  • 4 bytes 主机名&进程ID
  • 4 bytes 时间戳
  • 4 bytes 计数器
  • 4 bytes 随机数

安装

$ go get -u github.com/dreamans/guuid/guuid-server
$ cd $GOPATH/src/github.com/dreamans/guuid/guuid-server
$ go install

运行

$GOPATH/bin/guuid-server -port 11223 -timeout 3

Usage:

-port 运行端口

-timeout 读写超时时间

运行成功:

⇨ http server started on [::]:11223

RestAPI

  • 获取UUID
$ curl http://127.0.0.1:11223/get

{
    "code": 200,
    "message": "OK",
    "uuid": "5d1b3abf-5ab2-2792-0000-00046b2155a4"
}
  • 批量获取UUID
$ curl http://127.0.0.1:11223/mget/100

{
    "code": 200,
    "message": "OK",
    "data": [
        "5d1b3abf-5ab2-27cd-0000-00056d61a5e0",
        "5d1b3abf-5ab2-27cd-0000-000648f72a80",
        ...
    ]
}

说明:
最多返回1000条记录
  • 获取简版UUID
$ curl http://127.0.0.1:11223/get/simple

{
    "code": 200,
    "message": "OK",
    "uuid": "5d1b3abf5ab22792000000046b2155a4"
}
  • 批量获取简版UUID
$ curl http://127.0.0.1:11223/mget/100/simple

{
    "code": 200,
    "message": "OK",
    "data": [
        "5d1b3abf5ab227cd000000056d61a5e0",
        "5d1b3abf5ab227cd0000000648f72a80",
        ...
    ]
}

部署

LVS -> Nginx -> guuid-server

  • Configure Nginx
upstream guuid_server {
    server localhost:11211;
    server localhost:11212;
    server localhost:11213;
}

server {
    listen          80;
    server_name     localhost;

    location / {
        proxy_pass      http://guuid_server;
    }
}

Documentation

Index

Constants

View Source
const (
	GET
	POST
)
View Source
const GUID_LENGTH = 36
View Source
const VERSION = "1.0.0"

Variables

This section is empty.

Functions

func CreateHandler

func CreateHandler(c echo.Context) error

func CreateMultiHandler

func CreateMultiHandler(c echo.Context) error

func CreateMultiSimpleHandler

func CreateMultiSimpleHandler(c echo.Context) error

func CreateSimpleHandler

func CreateSimpleHandler(c echo.Context) error

func ErrorHandler

func ErrorHandler(err error, c echo.Context)

func NewServer

func NewServer(addr string, readTimeout time.Duration, writeTimeout time.Duration) *webServer

func VersionHandler

func VersionHandler(c echo.Context) error

Types

type Response

type Response struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type ResponseData

type ResponseData struct {
	Response
	Data []string `json:"data"`
}

type ResponseItem

type ResponseItem struct {
	Response
	Uuid string `json:"uuid"`
}

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL