fm.audiobox.core.net

Class Upload

java.lang.Object

fm.audiobox.core.net.Upload

public class Upload
extends java.lang.Object

Uploads media files to AudioBox Cloud.

Constructor Summary

Constructors

Constructor and Description
Upload(AudioBoxClient audioBoxClient, java.io.File file, NetworkProgressListener listener) Instantiates a new Upload.

Method Summary

Methods

Modifier and Type	Method and Description
NetworkProgressListener	getListener() Gets listener.
void	setListener(NetworkProgressListener listener) Sets listener.
MediaFile	start() Starts to upload media files to AudioBox Cloud.

Methods inherited from class java.lang.Object

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

Constructor Detail

Upload

public Upload(AudioBoxClient audioBoxClient,
      java.io.File file,
      NetworkProgressListener listener)

Instantiates a new Upload.

Parameters:

audioBoxClient - the client

file - the file to upload on AudioBox

listener - the listener

Method Detail

getListener

public NetworkProgressListener getListener()

Gets listener.

Returns:

the listener

setListener

public void setListener(NetworkProgressListener listener)

Sets listener.

Parameters:

listener - the listener

start

public MediaFile start()
                throws java.io.IOException,
                       java.lang.IllegalStateException

Starts to upload media files to AudioBox Cloud.

If the subscription is not valid ForbiddenException is thrown. If a media file already exists on AudioBox Cloud FileAlreadyUploaded is thrown.

Other errors may include ValidationException, SystemOverloadedException or RemoteMessageException with additional information in the exception body.

The application should ensure to accept those errors and retry accordingly after few minutes.

On successful upload the server returns a new MediaFile with additional information, including the token assigned to the newly uploaded media file.

Files uploaded through this method will go directly into the CloudPlaylist.

Returns:

a MediaFile containing additional information

Throws:

AudioBoxException - if any of the remote error exception is detected.

java.lang.IllegalStateException - if the operation is already running or it's completed

java.io.IOException - if any connection problem occurs.

See Also:

AudioBoxException