a package for decode form's values into struct in Go
The only requirement is Go 1.2 or later.
You can see the performance in formam-benchmark compared with ajg/form, gorilla/schema and built-in/json.
The supported field types in the destination struct are:
stringboolint,int8,int16,int32,int64uint,uint8,uint16,uint32,uint64float32,float64slice,arraystructandstruct anonymousmapinterface{}time.Timeurl.URLcustom typesto one of the above types- a
pointerto one of the above types
NOTE: the nesting in maps, structs and slices can be ad infinitum.
Is possible unmarshaling data by the encoding.TextUnmarshaler interface
- Use symbol
.for access a field/key of a structure or map. (i.e,struct.key) - Use
[int_here]for access to index of a slice/array. (i.e,struct.array[0])
<form method="POST">
<input type="text" name="Name" value="Sony"/>
<input type="text" name="Location.Country" value="Japan"/>
<input type="text" name="Location.City" value="Tokyo"/>
<input type="text" name="Products[0].Name" value="Playstation 4"/>
<input type="text" name="Products[0].Type" value="Video games"/>
<input type="text" name="Products[1].Name" value="TV Bravia 32"/>
<input type="text" name="Products[1].Type" value="TVs"/>
<input type="text" name="Founders[0]" value="Masaru Ibuka"/>
<input type="text" name="Founders[0]" value="Akio Morita"/>
<input type="text" name="Employees" value="90000"/>
<input type="text" name="public" value="true"/>
<input type="url" name="website" value="http://www.sony.net"/>
<input type="date" name="foundation" value="1946-05-07"/>
<input type="submit"/>
</form>You can use the tag formam if the name of a input of form starts lowercase.
type Company struct {
Public bool `formam:"public"`
Website url.URL `formam:"website"`
Foundation time.Time `formam:"foundation"`
Name string
Location struct {
Country string
City string
}
Products []struct {
Name string
Type string
}
Founders []string
Employees int64
}
func MyHandler(w http.ResponseWriter, r *http.Request) error {
co := new(Company)
r.ParseForm()
if err := formam.Decode(r.Form, co); err != nil {
return err
}
return nil
}