extra docs

Author: pmlopes

web-examples/src/main/groovy/io/vertx/example/web/oauth2/server.groovy

@@ -39,7 +39,7 @@ router.get("/").handler({ ctx ->
 // The protected resource
 router.get("/protected").handler({ ctx ->
   def user = ctx.user()
-
+  // retrieve the user profile, this is a common feature but not from the official OAuth2 spec
   user.userInfo({ res ->
     if (res.failed()) {
       // request didn't succeed because the token was revoked so we
@@ -52,6 +52,9 @@ router.get("/protected").handler({ ctx ->
       def userInfo = res.result()
 
       // fetch the user emails from the github API
+
+      // the fetch method will retrieve any resource and ensure the right
+      // secure headers are passed.
       user.fetch("https://api.github.com/user/emails", { res2 ->
         if (res2.failed()) {
           // request didn't succeed because the token was revoked so we

web-examples/src/main/java/io/vertx/example/web/oauth2/Server.java

@@ -69,7 +69,7 @@ public void start() throws Exception {
     // The protected resource
     router.get("/protected").handler(ctx -> {
       AccessToken user = (AccessToken) ctx.user();
-
+      // retrieve the user profile, this is a common feature but not from the official OAuth2 spec
       user.userInfo(res -> {
         if (res.failed()) {
           // request didn't succeed because the token was revoked so we
@@ -82,6 +82,9 @@ public void start() throws Exception {
           final JsonObject userInfo = res.result();
 
           // fetch the user emails from the github API
+
+          // the fetch method will retrieve any resource and ensure the right
+          // secure headers are passed.
           user.fetch("https://api.github.com/user/emails", res2 -> {
             if (res2.failed()) {
               // request didn't succeed because the token was revoked so we

web-examples/src/main/js/io/vertx/example/web/oauth2/server.js

@@ -38,7 +38,7 @@ router.get("/").handler(function (ctx) {
 // The protected resource
 router.get("/protected").handler(function (ctx) {
   var user = ctx.user();
-
+  // retrieve the user profile, this is a common feature but not from the official OAuth2 spec
   user.userInfo(function (res, res_err) {
     if (res_err != null) {
       // request didn't succeed because the token was revoked so we
@@ -51,6 +51,9 @@ router.get("/protected").handler(function (ctx) {
       var userInfo = res;
 
       // fetch the user emails from the github API
+
+      // the fetch method will retrieve any resource and ensure the right
+      // secure headers are passed.
       user.fetch("https://api.github.com/user/emails", function (res2, res2_err) {
         if (res2_err != null) {
           // request didn't succeed because the token was revoked so we

web-examples/src/main/kotlin/io/vertx/example/web/oauth2/Server.kt

@@ -43,7 +43,7 @@ class Server : io.vertx.core.AbstractVerticle()  {
     // The protected resource
     router.get("/protected").handler({ ctx ->
       var user = ctx.user()
-
+      // retrieve the user profile, this is a common feature but not from the official OAuth2 spec
       user.userInfo({ res ->
         if (res.failed()) {
           // request didn't succeed because the token was revoked so we
@@ -56,6 +56,9 @@ class Server : io.vertx.core.AbstractVerticle()  {
           var userInfo = res.result()
 
           // fetch the user emails from the github API
+
+          // the fetch method will retrieve any resource and ensure the right
+          // secure headers are passed.
           user.fetch("https://api.github.com/user/emails", { res2 ->
             if (res2.failed()) {
               // request didn't succeed because the token was revoked so we

web-examples/src/main/ruby/io/vertx/example/web/oauth2/server.rb

@@ -38,7 +38,7 @@
 # The protected resource
 router.get("/protected").handler() { |ctx|
   user = ctx.user()
-
+  # retrieve the user profile, this is a common feature but not from the official OAuth2 spec
   user.user_info() { |res_err,res|
     if (res_err != nil)
       # request didn't succeed because the token was revoked so we
@@ -51,6 +51,9 @@
       userInfo = res
 
       # fetch the user emails from the github API
+
+      # the fetch method will retrieve any resource and ensure the right
+      # secure headers are passed.
       user.fetch("https://api.github.com/user/emails") { |res2_err,res2|
         if (res2_err != nil)
           # request didn't succeed because the token was revoked so we