(dev/core#217) PrevNext - Define and use fillWithSql()/fillWithArray()

[totten]

Overview

Update the PrevNext interface to define methods fillWithSql() and fillWithArray(). Update all (F1) existing contact-search screens to use these methods.

This is a cherry-pick from #12377.

See also: dev/core#217

Before

CRM_Contact_Selector (advanced search, et al) and CRM_Campaign_Selector_Search (reserve respondents, etc) fill the PrevNext cache by directly inserting to the SQL table civicrm_prevnext_cache

After

CRM_Contact_Selector (advanced search, et al) and CRM_Campaign_Selector_Search (reserve respondents, etc) fill the PrevNext cache by calling either Civi::service('prevnext')->fillWithSql() or Civi::service('prevnext')->fillWithArray()

Comments

(F1) In keeping with the general scoping of the dev/core#217, this PR only revises code used by the search UI -- it doesn't touch dedupe. For dedupe, the main concern is that it should continue writing directly to SQL. Since we only touch search UI code, this PR should have no impact on dedupe.

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[eileenmcnaughton]

I read through this & it looks good to me - I'm gonna do some testing on exporting from custom searches once this is merged & also once #12535 is merged (since I'd rather be testing both at once as they both touch search + export).