Scope is not added properly in generated code

[reta]

The CodegenSecurity model exposes scopes as a map which is not aligned within its usage in code generation templates. As the result, the scopes are not generated properly. The suggested fix is to update all templates to deal with scopes map in a proper way.

Verified against OAS2 / OAS3 generators, the following specification fragment

  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          scopes:
            read: read scope
            write: ""

On the generation side, the following code is being generated for OAS2 and OAS3 respectively.

@ApiOperation(                                                             
  value = "",                                                              
  notes = "Search all people",                                             
  response = Person.class,                                                 
  responseContainer = "List",                                              
  authorizations = {                                                       
    @Authorization(                                                        
      value = "oauth2",                                                    
      scopes = {                                                           
        @AuthorizationScope(scope = "read", description = "read scope"),   
        @AuthorizationScope(scope = "write", description = "")             
      }                                                                    
    )                                                                      
  },                                                                       
  tags = {"people"}                                                        
)                                                                          

@Operation(                                     
  summary = "",                                 
  description = "Search all people",            
  security = {                                  
    @SecurityRequirement(                       
      name = "oauth2",                          
      scopes = {"read", "write"}                
    )                                           
  },                                            
  tags = {"people"}                             
)                                               

    if ("oauth2".equals(authName)) {                                   
      auth = new OAuth(OAuthFlow.accessCode, "", "", "read, write");   
    }                                                           

Fixes swagger-api/swagger-codegen#10225.

[reta]

@HugoMario please whenever you have time, I think this is the right way, using the same map-style iteration over scopes, tested on mostly all generators.

[reta]

@HugoMario sorry, mind taking a look please? Thanks!

[HugoMario]

LGTM, thanks a lot !