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 repository, by a given user, 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) Constructor for the GitHub checker.

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.
void	refresh()
protected void	setRepository()

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

Constructor for the GitHub checker. Checks a given GitHub repositories versions and latest version, if available.

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 void refresh()
             throws java.io.IOException

Specified by:

refresh in class VersionChecker

Throws:

java.io.IOException

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

Specified by:

setRepository in class VersionChecker

Throws:

java.io.IOException

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.