com.jdroid.github.service

Class DownloadService

java.lang.Object

com.jdroid.github.service.GitHubService

com.jdroid.github.service.DownloadService

public class DownloadService
extends GitHubService

Service for accessing, creating, and deleting repositories downloads.

See Also:

GitHub downloads API documentation

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	UPLOAD_ACL UPLOAD_ACL
static java.lang.String	UPLOAD_AWS_ACCESS_KEY_ID UPLOAD_AWS_ACCESS_KEY_ID
static java.lang.String	UPLOAD_CONTENT_TYPE UPLOAD_CONTENT_TYPE
static java.lang.String	UPLOAD_FILE UPLOAD_FILE
static java.lang.String	UPLOAD_FILENAME UPLOAD_FILENAME
static java.lang.String	UPLOAD_KEY UPLOAD_KEY
static java.lang.String	UPLOAD_POLICY UPLOAD_POLICY
static java.lang.String	UPLOAD_SIGNATURE UPLOAD_SIGNATURE
static java.lang.String	UPLOAD_SUCCESS_ACTION_STATUS UPLOAD_SUCCESS_ACTION_STATUS

Fields inherited from class com.jdroid.github.service.GitHubService

ACCEPT_FULL, ACCEPT_HTML, ACCEPT_RAW, ACCEPT_TEXT, client

Constructor Summary

Constructors

Constructor and Description
DownloadService() Create download service
DownloadService(GitHubClient client) Create download service

Method Summary

Modifier and Type	Method and Description
DownloadResource	createDownload(IRepositoryIdProvider repository, Download download, java.io.File file) Create download from content of given file.
DownloadResource	createDownload(IRepositoryIdProvider repository, Download download, java.io.InputStream content, long size) Create download and set the content to be the content of given input stream.
protected PagedRequest<Download>	createDownloadsRequest(IRepositoryIdProvider repository, int start, int size) Create paged downloads request
DownloadResource	createResource(IRepositoryIdProvider repository, Download download) Create a new resource for download associated with the given repository
void	deleteDownload(IRepositoryIdProvider repository, int id) Delete download with given id from given repository
Download	getDownload(IRepositoryIdProvider repository, int id) Get download metadata for given repository and id
java.util.List<Download>	getDownloads(IRepositoryIdProvider repository) Get metadata for all downloads for given repository
PageIterator<Download>	pageDownloads(IRepositoryIdProvider repository) Page metadata for downloads for given repository
PageIterator<Download>	pageDownloads(IRepositoryIdProvider repository, int size) Page downloads for given repository
PageIterator<Download>	pageDownloads(IRepositoryIdProvider repository, int start, int size) Page downloads for given repository
void	uploadResource(DownloadResource resource, java.io.InputStream content, long size) Upload a resource to be available as the download described by the given resource.

Methods inherited from class com.jdroid.github.service.GitHubService

check, createPagedRequest, createPagedRequest, createPageIterator, createRequest, getAll, getAll, getClient, getId, verifyRepository

Methods inherited from class java.lang.Object

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

Field Detail

UPLOAD_KEY

public static final java.lang.String UPLOAD_KEY

UPLOAD_KEY

See Also:

Constant Field Values

UPLOAD_ACL

public static final java.lang.String UPLOAD_ACL

UPLOAD_ACL

See Also:

Constant Field Values

UPLOAD_SUCCESS_ACTION_STATUS

public static final java.lang.String UPLOAD_SUCCESS_ACTION_STATUS

UPLOAD_SUCCESS_ACTION_STATUS

See Also:

Constant Field Values

UPLOAD_FILENAME

public static final java.lang.String UPLOAD_FILENAME

UPLOAD_FILENAME

See Also:

Constant Field Values

UPLOAD_AWS_ACCESS_KEY_ID

public static final java.lang.String UPLOAD_AWS_ACCESS_KEY_ID

UPLOAD_AWS_ACCESS_KEY_ID

