İçeriğe geç
Gin Web Framework

Form alanları için varsayılan değerleri bağlama

Bazen istemci bir değer göndermediğinde bir alanın varsayılan bir değere geri dönmesini istersiniz. Gin’in form bağlama özelliği, form struct etiketindeki default seçeneği aracılığıyla varsayılan değerleri destekler. Bu, skaler değerler için çalışır ve Gin v1.11’den itibaren açık koleksiyon formatlarına sahip koleksiyonlar (slice/array) için de geçerlidir.

Önemli noktalar:

  • Varsayılan değeri form anahtarının hemen arkasına koyun: form:"name,default=William".
  • Koleksiyonlar için, collection_format:"multi|csv|ssv|tsv|pipes" ile değerlerin nasıl bölüneceğini belirtin.
  • multi ve csv için, varsayılan değerde değerleri ayırmak için noktalı virgül kullanın (örneğin, default=1;2;3). Gin bunları dahili olarak virgüle dönüştürür, böylece etiket ayrıştırıcısı belirsiz olmaz.
  • ssv (boşluk), tsv (sekme) ve pipes (|) için varsayılan değerde doğal ayırıcıyı kullanın.

Örnek:

package main


import (
  "net/http"


  "github.com/gin-gonic/gin"
)


type Person struct {
  Name      string    `form:"name,default=William"`
  Age       int       `form:"age,default=10"`
  Friends   []string  `form:"friends,default=Will;Bill"`                     // multi/csv: varsayılanlarda ; kullanın
  Addresses [2]string `form:"addresses,default=foo bar" collection_format:"ssv"`
  LapTimes  []int     `form:"lap_times,default=1;2;3" collection_format:"csv"`
}


func main() {
  r := gin.Default()
  r.POST("/person", func(c *gin.Context) {
    var req Person
    if err := c.ShouldBind(&req); err != nil { // Content-Type'dan binder çıkarır
      c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
      return
    }
    c.JSON(http.StatusOK, req)
  })
  _ = r.Run(":8080")
}

Gövde olmadan POST yaparsanız, Gin varsayılan değerlerle yanıt verir:

Terminal window
curl -X POST http://localhost:8080/person

Yanıt (örnek):

{
  "Name": "William",
  "Age": 10,
  "Friends": ["Will", "Bill"],
  "Addresses": ["foo", "bar"],
  "LapTimes": [1, 2, 3]
}

Notlar ve uyarılar:

  • Virgüller, Go struct etiket sözdiziminde seçenekleri ayırmak için kullanılır; varsayılan değerler içinde virgül kullanmaktan kaçının.
  • multi ve csv için noktalı virgül varsayılan değerleri ayırır; bu formatlar için ayrı varsayılan değerler içinde noktalı virgül kullanmayın.
  • Geçersiz collection_format değerleri bağlama hatasına neden olur.

İlgili değişiklikler:

  • Form bağlama için koleksiyon formatları (multi, csv, ssv, tsv, pipes) v1.11 civarında geliştirildi.
  • Koleksiyonlar için varsayılan değerler v1.11’de eklendi (PR #4048).