Add clear method to JsonArray

[LorenzNickel]

The method will clear the contents of a JsonArray

[Marcono1234]

@eamonnmcmanus could you please have a look?

For consistency a JsonObject.clear() method might be useful as well, but that can be done in a separate pull request, if desired.

[eamonnmcmanus]

I think if we're able to add an asList() method to JsonArray, we shouldn't need other new methods like this?

[Marcono1234]

Right, though the open question with asList() is still null handling I think.

Maybe clear() is needed often enough to justify having it directly on JsonArray either way? But I am not too sure.

[dhoard]

I feel that JsonArray/JsonObject clear() would be in common use to reuse an existing object. From an API perspective, it seems like an expected method and a natural match to add(), remove(), etc.

I don't feel that JsonArray/JsonObject should start implementing List/Map methods across the board.

[eamonnmcmanus]

I think object reuse is poor practice so I don't find that a convincing argument. If people really want to reuse JsonArray instances they can do array.asList().clear(). But making a new JsonArray is generally better. So I'm still unconvinced by JsonArray.clear(), and even more so by JsonObject.clear().

[dhoard]

I think object reuse is poor practice so I don't find that a convincing argument. If people really want to reuse JsonArray instances they can do array.asList().clear(). But making a new JsonArray is generally better. So I'm still unconvinced by JsonArray.clear(), and even more so by JsonObject.clear().

Fair enough.