infra

Documentation

Overview

Common tools and helper functions

Index

• Constants
• Variables
• func Bind(c *gin.Context, obj interface{}) error
• func GenToken(id uint) string
• func GetDB() *gorm.DB
• func RandString(n int) string
• func TestDBFree(test_db *Sqlite)
• type CommonError
  • func NewError(key string, err error) CommonError
  • func NewValidatorError(err error) CommonError
• type Database
• type MySQL
  • func (mysql *MySQL) CloseDB()
  • func (mysql *MySQL) Get() *gorm.DB
  • func (mysql *MySQL) OpenDB(uri string)
• type Sqlite
  • func TestDBInit() *Sqlite
  • func (s *Sqlite) CloseDB()
  • func (s *Sqlite) Get() *gorm.DB
  • func (s *Sqlite) OpenDB(uri string)

Constants

const NBRandomPassword = "A String Very Very Very Niubilty!!@##$!@#4"

const NBSecretPassword = "A String Very Very Very Strong!!@##$!@#$"

Keep this two config private, it should not expose to open source

Variables

var (
	DB *gorm.DB
)

Functions

func Bind

func Bind(c *gin.Context, obj interface{}) error

Changed the c.MustBindWith() -> c.ShouldBindWith(). I don't want to auto return 400 when error happened. origin function is here: https://github.com/gin-gonic/gin/blob/master/context.go

func GenToken

func GenToken(id uint) string

A Util function to generate jwt_token which can be used in the request header

func GetDB

func GetDB() *gorm.DB

Using this function to get a connection, you can create your connection pool here.

func RandString

func RandString(n int) string

A helper function to generate random string

func TestDBFree

func TestDBFree(test_db *Sqlite)

Delete the database after running testing cases.

Types

type CommonError

type CommonError struct {
	Errors map[string]interface{} `json:"errors"`
}

My own Error type that will help return my customized Error info

{"database": {"hello":"no such table", error: "not_exists"}}

func NewError

func NewError(key string, err error) CommonError

Warp the error info in a object

func NewValidatorError

func NewValidatorError(err error) CommonError

To handle the error returned by c.Bind in gin framework https://github.com/go-playground/validator/blob/v9/_examples/translations/main.go

type Database

type Database interface {
	OpenDB(uri string)
	CloseDB()
	Get() *gorm.DB // TODO: remove later because of violating DI principle
}

type MySQL

type MySQL struct {
	// contains filtered or unexported fields
}

func (*MySQL) CloseDB

func (mysql *MySQL) CloseDB()

func (*MySQL) Get

func (mysql *MySQL) Get() *gorm.DB

func (*MySQL) OpenDB

func (mysql *MySQL) OpenDB(uri string)

type Sqlite

type Sqlite struct {
	// contains filtered or unexported fields
}

func TestDBInit

func TestDBInit() *Sqlite

This function will create a temporarily database for running testing cases

func (*Sqlite) CloseDB

func (s *Sqlite) CloseDB()

func (*Sqlite) Get

func (s *Sqlite) Get() *gorm.DB

func (*Sqlite) OpenDB

func (s *Sqlite) OpenDB(uri string)