1. Tuotteet
  2.   Sähköposti
  3.   GO
  4.   go-message

go-message

 
 

Avoimen lähdekoodin Go-kirjasto sähköpostiin ja Internet-viestimuotoon

Jäsennä, luo ja käsittele RFC 5322-, MIME- ja Content-Disposition-otsakkeita suoratoisto Go-API:n avulla.

Mikä on go-message?

go-message on korkean suorituskyvyn, suoratoistava Go-kirjasto, joka on suunniteltu sähköpostiviestien jäsentämiseen ja luomiseen Internet Message Format -standardin (RFC 5322), MIME-laajennusten (RFC 2045–2047) ja Content-Disposition -otsikoiden (RFC 2183) mukaisesti. Se mahdollistaa Go-kehittäjien käsitellä sähköpostisisältöä tehokkaasti lataamatta koko viestejä muistiin, mikä tekee siitä ihanteellisen skaalautuville postipalvelimille ja -asiakkaille. Kirjasto tukee automaattista merkistöjen dekoodausta ja integroituu saumattomasti Go:n vakionaikakirjastoon.

Rakennettu modulaarisuuden ja laajennettavuuden ajatuksella, go-message sisältää omistettuja alipaketteja kuten `mail` korkean tason sähköpostien käsittelyyn ja `textproto` alhaisen tason protokollajäsennykseen. Sen DKIM-ystävällinen suunnittelu takaa yhteensopivuuden nykyaikaisten sähköpostin todennustyönkulkujen kanssa. Sisäänrakennettujen suoratoistomahdollisuuksien ja merkistöjen normalisoinnin avulla go-message yksinkertaistaa monimutkaisia sähköpostinkäsittelytehtäviä, kuten multipart-runkojen jäsentämistä, koodattujen otsikoiden dekoodausta ja sisäkkäisten MIME-rakenteiden käsittelyä — kaikki samalla säilyttäen muistin tehokkuuden ja suorituskyvyn.

Previous Next

Aloittaminen go-message:n kanssa

Aloittaaksesi go-messagen käytön, asenna se `go get` -komennolla virallisesta [go-message GitHub](https://github.com/emersion/go-message) -varastosta. Suositeltu tapa on käyttää Go-moduuleja: suorita `go get github.com/emersion/go-message` projektikansiossasi. Merkistön purku-tukea varten, sisällytä `import _ \"github.com/emersion/go-message/charset\"` ottaaksesi käyttöön kaikki standardikoodaukset. Kirjasto on kevyt, riippumaton ja integroituu sujuvasti olemassa oleviin Go-sovelluksiin.

Asenna go-message Go-moduulien kautta

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

Sähköpostin jäsentäminen suoratoistona

go-message tarjoaa suoratoistoparseerin, joka käsittelee sähköpostiviestejä inkrementaalisesti lataamatta koko sisältöä muistiin. Tämä on erityisen hyödyllistä suurten sähköpostien tai suurta määrää käsittelevän postinkäsittelyn yhteydessä. Parseeri lukee otsikot ja rungon osat peräkkäin, mikä mahdollistaa kehittäjien tarkastella tai välittää viestejä reaaliajassa. Se tukee sekä RFC-yhteensopivia että virheellisiä viestejä sulavasti, mikä tekee siitä sopivan tuotantopostipalvelimille. Hyödyntämällä Go:n `io.Reader`-rajapintaa kirjasto integroidaan luonnollisesti verkko- ja tiedosto‑I/O‑toimintoihin.

Kuinka jäsentää sähköpostiviesti suoratoisto-API:n avulla?

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-multipart-käsittely

go-message tukee täysin MIME-multipart-viestien jäsentämistä ja luomista RFC 2045:n ja RFC 2046:n määrittelemänä. Kehittäjät voivat navigoida monimutkaisissa multipart-rakenteissa—mukaan lukien sisäkkäiset osat—käyttäen intuitiivisia API-rajapintoja. Kirjasto dekoodaa automaattisesti siirtoenkoodaukset (esim. base64, quoted-printable) ja tarjoaa pääsyn yksittäisiin osiin `Part`-rajapinnan kautta. Tämä mahdollistaa vankat sähköpostiviestien koostamisen sekä liitteiden, HTML/tekstivaihtoehtojen ja upotettujen resurssien poiminnan. Sen suoratoistorakenne takaa tehokkaan käsittelyn myös suurille multipart-viesteille, joissa on paljon osia.

Kuinka poimia multipart-osat sähköpostista?

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
}

Merkistö- ja koodaus tuki

go-message sisältää vankkaa automaattista merkistö- ja koodauskäsittelyä sähköpostin otsikoille ja sisällölle. Se tukee RFC 2047 -koodattujen otsikoiden (esim. `=?utf-8?B?...?=`) ja rungon tekstin purkamista eri merkistöissä (UTF-8, ISO-8859, jne.). Tuomalla valinnaisen `github.com/emersion/go-message/charset`-paketin, kehittäjät saavat pääsyn kaikkiin rekisteröityihin IANA-merkistöihin `golang.org/x/text/encoding`-kirjaston kautta. Tämä varmistaa kansainvälisen sähköpostisisällön tarkan esittämisen, mukaan lukien ei-latinakirjaimet ja erikoismerkit, ilman manuaalista merkistön tunnistamista tai muunnosta.

Kuinka purkaa merkistökoodattu otsikko?

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-ystävällinen viestin allekirjoitus

go-message on suunniteltu DKIM-ystävälliseksi, mahdollistaen saumattoman integroinnin kryptografisiin allekirjoitus- ja tarkistusprosesseihin. Sen suoratoistoparseeri säilyttää viestin rakenteen eheyden, jolloin allekirjoittajat voivat allekirjoittaa vain kanonisoidun rungon ja valitut otsikot ilman uudelleenkoodausta. Kirjasto välttää tarpeettomia muunnoksia (esim. rivinvaihdon normalisointi), jotka voisivat rikkoa DKIM-allekirjoituksia. Kehittäjät voivat rakentaa sähköpostin allekirjoitusputkia yhdistämällä go-messagein kirjastoihin kuten `github.com/emersion/go-dkim`, varmistaen RFC 6376:n mukaisuuden verkkotunnuspohjaiseen viestin todennukseen.

Kuinka valmistaa viesti DKIM-allekirjoitusta varten?

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
}
 Suomen