Πώς κωδικοποιείς/αποκωδικοποιείς JSON στη Go;

Question

Accepted Answer

Το πακέτο **`encoding/json`** της standard library της Go χειρίζεται την σειριοποίηση JSON (marshaling) και αποσειριοποίηση (unmarshaling), αντιστοιχίζοντας μεταξύ Go structs και JSON. **Οι struct tags** ελέγχουν την ονοματολογία των πεδίων, και είναι η βάση της πλειοψηφίας των Go web APIs.

## Marshaling: Go struct → JSON

```go
type User struct {
    Name    string `json:"name"`              // tag maps the field to a JSON key
    Email   string `json:"email"`
    Age     int    `json:"age,omitempty"`     // omitempty → skip if zero/empty
    private string                             // unexported → NOT serialized (lowercase)
}

u := User{Name: "Ann", Email: "ann@x.com", Age: 30}
data, err := json.Marshal(u)
fmt.Println(string(data))   // {"name":"Ann","email":"ann@x.com","age":30}
```

Το `json.Marshal` μετατρέπει ένα struct σε JSON bytes. **Μόνο τα exported (κεφαλαία) πεδία σειριοποιούνται** — τα unexported πεδία παραλείπονται.

## Ο ρόλος των struct tags

```go
type Product struct {
    ID    int    `json:"id"`                  // → "id"
    Name  string `json:"product_name"`        // → "product_name" (rename)
    Price float64 `json:"price,omitempty"`     // omit if 0
    Notes string `json:"-"`                    // "-" → NEVER serialize this field
}
```

Χωρίς tags, οι JSON κλειδιά προεπιλέγονται στο ακριβές (κεφαλαίο) όνομα πεδίου. Τα tags σας επιτρέπουν να ελέγχετε το όνομα του JSON κλειδιού, να παραλείπετε κενές τιμές (`omitempty`), και να αποκλείετε πεδία ολόκληρα (`-`) — ουσιαστικά για να ταιριάζετε σε συμβάσεις API (π.χ. snake_case JSON).

## Unmarshaling: JSON → Go struct

```go
jsonData := []byte(`{"name":"Bob","email":"bob@x.com","age":25}`)

var user User
err := json.Unmarshal(jsonData, &user)   // pass a POINTER to populate it
if err != nil { log.Fatal(err) }
fmt.Println(user.Name)   // "Bob"
```

Το `json.Unmarshal` αναλύει JSON σε ένα struct — πρέπει να περάσετε έναν **pointer** ώστε να μπορέσει να συμπληρώσει το struct. Τα πεδία αντιστοιχίζονται κατά tag/όνομα (ανεξάρτητα από κεφαλαία).

## Δουλεύοντας με άγνωστο/δυναμικό JSON

```go
// when the structure is unknown, unmarshal into a map or interface{}
var result map[string]interface{}
json.Unmarshal(data, &result)
name := result["name"].(string)        // type-assert the value (JSON numbers → float64!)
```

## Streaming με Encoder/Decoder (για I/O)

```go
// encode directly to an io.Writer (e.g. an HTTP response) — efficient, no intermediate buffer
json.NewEncoder(w).Encode(user)

// decode directly from an io.Reader (e.g. an HTTP request body)
json.NewDecoder(r.Body).Decode(&user)
```

Για web servers, ο `Encoder`/`Decoder` δουλεύουν απευθείας με streams (request/response bodies) — το συνηθισμένο pattern σε handlers.

## Γιατί σημαίνει

Η κωδικοποίηση/αποκωδικοποίηση JSON είναι θεμελιώδης για σχεδόν όλη την ανάπτυξη Go web — REST APIs, microservices, και configuration εξαρτώνται όλα από τη μετατροπή μεταξύ Go structs και JSON.

Το πακέτο `encoding/json` (standard library, χωρίς dependency) είναι το standard εργαλείο, και η κατανόησή του είναι ουσιαστική καθημερινή γνώση: πώς λειτουργούν marshaling/unmarshaling, ο κρίσιμος κανόνας ότι **μόνο τα exported πεδία σειριοποιούνται**, και ειδικά **struct tags** (ελέγχοντας τα JSON key names με `json:"..."`, `omitempty` για να παραλείψετε κενές τιμές, `-` για να αποκλείσετε) που χρειάζονται για να ταιριάζετε σε πραγματικές συμβάσεις API όπως snake_case.

Το να ξέρετε να περνάτε ένα pointer στο `Unmarshal`, να χειρίζεστε δυναμικό JSON μέσω maps/`interface{}` (με την παγίδα ότι τα JSON numbers αποκωδικοποιούνται σε `float64`), και να χρησιμοποιείτε streaming `Encoder`/`Decoder` για HTTP bodies καλύπτει τις πρακτικές ανάγκες της δημιουργίας APIs.

Είναι ένα σταθερό, πρακτικό μέρος του Go backend work.