Custom sorting/position is not honored for V2

Using an annotation such as:

@ApiOperation(
         value = "Operation",
         notes = "Notes",
         position = 2
 )

and a custom ordering such as:

docket.apiDescriptionOrdering(new Ordering<ApiDescription>() {

        @Override
        public int compare(ApiDescription left, ApiDescription right) {
            int leftPos = left.getOperations().size() == 1 ? left.getOperations().get(0).getPosition() : 0;
            int rightPos = right.getOperations().size() == 1 ? right.getOperations().get(0).getPosition() : 0;

            int position = Integer.compare(leftPos, rightPos);

            if(position == 0) {
                position = left.getPath().compareTo(right.getPath());
            }

            return position;
        }
    });

The scanner framework seems to read the documentation and sort it properly. When the data is extracted to the Swagger object at Swagger2Controller.java:74, the ordering seems to be lost.

[grtessman]

So let me get this right… If your consumer has to follow a hateoas pattern: ie: Call1 must get a list of objects and returns Id to make call 2 Call2 must use id from Call1 to fetch an object that has a list of objects to fetch for Call3 by Id Call3 must use id from Call2 to retrieve last object

But somewhere, someone decided that Alphabetical was a good solution??? Umm… WHY? Now, I have to explain to all users of my swagger doc that they must start at 2, then goto 3 then goto 1 depending on how my endpoint is alphabetically arranged.

Pure and utter NONSENSE! FIX THIS!

[chenmu5241]

I try new version 2.9.2，operationOrdering and apiListingReferenceOrdering not working！It’s a bug！