[BUG][dart-dio] optimize parameterToString to convert DateTime correctly

[ahmednfwela]

Description

Currently DateTime is being converted to string using normal .ToString()
Ref:

openapi-generator/modules/openapi-generator/src/main/resources/dart-dio/api_util.mustache

Lines 6 to 14 in c322084

	String parameterToString(Serializers serializers, dynamic value) {
	if (value == null) {
	return '';
	} else if (value is String || value is num) {
	return value.toString();
	} else {
	return json.encode(serializers.serialize(value));
	}
	}

instead, toIso8601String should be used

openapi-generator version

V5.0.0

Suggested fix:

  if (value == null) {
    return '';
  } else if (value is String || value is num) {
    return value.toString();
  } else if (value is DateTime) {
    return value.toIso8601String();
  } else {
    return json.encode(serializers.serialize(value));
  }

[kuhnroyal]

If it is a DateTime it should use the configured serializer that is also used for JSOn content. Is this not happening?

[ahmednfwela]

no, even bool isn't serialized correctly
it outputs a json object rather than a json value

[kuhnroyal]

Yea we should not serialize primitives with a serializer.

[kuhnroyal]

Can you please review and possibly test the PR

[kuhnroyal]

If no specific serializer is used, built_value will add a discriminator field and make it a JSON object.
The check for bool was missing.

[ahmednfwela]

I think the issue here is that built_value should have handled primitives better than this, serialization shouldn't be so over-complicated.
I think we should file an issue at their side to handle this while we temporarily fix it.

[kuhnroyal]

parameterToString is only used for form data, we always need a normal String representation. That is not really what built_value is meant to be used for. Maybe the problem is triggered by the json.encode call.

In any case, for DateTime it should have used the registered Iso8601DateTimeSerializer.

[kuhnroyal]

I have update the PR and added tests, can you check if that solves your issues?

[ahmednfwela]

I have been using my own templates, and I believe they solve most of the issues that I came across

https://github.com/Bdaya-Dev/Custom-Openapi-Templates

They have been tested on multiple specifications too

[kuhnroyal]

Ok so I have not thought about collections. Looking at the Dio FormData implementation makes a couple things clearer: https://github.com/flutterchina/dio/blob/master/dio/lib/src/utils.dart#L34

It seems your list.join(',') is some custom handling that FormData doesn't support by default?

[ahmednfwela]

the problem is the way backend handles requests, some want it to be path[index]=value, others path=value0,value1,value2
this is highly opinionated, so it depends on what I am currently using