Allow installations to determine order of files on Dataset page

[djbrooke]

Some installations will find it useful to define the order in which files in a dataset are presented to users. An example of this is QDR, where "0_" is prepended to the names of documentation files as a not-so-great way to get those documentation files to the top, since the ordering is alphabetical:

https://data.qdr.syr.edu/dataset.xhtml?persistentId=doi:10.5064/F6BUAX58

Consider an installation setting of ordering by a specific tag, date, alphanumeric, etc. or some other solution.

[pdurbin]

• Related: Add ability to reorder dataset files as draggable elements #5280

[qqmyers]

Base on earlier IQSS/QDR discussions, we've just implemented a way to 'statically' order files by tag, using a new setting to allow specification of the tag sort order. (Files are sorted by tag, and alphabetically for those with the same tag). The order can include the standard Documentation, Data, and Code tags as well as custom ones created in an instance. The files are sorted after retrieval, relying on the fact that DV retrieves the whole file list (versus one page's worth). On a dataset with 2K files, having a few near the end with tags that have to get sorted to the top doesn't seem to affect display speed much (~6 seconds with or without sorting in my test).

I'll go ahead and create a PR to get the code out, but it may not make sense to merge if it won't work with the overall page redesign (it might if the underlying code to handle the list of files doesn't change), or if there's progress on #5280, etc.

One note w.r.t. the code: I implemented sorting by replacing the comparator used at https://github.com/IQSS/dataverse/blob/develop/src/main/java/edu/harvard/iq/dataverse/DatasetVersion.java#L205. However, in doing that, I discovered, at QDR, that this sort did not work when the List was an org.eclipse.persistence.indirection.IndirectList. I suspect that https://bugs.eclipse.org/bugs/show_bug.cgi?id=446236 is involved. As far as I can tell, the FileMetadatas are generally alphabetical to start with, so I'm not sure that the failure to sort by label (file name) would have been noticed. To sort by category, I make sure that the List is an ArrayList which gets sorted properly. This step could go away once the org.eclipse.persistence.indirection.IndirectList class is updated (I'm guessing it's in glassfish somewhere?).

[djbrooke]

Thanks @qqmyers. As you mention, I don't anticipate we'll merge this due to dataset and file redesign efforts in flight, but others in the community may be interested in the code.

[mheppler]

I think the biggest impact the redesign would have on this issue is the inclusion of a "Sort" btn above the file table (see attached), that allows the user to toggle between multiple sort options.

It appears this pull request does not include any UI impact as of yet. My feedback would be to include the sort functionality in the UI. That feature was originally request in issue #2506, which was closed and consolidated into all of the file ui improvements in issue #3404, but that doesn't mean it needs to wait for all of the other redesign efforts.

[pdurbin]

If we're not waiting for all the other redesign efforts we might want @tjanek to take a look at pull request #5485 since he pushed some related code to a branch (unmerged) for #5280.

[qqmyers]

FWIW - I think this PR is consistent with a sort button: it could just be one more option along with by date, alphabetical, and by category. In that sense it could separated from the GUI update if desired.