【入门】Golang语法

1. 10min语法速学

不想粘贴教程，但初学真的记不住，来回查找还不如先集中在一起。熟练了再删掉……

1.1. Struct

定义属性，可以同时定义多个：

type Rectangle struct {
    length, width int
    area float64
}

可自动转换为指针：

pr := new (Rectangle) //get pointer to an instance with new keyword
(*pr).width = 6 //set value using . notation by dereferencing pointer.
pr.length = 8 //set value using . notation - same as previous.  There is no -> operator like in c++. Go automatically converts

r2 := Rectangle{width:3, name:"my_r2", length:4}

许多面向对象语言，类方法都有一个 this 或者 self 隐式的只想当前的实例，但在 Go 中，并不存这样的概念。当定义方法是，都会给定一个变量名，如上面的例子中是:

func (r Rectangle) Area() int {
    return r.length * r.width
}

上面代码中，调用 Area 方法时，Rectangle 实例通过值传递。当然，也可以通过引用传递。对于方法而言，使用引用和值并没有太大的区别。Go 本身会自动识别，并且完成转换。

1.1.1. 返回值命名 & 通过多个返回值处理错误

自动根据返回值名称，返回数据：

package main

import (
    "fmt"
    "errors"
    "math"
)

//name the return variables - by default it will have 'zero-ed' values i.e. numbers are 0, string is empty, etc.
func MySqrt2(f float64) (ret float64, err error) {
    if (f < 0) {
        //then you can use those variables in code
        ret = float64(math.NaN())
        err = errors.New("I won't be able to do a sqrt of negative number!")
    } else {
        ret = math.Sqrt(f)
        //err is not assigned, so it gets default value nil
    }
    //automatically return the named return variables ret and err
    return
}

func main() {
    fmt.Println(MySqrt2(5))
}

1.1.2. 支持多继承

// multiple inheritance
type CameraPhone struct {
    Camera //has anonymous camera
    Phone //has anonymous phone
}

1.2. 接口

//Shaper is an interface and has a single function Area that returns an int.
type Shaper interface {
   Area() int
}

type Rectangle struct {
   length, width int
}

//this function Area works on the type Rectangle and has the same function signature defined in the interface Shaper.  Therefore, Rectangle now implements the interface Shaper.
func (r Rectangle) Area() int {
   return r.length * r.width
}

func main() {
   r := Rectangle{length:5, width:3}
   fmt.Println("Rectangle r details are: ", r)
   fmt.Println("Rectangle r's area is: ", r.Area())

   s := Shaper(r)
   fmt.Println("Area of the Shape r is: ", s.Area())
}

在 C++ 或者 Java 中继承接口时，需要明确的声明这一关系，例如上面的代码，用 Java 来写的话，可能为如下的语句

