1. Termékek
  2.   Email
  3.   GO
  4.   go-message

go-message

 
 

Nyílt forráskódú Go könyvtár e-mailhez és Internet Message Formátumhoz

Elemzés, generálás és kezelés RFC 5322, MIME és Content-Disposition fejlécekhez streaming Go API-val.

Mi az a go-message?

A go-message egy nagy teljesítményű, streaming Go könyvtár, amely e‑mail üzenetek elemzésére és előállítására lett tervezve, megfelelve az Internet Message Format (RFC 5322), a MIME kiterjesztések (RFC 2045–2047) és a Content‑Disposition fejlécek (RFC 2183) szabványainak. Lehetővé teszi a Go fejlesztők számára, hogy hatékonyan dolgozzanak e‑mail tartalommal anélkül, hogy az egész üzeneteket a memóriába töltenék, így ideális skálázható levelezőszerverek és kliensek számára. A könyvtár automatikus karakterkészlet‑dekódolást támogat, és zökkenőmentesen integrálódik a Go szabványos könyvtárával.

A modularitásra és bővíthetőségre építve a go-message dedikált alcsomagokat tartalmaz, például a `mail`‑t a magas szintű levelezéskezeléshez és a `textproto`‑t az alacsony szintű protokoll‑elemzéshez. DKIM‑barát tervezése biztosítja a kompatibilitást a modern e‑mail hitelesítési munkafolyamatokkal. A beépített streaming képességek és a karakterkészlet normalizálás révén a go-message leegyszerűsíti a bonyolult e‑mail feldolgozási feladatokat, mint a multipart testek elemzése, a kódolt fejlécek dekódolása és a beágyazott MIME struktúrák kezelése – mindezt a memóriahatékonyság és a teljesítmény megőrzése mellett.

Previous Next

Első lépések a go-message használatához

A go-message használatának megkezdéséhez telepítsd a hivatalos [go-message GitHub](https://github.com/emersion/go-message) tárolóból a `go get` paranccsal. Ajánlott megközelítés a Go modulok használata: futtasd a `go get github.com/emersion/go-message` parancsot a projekt könyvtárában. A karakterkészlet dekódolás támogatásához add hozzá a `import _ "github.com/emersion/go-message/charset"` sort, hogy engedélyezd az összes szabványos kódolást. A könyvtár könnyű, függőségmentes, és zökkenőmentesen integrálódik a meglévő Go alkalmazásokba.

A go-message telepítése Go modulok segítségével

go get github.com/emersion/go-message
# Optional: enable full charset support
import _ "github.com/emersion/go-message/charset"

E-mail streaming elemzése

A go-message egy streaming elemzőt biztosít, amely fokozatosan dolgozza fel az e‑mail üzeneteket anélkül, hogy a teljes tartalmat memóriába töltené. Ez különösen előnyös nagy e‑mailek vagy nagy mennyiségű levélfeldolgozás esetén. Az elemző sorban olvassa a fejléceket és a törzsrészeket, lehetővé téve a fejlesztők számára, hogy valós időben ellenőrizzék vagy továbbítsák az üzeneteket. Támogatja mind az RFC‑nek megfelelő, mind a hibásan formázott üzeneteket, így alkalmas termelési levelezőszerverekre. A Go `io.Reader`‑ének kihasználásával a könyvtár természetesen integrálódik a hálózati és fájl I/O műveletekkel.

Hogyan elemezzünk egy e-mail üzenetet streaming API-n keresztül?

import (
	"bytes"
	"github.com/emersion/go-message"
)

func parseEmail(data []byte) error {
	r := bytes.NewReader(data)
	m, err := message.Read(r)
	if err != nil {
		return err
	}
	// Access headers and body parts
	return nil
}

MIME többréses kezelés

A go-message teljes mértékben támogatja a MIME multipart üzenetek elemzését és előállítását, ahogyan azt az RFC 2045 és RFC 2046 definiálja. A fejlesztők intuitív API‑k segítségével navigálhatnak a komplex multipart struktúrákban – beleértve a beágyazott részeket is. A könyvtár automatikusan dekódolja az átvitel kódolásait (pl. base64, quoted-printable), és a `Part` interfészen keresztül hozzáférést biztosít az egyes részekhez. Ez lehetővé teszi a robusztus e‑mail összeállítást és a mellékletek, HTML/szöveg alternatívák, valamint a beágyazott erőforrások kinyerését. Streaming jellege biztosítja a hatékony kezelést még nagy, sok részes multipart üzenetek esetén is.

Hogyan lehet kinyerni a multipart részeket egy e‑mailből?

import (
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func extractParts(m *message.Message) error {
	if m.Multipart() {
		for _, p := range m.Parts() {
			// Process each part (e.g., text, attachment)
			mediaType, params, _ := p.Header.MediaType()
			if mediaType == "text/plain" {
				// Read plain text content
				content, _ := io.ReadAll(p.Body)
			}
		}
	}
	return nil
}

Karakterkészlet- és kódolástámogatás

A go-message robusztus automatikus karakterkészlet- és kódoláskezelést biztosít az e‑mail fejlécekhez és a törzstartalomhoz. Támogatja az RFC 2047‑kódolt fejlécek (például `=?utf-8?B?...?=`) dekódolását, valamint a törzsszöveg különböző karakterkészletekben (UTF‑8, ISO‑8859, stb.) való kezelését. Az opcionális `github.com/emersion/go-message/charset` csomag importálásával a fejlesztők hozzáférhetnek az összes regisztrált IANA karakterkészlethez a `golang.org/x/text/encoding` segítségével. Ez biztosítja a nemzetközi e‑mail tartalom pontos megjelenítését, beleértve a nem latin írásrendszereket és speciális szimbólumokat, manuális karakterkészlet‑felismerés vagy konverzió nélkül.

Hogyan lehet dekódolni egy karakterkészlet‑kódolt fejlécet?

import (
	"github.com/emersion/go-message"
	_ "github.com/emersion/go-message/charset" // Enable all charsets
)

func decodeSubject(m *message.Message) (string, error) {
	subject, err := m.Header.Get("Subject")
	if err != nil {
		return "", err
	}
	// Automatically decoded using registered charsets
	return subject, nil
}

DKIM-barát üzenet aláírás

A go-message úgy lett tervezve, hogy DKIM-barát legyen, lehetővé téve a kriptográfiai aláírási és ellenőrzési munkafolyamatok zökkenőmentes integrációját. A streaming parser megőrzi az üzenet szerkezeti integritását, így az aláírók csak a kanonikalizált törzset és a kiválasztott fejléceket írhatják alá újrakódolás nélkül. A könyvtár elkerüli a felesleges átalakításokat (például a sorvégek normalizálását), amelyek megtörhetnék a DKIM-aláírásokat. A fejlesztők e‑mail aláírási csővezetékeket építhetnek a go-message-et olyan könyvtárakkal kombinálva, mint a `github.com/emersion/go-dkim`, biztosítva az RFC 6376 szerinti domain‑alapú üzenet‑hitelesítésnek való megfelelést.

Hogyan lehet előkészíteni egy üzenetet a DKIM aláíráshoz?

import (
	"bytes"
	"github.com/emersion/go-message"
	"github.com/emersion/go-message/textproto"
)

func prepareForDKIM(m *message.Message) (*bytes.Buffer, error) {
	var buf bytes.Buffer
	// Write canonicalized headers and body
	h := m.Header
	h.WriteTo(&buf)
	buf.WriteString("\r\n")
	if _, err := io.Copy(&buf, m.Body); err != nil {
		return nil, err
	}
	return &buf, nil
}
 Magyar