| 1 | package protocol |
| 2 | |
| 3 | import ( |
| 4 | "net/http" |
| 5 | "strconv" |
| 6 | "strings" |
| 7 | ) |
| 8 | |
| 9 | // Compatibiliteit tussen BlueGit en bluegit-backup (gelijk aan |
| 10 | // internal/backup/compat.go in BlueGit). |
| 11 | // |
| 12 | // Elke kant heeft een protocolversie (wat hij zelf spreekt) en een |
| 13 | // minimumversie (de oudste versie van de andere kant die hij nog |
| 14 | // ondersteunt). Ze passen als elk de minimumversie van de ander haalt. Een |
| 15 | // kant die geen protocol meldt, spreekt protocol 1 (BlueGit vóór de |
| 16 | // protocolversie en bluegit-backup v0.1.0). |
| 17 | // |
| 18 | // Strings, zodat een test-build ze met -ldflags -X kan overschrijven; de |
| 19 | // integratietests zetten ze direct (de backup server draait in het |
| 20 | // testproces). |
| 21 | var ( |
| 22 | ProtocolVersion = "1" |
| 23 | MinBlueGitProtocol = "1" |
| 24 | ) |
| 25 | |
| 26 | // Koppen met de protocolversie. |
| 27 | const ( |
| 28 | HeaderBlueGitProtocol = "X-BlueGit-Protocol" |
| 29 | HeaderBlueGitMinProtocol = "X-BlueGit-Min-Protocol" |
| 30 | HeaderBlueGitVersion = "X-BlueGit-Version" |
| 31 | HeaderBackupProtocol = "X-Backup-Protocol" |
| 32 | HeaderBackupMinProtocol = "X-Backup-Min-Protocol" |
| 33 | HeaderBackupVersion = "X-Backup-Version" |
| 34 | ) |
| 35 | |
| 36 | // Uitkomsten van Compat. |
| 37 | const ( |
| 38 | CompatOK = "ok" |
| 39 | CompatBlueGitTooOld = "bluegit_too_old" |
| 40 | CompatBackupTooOld = "backup_too_old" |
| 41 | ) |
| 42 | |
| 43 | func atoiMin1(s string) int { |
| 44 | n, err := strconv.Atoi(strings.TrimSpace(s)) |
| 45 | if err != nil || n < 1 { |
| 46 | return 1 |
| 47 | } |
| 48 | return n |
| 49 | } |
| 50 | |
| 51 | // Protocol is de protocolversie van deze backup server. |
| 52 | func Protocol() int { return atoiMin1(ProtocolVersion) } |
| 53 | |
| 54 | // MinProtocol is de oudste protocolversie van BlueGit die deze backup |
| 55 | // server ondersteunt. |
| 56 | func MinProtocol() int { |
| 57 | if m := atoiMin1(MinBlueGitProtocol); m <= Protocol() { |
| 58 | return m |
| 59 | } |
| 60 | return Protocol() |
| 61 | } |
| 62 | |
| 63 | // Compat vergelijkt BlueGit (protocol, minimum voor de backup server) met |
| 64 | // een backup server (protocol, minimum voor BlueGit). |
| 65 | func Compat(bluegit, bluegitMin, backup, backupMin int) string { |
| 66 | switch { |
| 67 | case backup < bluegitMin: |
| 68 | return CompatBackupTooOld |
| 69 | case bluegit < backupMin: |
| 70 | return CompatBlueGitTooOld |
| 71 | } |
| 72 | return CompatOK |
| 73 | } |
| 74 | |
| 75 | // Peer is wat BlueGit over zijn protocol zegt. |
| 76 | type Peer struct { |
| 77 | Protocol int `json:"protocol"` |
| 78 | MinProtocol int `json:"min_protocol"` |
| 79 | Version string `json:"version,omitempty"` |
| 80 | } |
| 81 | |
| 82 | // Compat beoordeelt deze backup server tegen BlueGit p. |
| 83 | func (p Peer) Compat() string { |
| 84 | return Compat(atoiMin1(strconv.Itoa(p.Protocol)), atoiMin1(strconv.Itoa(p.MinProtocol)), Protocol(), MinProtocol()) |
| 85 | } |
| 86 | |
| 87 | // BlueGitFromHeader leest de X-BlueGit-koppen. ok is false zonder |
| 88 | // protocolkop; p is dan protocol 1. |
| 89 | func BlueGitFromHeader(h http.Header) (Peer, bool) { |
| 90 | p := Peer{Protocol: 1, MinProtocol: 1} |
| 91 | raw := h.Get(HeaderBlueGitProtocol) |
| 92 | if raw == "" { |
| 93 | return p, false |
| 94 | } |
| 95 | p.Protocol = atoiMin1(raw) |
| 96 | if m := h.Get(HeaderBlueGitMinProtocol); m != "" { |
| 97 | p.MinProtocol = atoiMin1(m) |
| 98 | } |
| 99 | p.Version = cleanVersion(h.Get(HeaderBlueGitVersion)) |
| 100 | return p, true |
| 101 | } |
| 102 | |
| 103 | func cleanVersion(v string) string { |
| 104 | out := make([]rune, 0, len(v)) |
| 105 | for _, r := range strings.TrimSpace(v) { |
| 106 | if r > ' ' && r < 0x7f && r != '<' && r != '>' && r != '"' { |
| 107 | out = append(out, r) |
| 108 | } |
| 109 | if len(out) == 40 { |
| 110 | break |
| 111 | } |
| 112 | } |
| 113 | return string(out) |
| 114 | } |
| 115 | |
| 116 | // SetOwnHeaders zet de X-Backup-koppen. |
| 117 | func SetOwnHeaders(h http.Header, version string) { |
| 118 | h.Set(HeaderBackupProtocol, strconv.Itoa(Protocol())) |
| 119 | h.Set(HeaderBackupMinProtocol, strconv.Itoa(MinProtocol())) |
| 120 | h.Set(HeaderBackupVersion, version) |
| 121 | } |