See Also:

Constant Field Values

UPLOAD_POLICY

public static final java.lang.String UPLOAD_POLICY

UPLOAD_POLICY

See Also:

Constant Field Values

UPLOAD_SIGNATURE

public static final java.lang.String UPLOAD_SIGNATURE

UPLOAD_SIGNATURE

See Also:

Constant Field Values

UPLOAD_FILE

public static final java.lang.String UPLOAD_FILE

UPLOAD_FILE

See Also:

Constant Field Values

UPLOAD_CONTENT_TYPE

public static final java.lang.String UPLOAD_CONTENT_TYPE

UPLOAD_CONTENT_TYPE

See Also:

Constant Field Values

Constructor Detail

DownloadService

public DownloadService()

Create download service

DownloadService

public DownloadService(GitHubClient client)

Create download service

Parameters:

client -

Method Detail

getDownload

public Download getDownload(IRepositoryIdProvider repository,
                            int id)
                     throws java.io.IOException

Get download metadata for given repository and id

Parameters:

repository -

id -

Returns:

download

Throws:

java.io.IOException

createDownloadsRequest

protected PagedRequest<Download> createDownloadsRequest(IRepositoryIdProvider repository,
                                                        int start,
                                                        int size)

Create paged downloads request

Parameters:

repository -

start -

size -

Returns:

request

getDownloads

public java.util.List<Download> getDownloads(IRepositoryIdProvider repository)
                                      throws java.io.IOException

Get metadata for all downloads for given repository

Parameters:

repository -

Returns:

non-null but possibly empty list of download metadata

Throws:

java.io.IOException

pageDownloads

public PageIterator<Download> pageDownloads(IRepositoryIdProvider repository)

Page metadata for downloads for given repository

Parameters:

repository -

Returns:

iterator over pages of downloads

pageDownloads

public PageIterator<Download> pageDownloads(IRepositoryIdProvider repository,
                                            int size)

Page downloads for given repository

Parameters:

repository -

size -

Returns:

iterator over pages of downloads

pageDownloads

public PageIterator<Download> pageDownloads(IRepositoryIdProvider repository,
                                            int start,
                                            int size)

Page downloads for given repository

Parameters:

repository -

start -

size -

Returns:

iterator over pages of downloads

deleteDownload

public void deleteDownload(IRepositoryIdProvider repository,
                           int id)
                    throws java.io.IOException

Delete download with given id from given repository

Parameters:

repository -

id -

Throws:

java.io.IOException

createResource

public DownloadResource createResource(IRepositoryIdProvider repository,
                                       Download download)
                                throws java.io.IOException

Create a new resource for download associated with the given repository

Parameters:

repository -

download -

Returns:

download resource

Throws:

java.io.IOException

uploadResource

public void uploadResource(DownloadResource resource,
                           java.io.InputStream content,
                           long size)
                    throws java.io.IOException

Upload a resource to be available as the download described by the given resource.

Parameters:

resource -

content -

size -

Throws:

java.io.IOException

createDownload

public DownloadResource createDownload(IRepositoryIdProvider repository,
                                       Download download,
                                       java.io.InputStream content,
                                       long size)
                                throws java.io.IOException

Create download and set the content to be the content of given input stream. This is a convenience method that performs a createResource(IRepositoryIdProvider, Download) followed by a uploadResource(DownloadResource, InputStream, long) with the results.

Parameters:

repository -

download - metadata about the download

content - raw content of the download

size - size of content in the input stream

Returns:

created resource

Throws:

java.io.IOException

createDownload

public DownloadResource createDownload(IRepositoryIdProvider repository,
                                       Download download,
                                       java.io.File file)
                                throws java.io.IOException

Create download from content of given file.

Parameters:

repository -

download - metadata about the download

file - must be non-null

Returns:

created resource

Throws:

java.io.IOException

See Also:

createDownload(IRepositoryIdProvider, Download, InputStream, long)