public class Rectangle implements Shaper { //implementation here }

在 Go 中，无需表现出这层关系。上面代码中，接口 Shaper 定义一个方法 Area() int 。而Rectangle也定义了一个相同的方法 func (r Rectangle) Area() int 。所以， Go 会认为Rectangle实现了Shaper的接口。所以，我们可以定义Rectangle为Shaper类型： r := Shaper(r) ，之后调用Area()方法，输出Rectangle的面积。

让我们继续添加 Square，来看一看如何通过接口统一的访问每种类型的面积……

func main() {
   r := Rectangle{length:5, width:3}
   q := Square{side:5}
   shapesArr := [...]Shaper{r, q}

   fmt.Println("Looping through shapes for area ...")
   for n, _ := range shapesArr {
       fmt.Println("Shape details: ", shapesArr[n])
       fmt.Println("Area of this shape is: ", shapesArr[n].Area())
   }
}

对比 Java 实现接口，必须通过 implements 关键字，描述类之间的关系，在 C# 中则需要使用 : 代替 implements 。这种情况下，如果类之间的关系更新了，不得不修改这些核心的模块。

大多数项目，都有一个长期的架构和设计时期，在这期间需要不断的更新接口和数据结构，直到所有的因素都考虑到，然而这就需要不断的更新核心代码。一旦设计结构最终定好之后，如果没有太大的改动理由，是不会去更改类之间的层次结构的。在我工作过的项目中，架构是由专业的架构师负责，如果不是评审委员会同意架构是不会产生变化的。上游模块的改动往往导致下游模块也跟着一起改动。另一种方案，是重新封装现有的类，生成新的接口，但这往往又会造成系统庞大，难以管理。为了解决复杂性和模块的变化，设计模式应运而生。我承认，我非常喜欢设计模式和面向对象的编程过程。但是，设计模式很多，需要我们必须有很好的专业知识，也需要一个很长的学习过程。与其花费更多的设计时间，Go 可否能提供更直观简单的方式呢？

Golang可以动态的给一个现有的类，实现新的接口，更加灵活。

//new requirement that the Bus must be compatible with
type PersonalSpaceLaw interface {
    IsCompliantWithLaw() bool
}

func (b Bus) IsCompliantWithLaw() bool {
    return (b.l * b.b * b.h) / (b.rows * b.seatsPerRow) >= 3
}

看到没，之前的代码一点没改，就完成了结构的扩展。是不是更加干净、灵活，对新需求更加容易扩展。

1.3. 错误机制

error 往往是能预知的错误，但是也可能出现一些不可预知的错误，例如数组越界，这种错误可能会导致程序非正常退出，在 Go 语言中称之为 panic。

在 Python、Java 等语言中有 try...catch 机制，在 try 中捕获各种类型的异常，在 catch 中定义异常处理的行为。Go 语言也提供了类似的机制 defer 和 recover。

func get(index int) (ret int) {
    defer func() {
        if r := recover(); r != nil {
            fmt.Println("Some error happened!", r)
            ret = -1
        }
    }()
    arr := [3]int{2, 3, 4}
    return arr[index]
}

func main() {
    fmt.Println(get(5))
    fmt.Println("finished")
}

在 get 函数中，使用 defer 定义了异常处理的函数，在协程退出前，会执行完 defer 挂载的任务。因此如果触发了panic，控制权就交给了defer。

$ go run .
Some error happened! runtime error: index out of range [5] with length 3
-1
finished

在 defer 的处理逻辑中，使用 recover 使程序恢复正常，并且将返回值设置为 -1，在这里也可以不处理返回值，如果不处理返回值，返回值将被置为默认值 0。

1.3.1. defer语句

在下面的代码中，假设要执行一系列的数据库操作：打开数据库连接，执行操作。之后假设，数据库操作出现异常，程序会立即返回。如果什么也不做，数据库连接将会一直持续，如果使用 defer 语句，可以保证在程序返回之前，数据库连接被正确的关闭。

func doDBOperations() {
     connectToDB()
     fmt.Println("Defering the database disconnect.")
     defer disconnectFromDB() //function called here with defer
     fmt.Println("Doing some DB operations ...")
     fmt.Println("Oops! some crash or network error ...")
     fmt.Println("Returning from function here!")
     return //terminate the program
     // deferred function executed here just before actually returning, even if there is a return or abnormal termination before
}

多个 defer 语句的执行顺序：可以声明多个 defer 语句。当声明多个是，满足后进先出（last in first out-LIFO)的执行顺序，就相当于一个栈一样。

1.3.2. panic

panic 的一种常见用法是：当函数返回我们不知道如何处理（或不想处理）的错误值时，中止操作。如果创建新文件时遇到意外错误该如何处理？这里有一个很好的 panic 示例。

func main() {

    panic("a problem")

    _, err := os.Create("/tmp/file")
    if err != nil {
        panic(err)
    }
}

Defer 用于确保程序在执行完成后，会调用某个函数，一般是执行清理工作。

func main() {
    f := createFile("/tmp/defer.txt")
    defer closeFile(f)
    writeFile(f)
}

在 createFile 后立即得到一个文件对象，我们使用 defer 通过 closeFile 来关闭这个文件。这会在封闭函数（main）结束时执行，即 writeFile 完成以后。

1.3.3. 总结

实际上，Golang如此的处理，继承自Google对C++的编程规范——不允许使用 Exception 机制。

Exception有如下特性:

相比errcode, 具有明确的语义
try...catch... 可以实现代码跨层级跳转
通过Exception类继承，可以使用基类捕获不明确的错误类型

