HistoryService

Retrieves a page of changes between sinceId (exclusively) and untilId (inclusively).

Retrieves a page of changesets between includeIds and excludeIds. The changesets that are returned represent those which are reachable from the changesets, branches or tags referenced by the includeIds but not reachable from the changesets, branches or tags referenced by excludeIds. Paths may be provided to further narrow the results, restricting the returned changesets to only those which affect those paths.

This method is useful over the other variants for situations that may include potential merges with changesets that are not relevant. Consider the following:

 ---- A ------ B ------ C
       \                 \
        \                 \
        FA1 ---- FA2 ---- FA3
 

Retrieves a page of changesets between untilId and sinceId. The changesets that are returned represent those which are reachable from the changeset, branch or tag referenced by untilId but not reachable from the changeset, branch or tag referenced by sinceId. While this may imply an ancestral relationship between the two IDs, that is not strictly required. When the two IDs are unrelated, all changesets referenceable from untilId are candidates for the returned page, and the sinceId is effectively ignored.

The order of sinceId and untilId is important here. Consider the following example:

1. Branch "feature-A" was created from "master" when "master" was at changeset A
2. Changesets FA1, FA2 and FA3 were created on the "feature-A" branch
3. Changesets B and C were made on "master" after the branch was created

 ---- A ---- B ---- C
       \
        \
        FA1 ---- FA2 ---- FA3
 

Retrieves a page of changesets between untilId and sinceId. The changesets that are returned represent those which are reachable from the changeset, branch or tag referenced by untilId but not reachable from the changeset, branch or tag referenced by sinceId. While this may imply an ancestral relationship between the two IDs, that is not strictly required. When the two IDs are unrelated, all changesets referenceable from untilId are candidates for the returned page, and the sinceId is effectively ignored. A path may be provided to further narrow the results, restricting the returned changesets to only those which affect that path.

The order of sinceId and untilId is important here. Consider the following example:

1. Branch "feature-A" was created from "master" when "master" was at changeset A
2. Changesets FA1, FA2 and FA3 were created on the "feature-A" branch
3. Changesets B and C were made on "master" after the branch was created

 ---- A ---- B ---- C
       \
        \
        FA1 ---- FA2 ---- FA3
 

Retrieves each of the changesets in changesetIds and returns their details, including the first page of changes between the changeset in question and its first parent.

If the page size is less than the size of the collection of IDs, a subset of the collection will be returned. Otherwise, detailed changesets for all IDs in the requested collection are returned.

Streams changesets between untilId and sinceId in repository repository. See getChangesetsBetween(...) for a description of the semantics of the changesets returned.

A path may be provided to further narrow the results, restricting the returned changesets to only those which affect that path.

This method promises to call onStart() on the supplied callback once followed by zero or more calls to onChangeset(Changeset), one for each changeset to be streamed (until false is returned by onChangeset(...) or there are no more changesets), followed by a single call to onEnd().