session examples: add the 'AllowReclaim: true' session.Config field to true, help users like https://github.com/kataras/iris/issues/1031\#issuecomment-399894693

Former-commit-id: 2ab7e56a4fda380fb52a8912a328797ba332f2c8

_examples/sessions/README.md

@@ -62,7 +62,7 @@ import (
 
 var (
     cookieNameForSessionID = "mycookiesessionnameid"
-    sess                   = sessions.New(sessions.Config{Cookie: cookieNameForSessionID})
+    sess                   = sessions.New(sessions.Config{Cookie: cookieNameForSessionID, AllowReclaim: true})
 )
 
 func secret(ctx iris.Context) {

_examples/sessions/database/badger/main.go

@@ -25,6 +25,7 @@ func main() {
 	sess := sessions.New(sessions.Config{
 		Cookie:       "sessionscookieid",
 		Expires:      45 * time.Minute, // <=0 means unlimited life. Defaults to 0.
+		AllowReclaim: true,
 	})
 
 	//

_examples/sessions/database/boltdb/main.go

@@ -26,6 +26,7 @@ func main() {
 	sess := sessions.New(sessions.Config{
 		Cookie:       "sessionscookieid",
 		Expires:      45 * time.Minute, // <=0 means unlimited life. Defaults to 0.
+		AllowReclaim: true,
 	})
 
 	//

_examples/sessions/database/redis/main.go

@@ -33,7 +33,9 @@ func main() {
 
 	sess := sessions.New(sessions.Config{
 		Cookie:       "sessionscookieid",
-		Expires: 45 * time.Minute}, // <=0 means unlimited life. Defaults to 0.
+		Expires:      45 * time.Minute, // <=0 means unlimited life. Defaults to 0.
+		AllowReclaim: true,
+	},
 	)
 
 	//

_examples/sessions/flash-messages/main.go

@@ -8,7 +8,7 @@ import (
 
 func main() {
 	app := iris.New()
-	sess := sessions.New(sessions.Config{Cookie: "myappsessionid"})
+	sess := sessions.New(sessions.Config{Cookie: "myappsessionid", AllowReclaim: true})
 
 	app.Get("/set", func(ctx iris.Context) {
 		s := sess.Start(ctx)

_examples/sessions/overview/main.go

@@ -8,7 +8,7 @@ import (
 
 var (
 	cookieNameForSessionID = "mycookiesessionnameid"
-	sess                   = sessions.New(sessions.Config{Cookie: cookieNameForSessionID})
+	sess                   = sessions.New(sessions.Config{Cookie: cookieNameForSessionID, AllowReclaim: true})
 )
 
 func secret(ctx iris.Context) {

_examples/sessions/securecookie/main.go

@@ -27,6 +27,7 @@ func newApp() *iris.Application {
 		Cookie:       cookieName,
 		Encode:       secureCookie.Encode,
 		Decode:       secureCookie.Decode,
+		AllowReclaim: true,
 	})
 
 	app.Get("/", func(ctx iris.Context) {

_examples/sessions/standalone/main.go

@@ -27,6 +27,13 @@ func main() {
 		// of the same host, then enable it.
 		// Defaults to false.
 		DisableSubdomainPersistence: true,
+		// AllowReclaim will allow to
+		// Destroy and Start a session in the same request handler.
+		// All it does is that it removes the cookie for both `Request` and `ResponseWriter` while `Destroy`
+		// or add a new cookie to `Request` while `Start`.
+		//
+		// Defaults to false.
+		AllowReclaim: true,
 	})
 
 	app.Get("/", func(ctx iris.Context) {