而Golang，由于不允许跳转，所以未实现try模式。panic则是作为第三个目的而实现的。

2. 常用命令

go run xxx.go
go build xxx.go
go get
go install
gofmt
gRPC

3. Go Modules & goproxy.cn

Go Modules 是 Go 1.11 推出的功能模块，前身是 vgo，成长于 Go 1.12，丰富于 Go 1.13 是 Go 更好的一种模块依赖管理解决方案实现。

而 Go Module Proxy 是随着 Go Modules 一起产生的模块代理协议，通过这个协议，我们可以实现 Go 模块代理，通过镜像网站下载相关依赖模块。

proxy.golang.org 为 Go 官方模块代理网站，不FQ中国用户是无法访问的，而 goproxy.cn （官方推荐是使用 Go1.13 或以上版本）是七牛云推出的非盈利性 Go 模块代理网站，为中国和世界上其他地方的 Gopher 们提供一个免费的、可靠的、持续在线的且经过 CDN 加速的模块代理，添加这个代理很简单：

# 开启 GO Modules 包管理方式
$ go env -w GO111MODULE=on
# 设置代理为 https://goproxy.cn
# 你也可以设置多个代理，通过逗号分隔开，模块从左至右设置的代理中查找获取
$ go env -w GOPROXY=https://goproxy.cn,direct

3.1. "module" != "package"

有一点需要纠正，就是“模块”和“包”，也就是 “module” 和 “package” 这两个术语并不是等价的，是 “集合” 跟 “元素” 的关系，“模块” 包含 “包”，“包” 属于 “模块”，一个 “模块” 是零个、一个或多个 “包” 的集合。

3.1.1. 语义化版本控制规范

Go Modules 默认认为，只要你的主版本号不变，那这个模块版本肯定就不包含重大变更，则我们 import 的时候 path 不会受到影响，比如 v1.0.0 和 v2.0.0，就是一个重大版本变更，在编写代码 import 模块的时候，v1版本的包名是 github.com/xx/xx ，v2版本的包名就是 github.com/xx/xx/v2 了，在我们使用go get的时候也需要带上完整的版本路径才能导入指定的版本。

4. 进阶

大道至简—GO语言最佳实践

GO语言关键特性
- 并发与协程
- 基于消息传递的通信方式
- 丰富实用的内置数据类型
- 函数多返回值
- Defer延迟处理机制
- 反射(reflect)
- 高性能HTTP Server
- 工程管理
- 编程规范
API框架的实现
公共组件能力
- 通用列表组件
- 通用表单组件
- 协程池
- 数据校验

5. 标准库

官方文档
中文解析
- time
- sync
- fmt
- strconv
- errors
- container
- path
- net/http
- net/http/httptest
- database/sql
- encoding/json
- ioutil.ReadFile
- os.Open
  - fp.Read
- io.ReadAtLeast
- bufio
  - NewReader
  - ReadLine
- bytes
- reflect
- context
- flag - 命令行参数解析

5.1. builtin

func append(slice []Type, elems ...Type) []Type
func cap(v Type) int
func close(c chan<- Type)
func complex(r, i FloatType) ComplexType
func copy(dst, src []Type) int
func delete(m map[Type]Type1, key Type)
func imag(c ComplexType) FloatType
func len(v Type) int
func make(t Type, size ...IntegerType) Type
func new(Type) *Type
func panic(v interface{})
func print(args ...Type)
func println(args ...Type)
func real(c ComplexType) FloatType
func recover() interface{}

5.2. time

Now()
String(): 转换为string

5.3. bytes

homepage

