Changelog History
-
v0.3.3
February 15, 2017 -
v0.3.2 Changes
November 05, 2015🚀 This release merely fixes the version number in the README and godoc comment. There are no code changes.
-
v0.3.1 Changes
July 09, 2015🚀 This release introduces a new BindJSON method which unmarshals the entire request body to an arbitrary data structure. It is 100% backwards compatible.
-
v0.3.0 Changes
February 24, 2015📦 This version renames the package to "forms", which is more conventional.
There are no other code changes. -
v0.2 Changes
January 10, 2015📜 I added support for parsing and validating files in multipart requests!
📜 Here's how it works. When calling Parse(), if 1) the request has a Content-Type header which identifies it as a multipart request and 2) there is one or more files provided in the body of the request, go-data-parser will automatically parse the files and add a representation of them to the resulting Data object.
Here's an example of how to validate and read the contents of a file:
func CreateUserHandler(res http.ResponseWriter, req \*http.Request) { // Parse request data.userData, err := data.Parse(req) if err != nil { // Handle err// ... } // Validateval := userData.Validator() // RequireFile requires a non-empty file with the given key/field name val.RequireFile("profileImage") // AcceptFileExts allows you to specify which filetype extensions are allowed,// if any other extension was used, it generates a nice-looking error val.AcceptFileExts("profileImage", "jpg", "png", "gif") if val.HasErrors() { // Write the errors to the response// Maybe this means formatting the errors as json// or re-rendering the form with an error message// ... } // Get the contents of the profileImage fileimageBytes, err := userData.GetFileBytes("profileImage") if err != nil { // Handle err } // Now you can either copy the file over to your server using io.Copy,// upload the file to something like amazon S3, or do whatever you want// with it.}This release is not 100% backward compatible with previous releases, but it is close.
📜 In order to facilitate parsing and validating multipart form files, I needed to change the underlying data structure for the Data object. Previously, it was an alias for url.Values. Now, it is a struct containing url.Values and a map of string to *multipart.FileHeader. This will only cause problems if you were accessing Data as a url.Values directly. If you are only using the Get, Add, and Delete family of methods, then nothing has changed.
-
v0.1
December 27, 2014