Changeset class removed from 4.0?

[Mathieu Yargeau]

We have plugins that still use the 'Changeset' class. I know it is deprecated, but I though I read somewhere, when 3.7 was released, that it would be removed only in 5.0 since it was a big change.

We are moving from 3.10 to 4.3 next week, and I just saw in the changelog:

"Starting from 3.7 Stash's API is being normalized, replacing Changeset with Commit and replacingDetailedChangeset with Changeset. Because this normalization will touch so many classes and interfaces, the deprecated elements will be retained through the entire 4.x release cycle and will be removed in 4.0. This means plugins developed using the now- deprecated names will continue to work, unchanged, until 4.0."

https://developer.atlassian.com/stash/docs/latest/reference/api-changelog.html

It does not correspond to what I read before, and that sentence does not make sense to me. If it is retained 'through the entire 4.x release cycle', it says the opposite right after when saying that it 'will be removed in 4.0'.

Will the 'Changeset' class still be available in 4.3?

EDIT: I just found where I read that, but again, there is a contradiction.

In the 3.7 API (and 3.8), it says it will be removed in 5.0 https://developer.atlassian.com/static/javadoc/stash/3.7.0/api/reference/com/atlassian/stash/content/Changeset.html
In the 3.10 API (and 3.11), it says it will be removed in 4.0 https://developer.atlassian.com/static/javadoc/stash/3.10.0/api/reference/com/atlassian/stash/content/Changeset.html

Which one tells the truth?

[Felix · Accepted solution]

Hi @Mathieu Yargeau,

Changeset has been renamed in Bitbucket Server 4.0.

An explanation of the change can be found here.

There were quite a few API changes in 4.0 (the entire package namespace changed to reflect the new name), so if you are adding support for 4.0 to a plugin I'd recommend you check out the upgrade guide, which details many of the changes.

Hope that helps, 

Felix Haehnel 
Developer
Bitbucket Server