net/mail

• import "net/mail"

• 概况

• 索引

• 例子

概况

Package mail 实现邮件消息的解析。

在大多数情况下，这个包遵循 RFC 5322 规定的语法，并由 RFC 6532 扩展。值得注意的分歧：

* Obsolete address formats are not parsed, including addresses with
  embedded route information.
* Group addresses are not parsed.
* The full range of spacing (the CFWS syntax element) is not supported,
  such as breaking addresses across lines.
* No unicode normalization is performed.

索引

• 变量

• func ParseAddressList(list string) ([]*Address, error)

• func ParseDate(date string) (time.Time, error)

• type Address

• func ParseAddress(address string) (*Address, error)

• func (a *Address) String() string

• type AddressParser

• func (p *AddressParser) Parse(address string) (*Address, error)

• func (p *AddressParser) ParseList(list string) ([]*Address, error)

• type Header

• func (h Header) AddressList(key string) ([]*Address, error)

• func (h Header) Date() (time.Time, error)

• func (h Header) Get(key string) string

• type Message

• func ReadMessage(r io.Reader) (msg *Message, err error)

例子

ParseAddress

ParseAddressList

ReadMessage

包文件

message.go

变量

var ErrHeaderNotPresent = errors.New("mail: header not in message")

func ParseAddressList（显示源文件）

func ParseAddressList(list string) ([]*Address, error)

ParseAddressList 将给定的字符串解析为地址列表。

例

package main

import (
	"fmt"
	"log"
	"net/mail"
)

func main() {
	const list = "Alice <alice@example.com>, Bob <bob@example.com>, Eve <eve@example.com>"
	emails, err := mail.ParseAddressList(list)
	if err != nil {
		log.Fatal(err)
	}

	for _, v := range emails {
		fmt.Println(v.Name, v.Address)
	}

}

func ParseDate（显示源文件）

func ParseDate(date string) (time.Time, error)

ParseDate 分析 RFC 5322 日期字符串。

type Address（显示源文件）

Address 代表一个单一的邮件地址。诸如“Barry Gibbs bg@example.com ”的地址表示为地址{名称：“Barry Gibbs”，地址：“bg@example.com”}。

type Address struct {
        Name    string // Proper name; may be empty.
        Address string // user@domain
}

func ParseAddress（显示源文件）

func ParseAddress(address string) (*Address, error)

Parses a single RFC 5322 address, e.g. "Barry Gibbs bg@example.com"

例

package main

import (
	"fmt"
	"log"
	"net/mail"
)

func main() {
	e, err := mail.ParseAddress("Alice <alice@example.com>")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(e.Name, e.Address)

}

func (*Address) String（显示源文件）

func (a *Address) String() string

字符串将地址格式化为有效的 RFC 5322 地址。如果地址名称包含非 ASCII 字符，则该名称将根据 RFC 2047 进行渲染。

type AddressParser（显示源文件）

AddressParser 是一个 RFC 5322 地址解析器。

type AddressParser struct {
        // WordDecoder optionally specifies a decoder for RFC 2047 encoded-words.
        WordDecoder *mime.WordDecoder
}

func (*AddressParser) Parse（显示源文件）

func (p *AddressParser) Parse(address string) (*Address, error)

Parse 解析“Gogh Fir gf@example.com ”或“foo@example.com” 形式的单个 RFC 5322 地址。

func (*AddressParser) ParseList（显示源文件）

func (p *AddressParser) ParseList(list string) ([]*Address, error)

ParseList 将给定的字符串解析为格式为“Gogh Fir gf@example.com ”或“foo@example.com” 的逗号分隔地址列表。

type Header（显示源文件）

Header 表示邮件消息标题中的键值对。

type Header map[string][]string

func (Header) AddressList（显示源文件）

func (h Header) AddressList(key string) ([]*Address, error)

AddressList 将指定的标题字段分析为地址列表。

func (Header) Date（显示源文件）

func (h Header) Date() (time.Time, error)

Date 分析 Date 标头字段。

func (Header) Get（显示源文件）

func (h Header) Get(key string) string

获取与给定键相关的第一个值。它不区分大小写; CanonicalMIMEHeaderKey 用于规范提供的密钥。如果没有与该键关联的值，Get 返回“”。要访问密钥的多个值或使用非规范密钥，请直接访问地图。

type Message（显示源文件）

Message 表示解析的邮件消息。

type Message struct {
        Header Header
        Body   io.Reader
}

func ReadMessage（显示源文件）

func ReadMessage(r io.Reader) (msg *Message, err error)

ReadMessage 从 r 读取消息。标题被解析，并且消息的主体将可用于从 msg.Body 中读取。

例

package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/mail"
	"strings"
)

func main() {
	msg := `Date: Mon, 23 Jun 2015 11:40:36 -0400
From: Gopher <from@example.com>
To: Another Gopher <to@example.com>
Subject: Gophers at Gophercon

Message body
`

	r := strings.NewReader(msg)
	m, err := mail.ReadMessage(r)
	if err != nil {
		log.Fatal(err)
	}

	header := m.Header
	fmt.Println("Date:", header.Get("Date"))
	fmt.Println("From:", header.Get("From"))
	fmt.Println("To:", header.Get("To"))
	fmt.Println("Subject:", header.Get("Subject"))

	body, err := ioutil.ReadAll(m.Body)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%s", body)

}