func Compare(a, b []byte) int
func Contains(b, subslice []byte) bool
func ContainsAny(b []byte, chars string) bool
func ContainsRune(b []byte, r rune) bool
func Count(s, sep []byte) int
func Equal(a, b []byte) bool
func EqualFold(s, t []byte) bool
func Fields(s []byte) [][]byte
func FieldsFunc(s []byte, f func(rune) bool) [][]byte
func HasPrefix(s, prefix []byte) bool
func HasSuffix(s, suffix []byte) bool
func Index(s, sep []byte) int
func IndexAny(s []byte, chars string) int
func IndexByte(b []byte, c byte) int
func IndexFunc(s []byte, f func(r rune) bool) int
func IndexRune(s []byte, r rune) int
func Join(s [][]byte, sep []byte) []byte
func LastIndex(s, sep []byte) int
func LastIndexAny(s []byte, chars string) int
func LastIndexByte(s []byte, c byte) int
func LastIndexFunc(s []byte, f func(r rune) bool) int
func Map(mapping func(r rune) rune, s []byte) []byte
func Repeat(b []byte, count int) []byte
func Replace(s, old, new []byte, n int) []byte
func ReplaceAll(s, old, new []byte) []byte
func Runes(s []byte) []rune
func Split(s, sep []byte) [][]byte
func SplitAfter(s, sep []byte) [][]byte
func SplitAfterN(s, sep []byte, n int) [][]byte
func SplitN(s, sep []byte, n int) [][]byte
func Title(s []byte) []byte
func ToLower(s []byte) []byte
func ToLowerSpecial(c unicode.SpecialCase, s []byte) []byte
func ToTitle(s []byte) []byte
func ToTitleSpecial(c unicode.SpecialCase, s []byte) []byte
func ToUpper(s []byte) []byte
func ToUpperSpecial(c unicode.SpecialCase, s []byte) []byte
func ToValidUTF8(s, replacement []byte) []byte
func Trim(s []byte, cutset string) []byte
func TrimFunc(s []byte, f func(r rune) bool) []byte
func TrimLeft(s []byte, cutset string) []byte
func TrimLeftFunc(s []byte, f func(r rune) bool) []byte
func TrimPrefix(s, prefix []byte) []byte
func TrimRight(s []byte, cutset string) []byte
func TrimRightFunc(s []byte, f func(r rune) bool) []byte
func TrimSpace(s []byte) []byte
func TrimSuffix(s, suffix []byte) []byte
type Buffer
    func NewBuffer(buf []byte) *Buffer
    func NewBufferString(s string) *Buffer
    func (b *Buffer) Bytes() []byte
    func (b *Buffer) Cap() int
    func (b *Buffer) Grow(n int)
    func (b *Buffer) Len() int
    func (b *Buffer) Next(n int) []byte
    func (b *Buffer) Read(p []byte) (n int, err error)
    func (b *Buffer) ReadByte() (byte, error)
    func (b *Buffer) ReadBytes(delim byte) (line []byte, err error)
    func (b *Buffer) ReadFrom(r io.Reader) (n int64, err error)
    func (b *Buffer) ReadRune() (r rune, size int, err error)
    func (b *Buffer) ReadString(delim byte) (line string, err error)
    func (b *Buffer) Reset()
    func (b *Buffer) String() string
    func (b *Buffer) Truncate(n int)
    func (b *Buffer) UnreadByte() error
    func (b *Buffer) UnreadRune() error
    func (b *Buffer) Write(p []byte) (n int, err error)
    func (b *Buffer) WriteByte(c byte) error
    func (b *Buffer) WriteRune(r rune) (n int, err error)
    func (b *Buffer) WriteString(s string) (n int, err error)
    func (b *Buffer) WriteTo(w io.Writer) (n int64, err error)
type Reader
    func NewReader(b []byte) *Reader
    func (r *Reader) Len() int
    func (r *Reader) Read(b []byte) (n int, err error)
    func (r *Reader) ReadAt(b []byte, off int64) (n int, err error)
    func (r *Reader) ReadByte() (byte, error)
    func (r *Reader) ReadRune() (ch rune, size int, err error)
    func (r *Reader) Reset(b []byte)
    func (r *Reader) Seek(offset int64, whence int) (int64, error)
    func (r *Reader) Size() int64
    func (r *Reader) UnreadByte() error
    func (r *Reader) UnreadRune() error
    func (r *Reader) WriteTo(w io.Writer) (n int64, err error)

5.4. strings

homepage

func Compare(a, b string) int
func Join(elems []string, sep string) string
func Count(s, substr string) int

func Contains(s, substr string) bool
// func ContainsAny(s, chars string) bool
// func ContainsRune(s string, r rune) bool
// func EqualFold(s, t string) bool
func Fields(s string) []string
func FieldsFunc(s string, f func(rune) bool) []string

