net/mail
Package 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
包文件
变量
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)
}
