de.griefed.versionchecker.github

Class GitHubChecker

java.lang.Object

de.griefed.versionchecker.VersionChecker

de.griefed.versionchecker.github.GitHubChecker

public class GitHubChecker
extends VersionChecker

Check a given GitHub repository for updates.
Versions are checked for semantic-release-formatting. Meaning tags must look like the following examples:
2.0.0
2.1.1
3.0.0-alpha.1
3.0.0-alpha.13
1.2.3-beta.1
and so on.

Constructor Summary

Constructors

Constructor and Description
GitHubChecker(@NotNull java.lang.String gitHubUserRepository) Constructs a GitHub checker with the given user/repository combination to allow for version checks as well as version and URL acquisition.

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	allVersions() Gather a list of all available versions for the given repository.
java.util.List<java.lang.String>	getAssetsDownloadUrls(@NotNull java.lang.String requestedVersion) Get the asset download URLs for a particular tag/version.
java.lang.String	getDownloadUrl(@NotNull java.lang.String version) Get the URL for the given release version.
java.lang.String	latestVersion(boolean checkForPreRelease) Get the latest regular release.
GitHubChecker	refresh() Refresh this GitHub-instance.
protected void	setRepository() Acquire this instances repository information and store it in a JsonNode for later use.

Methods inherited from class de.griefed.versionchecker.VersionChecker

checkForUpdate, getAllVersions, getObjectMapper, getResponse, latestAlpha, latestBeta, setAllVersions

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GitHubChecker

public GitHubChecker(@NotNull
                     @NotNull java.lang.String gitHubUserRepository)
              throws java.net.MalformedURLException

Constructs a GitHub checker with the given user/repository combination to allow for version checks as well as version and URL acquisition.

Parameters:

gitHubUserRepository - String. GitHub user/repository-combination. For example Griefed/ServerPackCreator

Throws:

java.net.MalformedURLException - Thrown if the resulting URL is malformed or otherwise invalid.

Method Detail

refresh

public GitHubChecker refresh()
                      throws java.io.IOException

Refresh this GitHub-instance. Refreshes repository information, the latest version, as well as a list of all available versions.

Specified by:

refresh in class VersionChecker

Returns:

This GitHub-instance.

Throws:

java.io.IOException - Exception thrown if setRepository() or setLatest() encounter an error.

allVersions

public java.util.List<java.lang.String> allVersions()

Gather a list of all available versions for the given repository.

Specified by:

allVersions in class VersionChecker

Returns:

List String. Returns a list of all available versions. If an error occurred, or no versions are available, null is returned.

latestVersion

public java.lang.String latestVersion(boolean checkForPreRelease)

Get the latest regular release.

Specified by:

latestVersion in class VersionChecker

Parameters:

checkForPreRelease - Boolean. Whether to include alpha and beta releases for latest release versions.

Returns:

String. Returns the latest regular release. If no regular release is available, no_release is returned.

getDownloadUrl

public java.lang.String getDownloadUrl(@NotNull
                                       @NotNull java.lang.String version)

Get the URL for the given release version.

Specified by:

getDownloadUrl in class VersionChecker

Parameters:

version - String. The version for which to get the URL to.

Returns:

String. Returns the URL to the given release version.

setRepository

protected void setRepository()
                      throws java.io.IOException

Acquire this instances repository information and store it in a JsonNode for later use.

Specified by:

setRepository in class VersionChecker

Throws:

java.io.IOException - Thrown if the repository can not be reached or any other unexpected error occurs.

getAssetsDownloadUrls

public java.util.List<java.lang.String> getAssetsDownloadUrls(@NotNull
                                                              @NotNull java.lang.String requestedVersion)

Get the asset download URLs for a particular tag/version.

Specified by:

getAssetsDownloadUrls in class VersionChecker

Parameters:

requestedVersion - String. The version you want to retrieve the asset download URLs for.

Returns:

List String. A list of download URLs for the assets of the given tag/version.