func HasPrefix(s, prefix string) bool
func HasSuffix(s, suffix string) bool

func Index(s, substr string) int
// func IndexAny(s, chars string) int
func IndexByte(s string, c byte) int
// func IndexFunc(s string, f func(rune) bool) int
// func IndexRune(s string, r rune) int

func LastIndex(s, substr string) int
// func LastIndexAny(s, chars string) int
func LastIndexByte(s string, c byte) int
// func LastIndexFunc(s string, f func(rune) bool) int
// func Map(mapping func(rune) rune, s string) string

func Repeat(s string, count int) string
// func Replace(s, old, new string, n int) string
func ReplaceAll(s, old, new string) string

func Split(s, sep string) []string
func SplitAfter(s, sep string) []string
// func SplitAfterN(s, sep string, n int) []string
// func SplitN(s, sep string, n int) []string

func Title(s string) string
func ToTitle(s string) string
// func ToTitleSpecial(c unicode.SpecialCase, s string) string
func ToUpper(s string) string
func ToLower(s string) string
// func ToUpperSpecial(c unicode.SpecialCase, s string) string
// func ToLowerSpecial(c unicode.SpecialCase, s string) string
// func ToValidUTF8(s, replacement string) string

func Trim(s string, cutset string) string
// func TrimFunc(s string, f func(rune) bool) string
func TrimSpace(s string) string

func TrimLeft(s string, cutset string) string
func TrimRight(s string, cutset string) string
// func TrimLeftFunc(s string, f func(rune) bool) string
// func TrimRightFunc(s string, f func(rune) bool) string
func TrimPrefix(s, prefix string) string
func TrimSuffix(s, suffix string) string

5.5. fmt

homepage

func Sprintf(format string, a ...interface{}) string
func Errorf(format string, a ...interface{}) error

5.6. errors

5.7. path

func Base(path string) string
func Clean(path string) string
func Dir(path string) string
func Ext(path string) string
func IsAbs(path string) bool
func Join(elem ...string) string
func Match(pattern, name string) (matched bool, err error)
func Split(path string) (dir, file string)

5.7.1. path/filepath

func IsAbs(path string) bool
func Abs(path string) (string, error)
func Rel(basepath, targpath string) (string, error)

func Base(path string) string
func Clean(path string) string
func Split(path string) (dir, file string)
func SplitList(path string) []string

func Dir(path string) string
func Ext(path string) string
// func FromSlash(path string) string
// func ToSlash(path string) string

func HasPrefix(p, prefix string) bool
func Join(elem ...string) string
// func VolumeName(path string) string
// func EvalSymlinks(path string) (string, error)

func Match(pattern, name string) (matched bool, err error)
func Glob(pattern string) (matches []string, err error)
func Walk(root string, walkFn WalkFunc) error

5.8. os

homepage

exec包执行外部命令，它将os.StartProcess进行包装使得它更容易映射到stdin和stdout，并且利用pipe连接i/o．

func Chdir(dir string) error
func Environ() []string
func Getenv(key string) string

func Getwd() (dir string, err error)
func Hostname() (name string, err error)
func IsExist(err error) bool
func IsNotExist(err error) bool

func Mkdir(name string, perm FileMode) error
func MkdirAll(path string, perm FileMode) error

func Remove(name string) error
func RemoveAll(path string) error
func Rename(oldpath, newpath string) error
func SameFile(fi1, fi2 FileInfo) bool

func Open(name string) (*File, error)

type Process
    func FindProcess(pid int) (*Process, error)
    func StartProcess(name string, argv []string, attr *ProcAttr) (*Process, error)
    func (p *Process) Kill() error
    func (p *Process) Release() error
    func (p *Process) Signal(sig Signal) error
    func (p *Process) Wait() (*ProcessState, error)
type ProcessState
    func (p *ProcessState) ExitCode() int
    func (p *ProcessState) Exited() bool
    func (p *ProcessState) Pid() int
    func (p *ProcessState) String() string
    func (p *ProcessState) Success() bool
    func (p *ProcessState) Sys() interface{}
    func (p *ProcessState) SysUsage() interface{}
    func (p *ProcessState) SystemTime() time.Duration
    func (p *ProcessState) UserTime() time.Duration

