Add Access to Field Name from FieldLevel (#284)

Author: Dean Karn

README.md

@@ -1,7 +1,7 @@
 Package validator
 ================
 <img align="right" src="https://raw.githubusercontent.com/go-playground/validator/v9/logo.png">[![Join the chat at https://gitter.im/go-playground/validator](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/go-playground/validator?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-![Project status](https://img.shields.io/badge/version-9.3.6-green.svg)
+![Project status](https://img.shields.io/badge/version-9.4.0-green.svg)
 [![Build Status](https://semaphoreci.com/api/v1/joeybloggs/validator/branches/v9/badge.svg)](https://semaphoreci.com/joeybloggs/validator)
 [![Coverage Status](https://coveralls.io/repos/go-playground/validator/badge.svg?branch=v9&service=github)](https://coveralls.io/github/go-playground/validator?branch=v9)
 [![Go Report Card](https://goreportcard.com/badge/github.com/go-playground/validator)](https://goreportcard.com/report/github.com/go-playground/validator)
@@ -19,7 +19,7 @@ It has the following **unique** features:
 -   Alias validation tags, which allows for mapping of several validations to a single tag for easier defining of validations on structs
 -   Extraction of custom defined Field Name e.g. can specify to extract the JSON name while validating and have it available in the resulting FieldError
 -   Customizable i18n aware error messages.
--   Default validator for the [gin](https://github.com/gin-gonic/gin) web framework; upgrading from v8 to v9 in gin see [here](https://github.com/go-playground/validator/tree/v9/examples/gin-upgrading-overriding)
+-   Default validator for the [gin](https://github.com/gin-gonic/gin) web framework; upgrading from v8 to v9 in gin see [here](https://github.com/go-playground/validator/tree/v9/_examples/gin-upgrading-overriding)
 
 Installation
 ------------
@@ -56,11 +56,11 @@ Please see http://godoc.org/gopkg.in/go-playground/validator.v9 for detailed usa
 
 ##### Examples:
 
-- [Simple](https://github.com/go-playground/validator/blob/v9/examples/simple/main.go)
-- [Custom Field Types](https://github.com/go-playground/validator/blob/v9/examples/custom/main.go)
-- [Struct Level](https://github.com/go-playground/validator/blob/v9/examples/struct-level/main.go)
-- [Translations & Custom Errors](https://github.com/go-playground/validator/blob/v9/examples/translations/main.go)
-- [Gin upgrade and/or override validator](https://github.com/go-playground/validator/tree/v9/examples/gin-upgrading-overriding)
+- [Simple](https://github.com/go-playground/validator/blob/v9/_examples/simple/main.go)
+- [Custom Field Types](https://github.com/go-playground/validator/blob/v9/_examples/custom/main.go)
+- [Struct Level](https://github.com/go-playground/validator/blob/v9/_examples/struct-level/main.go)
+- [Translations & Custom Errors](https://github.com/go-playground/validator/blob/v9/_examples/translations/main.go)
+- [Gin upgrade and/or override validator](https://github.com/go-playground/validator/tree/v9/_examples/gin-upgrading-overriding)
 - [wash - an example application putting it all together](https://github.com/bluesuncorp/wash)
 
 Benchmarks

examples/custom/main.go renamed to _examples/custom/main.go

@@ -5,7 +5,7 @@ based on tags.
 It can also handle Cross-Field and Cross-Struct validation for nested structs
 and has the ability to dive into arrays and maps of any type.
 
-see more examples https://github.com/go-playground/validator/tree/v9/examples
+see more examples https://github.com/go-playground/validator/tree/v9/_examples
 
 Validation Functions Return Type error
 

examples/gin-upgrading-overriding/main.go renamed to _examples/gin-upgrading-overriding/main.go

@@ -16,6 +16,13 @@ type FieldLevel interface {
 	// returns current field for validation
 	Field() reflect.Value
 
+	// returns the field's name with the tag
+	// name takeing precedence over the fields actual name.
+	FieldName() string
+
+	// returns the struct field's name
+	StructFieldName() string
+
 	// returns param for validation against current field
 	Param() string
 
@@ -40,12 +47,23 @@ func (v *validate) Field() reflect.Value {
 	return v.flField
 }
 
+// FieldName returns the field's name with the tag
+// name takeing precedence over the fields actual name.
+func (v *validate) FieldName() string {
+	return v.cf.altName
+}
+
+// StructFieldName returns the struct field's name
+func (v *validate) StructFieldName() string {
+	return v.cf.name
+}
+
 // Param returns param for validation against current field
 func (v *validate) Param() string {
-	return v.flParam
+	return v.ct.param
 }
 
 // GetStructFieldOK returns Param returns param for validation against current field
 func (v *validate) GetStructFieldOK() (reflect.Value, reflect.Kind, bool) {
-	return v.getStructFieldOKInternal(v.slflParent, v.flParam)
+	return v.getStructFieldOKInternal(v.slflParent, v.ct.param)
 }

examples/gin-upgrading-overriding/v8_to_v9.go renamed to _examples/gin-upgrading-overriding/v8_to_v9.go

@@ -23,8 +23,9 @@ type validate struct {
 	slflParent   reflect.Value
 	slCurrent    reflect.Value
 	flField      reflect.Value
-	flParam      string
 	fldIsPointer bool
+	cf           *cField
+	ct           *cTag
 
 	// misc reusable values
 	misc []byte
@@ -215,7 +216,8 @@ OUTER:
 			// set Field Level fields
 			v.slflParent = parent
 			v.flField = current
-			v.flParam = ""
+			v.cf = cf
+			v.ct = ct
 
 			if !v.fldIsPointer && !hasValue(v) {
 				return
@@ -309,7 +311,8 @@ OUTER:
 				// set Field Level fields
 				v.slflParent = parent
 				v.flField = current
-				v.flParam = ct.param
+				v.cf = cf
+				v.ct = ct
 
 				if ct.fn(v) {
 
@@ -397,7 +400,8 @@ OUTER:
 			// set Field Level fields
 			v.slflParent = parent
 			v.flField = current
-			v.flParam = ct.param
+			v.cf = cf
+			v.ct = ct
 
 			// // report error interface functions need these
 			// v.ns = ns