org.jivesoftware.smackx.httpfileupload

Class HttpFileUploadManager

java.lang.Object

org.jivesoftware.smack.Manager

org.jivesoftware.smackx.httpfileupload.HttpFileUploadManager

public final class HttpFileUploadManager
extends Manager

A manager for XEP-0363: HTTP File Upload.

See Also:

XEP-0363: HTTP File Upload

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAMESPACE Namespace of XEP-0363 v0.4 or higher.
static String	NAMESPACE_0_2 Namespace of XEP-0363 v0.2 or lower.

Method Summary

Modifier and Type	Method and Description
boolean	discoverUploadService() Discover upload service.
UploadService	getDefaultUploadService() Get default upload service if it was discovered.
static HttpFileUploadManager	getInstanceFor(XMPPConnection connection) Obtain the HttpFileUploadManager responsible for a connection.
boolean	isUploadServiceDiscovered() Check if upload service was discovered.
static UploadService.Version	namespaceToVersion(String namespace)
Slot	requestSlot(String filename, long fileSize) Request a new upload slot from default upload service (if discovered).
Slot	requestSlot(String filename, long fileSize, String contentType) Request a new upload slot with optional content type from default upload service (if discovered).
Slot	requestSlot(String filename, long fileSize, String contentType, DomainBareJid uploadServiceAddress) Request a new upload slot with optional content type from custom upload service.
void	setTlsContext(SSLContext tlsContext)
URL	uploadFile(File file) Request slot and uploaded file to HTTP file upload service.
URL	uploadFile(File file, UploadProgressListener listener) Request slot and uploaded file to HTTP file upload service with progress callback.
void	useTlsSettingsFrom(ConnectionConfiguration connectionConfiguration)

Methods inherited from class org.jivesoftware.smack.Manager

connection, getAuthenticatedConnectionOrThrow, schedule

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final String NAMESPACE

Namespace of XEP-0363 v0.4 or higher. Constant value "urn:xmpp:http:upload:0".

See Also:

XEP-0363 v0.4.0, Constant Field Values

NAMESPACE_0_2

public static final String NAMESPACE_0_2

Namespace of XEP-0363 v0.2 or lower. Constant value "urn:xmpp:http:upload".

See Also:

XEP-0363 v0.2.5, Constant Field Values

Method Detail

getInstanceFor

public static HttpFileUploadManager getInstanceFor(XMPPConnection connection)

Obtain the HttpFileUploadManager responsible for a connection.

Parameters:

connection - the connection object.

Returns:

a HttpFileUploadManager instance

discoverUploadService

public boolean discoverUploadService()
                              throws XMPPException.XMPPErrorException,
                                     SmackException.NotConnectedException,
                                     InterruptedException,
                                     SmackException.NoResponseException

Discover upload service. Called automatically when connection is authenticated. Note that this is a synchronous call -- Smack must wait for the server response.

Returns:

true if upload service was discovered

Throws:

XMPPException.XMPPErrorException

SmackException.NotConnectedException

InterruptedException

SmackException.NoResponseException

isUploadServiceDiscovered

public boolean isUploadServiceDiscovered()

Check if upload service was discovered.

Returns:

true if upload service was discovered

getDefaultUploadService

public UploadService getDefaultUploadService()

Get default upload service if it was discovered.

Returns:

upload service JID or null if not available

uploadFile

public URL uploadFile(File file)
               throws InterruptedException,
                      XMPPException.XMPPErrorException,
                      SmackException,
                      IOException

Request slot and uploaded file to HTTP file upload service. You don't need to request slot and upload file separately, this method will do both. Note that this is a synchronous call -- Smack must wait for the server response.

Parameters:

file - file to be uploaded

Returns:

public URL for sharing uploaded file

Throws:

InterruptedException

XMPPException.XMPPErrorException

SmackException

IOException - in case of HTTP upload errors

uploadFile

public URL uploadFile(File file,
                      UploadProgressListener listener)
               throws InterruptedException,
                      XMPPException.XMPPErrorException,
                      SmackException,
                      IOException

Request slot and uploaded file to HTTP file upload service with progress callback. You don't need to request slot and upload file separately, this method will do both. Note that this is a synchronous call -- Smack must wait for the server response.

Parameters:

file - file to be uploaded

listener - upload progress listener of null

Returns:

public URL for sharing uploaded file

Throws:

InterruptedException

XMPPException.XMPPErrorException

SmackException

IOException

requestSlot

public Slot requestSlot(String filename,
                        long fileSize)
                 throws InterruptedException,
                        XMPPException.XMPPErrorException,
                        SmackException

Request a new upload slot from default upload service (if discovered). When you get slot you should upload file to PUT URL and share GET URL. Note that this is a synchronous call -- Smack must wait for the server response.

Parameters:

filename - name of file to be uploaded

fileSize - file size in bytes.

Returns:

file upload Slot in case of success

Throws:

IllegalArgumentException - if fileSize is less than or equal to zero or greater than the maximum size supported by the service.

InterruptedException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

SmackException.NoResponseException

SmackException

requestSlot

public Slot requestSlot(String filename,
                        long fileSize,
                        String contentType)
                 throws SmackException,
                        InterruptedException,
                        XMPPException.XMPPErrorException

Request a new upload slot with optional content type from default upload service (if discovered). When you get slot you should upload file to PUT URL and share GET URL. Note that this is a synchronous call -- Smack must wait for the server response.

Parameters:

filename - name of file to be uploaded

fileSize - file size in bytes.

contentType - file content-type or null

Returns:

file upload Slot in case of success

Throws:

IllegalArgumentException - if fileSize is less than or equal to zero or greater than the maximum size supported by the service.

SmackException.NotConnectedException

InterruptedException

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException

requestSlot

public Slot requestSlot(String filename,
                        long fileSize,
                        String contentType,
                        DomainBareJid uploadServiceAddress)
                 throws SmackException,
                        InterruptedException,
                        XMPPException.XMPPErrorException

Request a new upload slot with optional content type from custom upload service. When you get slot you should upload file to PUT URL and share GET URL. Note that this is a synchronous call -- Smack must wait for the server response.

Parameters:

filename - name of file to be uploaded

fileSize - file size in bytes.

contentType - file content-type or null

uploadServiceAddress - the address of the upload service to use or null for default one

Returns:

file upload Slot in case of success

Throws:

IllegalArgumentException - if fileSize is less than or equal to zero or greater than the maximum size supported by the service.

SmackException

InterruptedException

XMPPException.XMPPErrorException

setTlsContext

public void setTlsContext(SSLContext tlsContext)

useTlsSettingsFrom

public void useTlsSettingsFrom(ConnectionConfiguration connectionConfiguration)

namespaceToVersion

public static UploadService.Version namespaceToVersion(String namespace)