5.8.1. os/exec

homepage

func LookPath(file string) (string, error)
type Cmd
    func Command(name string, arg ...string) *Cmd
    func CommandContext(ctx context.Context, name string, arg ...string) *Cmd
    func (c *Cmd) CombinedOutput() ([]byte, error)
    func (c *Cmd) Output() ([]byte, error)
    func (c *Cmd) Run() error
    func (c *Cmd) Start() error
    func (c *Cmd) StderrPipe() (io.ReadCloser, error)
    func (c *Cmd) StdinPipe() (io.WriteCloser, error)
    func (c *Cmd) StdoutPipe() (io.ReadCloser, error)
    func (c *Cmd) String() string
    func (c *Cmd) Wait() error

5.9. io

5.9.1. interface: io.Reader/Writer

csdn: golang中的io.Reader/Writer

简书: Go编程技巧-io.Reader/Writer

围绕io.Reader/Writer，有几个常用的实现：

net.Conn, os.Stdin, os.File: 网络、标准输入输出、文件的流读取
strings.Reader: 把字符串抽象成Reader
bytes.Reader: 把[]byte抽象成Reader
bytes.Buffer: 把[]byte抽象成Reader和Writer
bufio.Reader/Writer: 抽象成带缓冲的流读取（比如按行读写）

5.9.2. io/ioutil

homepage

func NopCloser(r io.Reader) io.ReadCloser
func ReadAll(r io.Reader) ([]byte, error)
func ReadDir(dirname string) ([]os.FileInfo, error)
func ReadFile(filename string) ([]byte, error)
func TempDir(dir, pattern string) (name string, err error)
func TempFile(dir, pattern string) (f *os.File, err error)
func WriteFile(filename string, data []byte, perm os.FileMode) error

5.10. bufio

homepage

func NewReader(rd io.Reader) *Reader

5.11. net

5.11.1. net/http

func Get(url string) (resp *Response, err error)
func Head(url string) (resp *Response, err error)
func Post(url, contentType string, body io.Reader) (resp *Response, err error)
func PostForm(url string, data url.Values) (resp *Response, err error)

6. 第三方库

posted @ 2020-07-08 20:30 brt2 阅读(361) 评论(0) 收藏举报

刷新页面返回顶部

i视觉(self, 知识库):

一个脑子内存不够大的程序猿，他的博客就一定更丰富和有内涵

【入门】Golang语法

1. 10min语法速学

1.1. Struct

1.1.1. 返回值命名 & 通过多个返回值处理错误

1.1.2. 支持多继承

1.2. 接口

1.3. 错误机制

1.3.1. defer语句

1.3.2. panic

1.3.3. 总结

2. 常用命令

3. Go Modules & goproxy.cn

3.1. "module" != "package"

3.1.1. 语义化版本控制规范

4. 进阶

5. 标准库

5.1. builtin

5.2. time

5.3. bytes

5.4. strings

5.5. fmt

5.6. errors

5.7. path

5.7.1. path/filepath

5.8. os

5.8.1. os/exec

5.9. io

5.9.1. interface: io.Reader/Writer

5.9.2. io/ioutil

5.10. bufio

5.11. net

5.11.1. net/http

6. 第三方库

__i视觉__(self, 知识库):

一个脑子内存不够大的程序猿，他的博客就一定更丰富和有内涵

【入门】Golang语法

1. 10min语法速学

1.1. Struct

1.1.1. 返回值命名 & 通过多个返回值处理错误

1.1.2. 支持多继承

1.2. 接口

1.3. 错误机制

1.3.1. defer语句

1.3.2. panic

1.3.3. 总结

2. 常用命令

3. Go Modules & goproxy.cn

3.1. "module" != "package"

3.1.1. 语义化版本控制规范

4. 进阶

5. 标准库

5.1. builtin

5.2. time

5.3. bytes

5.4. strings

5.5. fmt

5.6. errors

5.7. path

5.7.1. path/filepath

5.8. os

5.8.1. os/exec

5.9. io

5.9.1. interface: io.Reader/Writer

5.9.2. io/ioutil

5.10. bufio

5.11. net

5.11.1. net/http

6. 第三方库

i视觉(self, 知识库):