Class NetworkEvent

java.lang.Object

com.codename1.ui.events.ActionEvent

com.codename1.io.NetworkEvent

public class NetworkEvent
extends ActionEvent

Event containing more meta data for network events which may be error events or an update for progress indication code.

Nested Class Summary

Nested classes/interfaces inherited from class ActionEvent

ActionEvent.Type

Field Summary

Fields

Modifier and Type	Field	Description
static final int	PROGRESS_TYPE_COMPLETED	Indicates that the connection request has completed
static final int	PROGRESS_TYPE_INITIALIZING	Indicates that a new request is initializing its connection
static final int	PROGRESS_TYPE_INPUT	Indicates the value for the current input stream reading
static final int	PROGRESS_TYPE_OUTPUT	Indicates the value for the current output stream writing

Constructor Summary

Constructors

Constructor	Description
NetworkEvent(ConnectionRequest request, int progressType)	Constructs a network status update event used to update progress indicators and application logic of the current state in the NetworkManager
NetworkEvent(ConnectionRequest request, int responseCode, String message)	Constructs a response code even
NetworkEvent(ConnectionRequest source, Exception error)	Constructs an event for an error message
NetworkEvent(ConnectionRequest request, Object metaData)	Constructs a callback event from a connection request with some arbitrary associated meta data

Method Summary

Modifier and Type	Method	Description
ConnectionRequest	getConnectionRequest()	Equivalent to getSource() casted to connection request
Exception	getError()	Returns
int	getLength()	Returns the length of the download event or the upload event in case it is known.
String	getMessage()	Returns
Object	getMetaData()	Returns
int	getProgressPercentage()	Returns the percentage of progress for a download operation assuming length is known
int	getProgressType()	Indicates the type of progres indication for this event
int	getResponseCode()	Indicates the response code sent by the response code listener
int	getSentReceived()	Returns the amount of data received up to this event or sent up to this event (depending on the event type).
void	setError(Exception error)	Parameters

Methods inherited from class ActionEvent

consume, getActualComponent, getCommand, getComponent, getDraggedComponent, getDropTarget, getEventType, getKeyEvent, getProgress, getSource, getX, getY, isConsumed, isLongEvent, isPointerPressedDuringDrag, setPointerPressedDuringDrag

Methods inherited from class Object

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

Field Details

PROGRESS_TYPE_INITIALIZING

public static final int PROGRESS_TYPE_INITIALIZING

Indicates that a new request is initializing its connection

See Also:

• Constant Field Values

PROGRESS_TYPE_OUTPUT

public static final int PROGRESS_TYPE_OUTPUT

Indicates the value for the current output stream writing

See Also:

• Constant Field Values

PROGRESS_TYPE_INPUT

public static final int PROGRESS_TYPE_INPUT

Indicates the value for the current input stream reading

See Also:

• Constant Field Values

PROGRESS_TYPE_COMPLETED

public static final int PROGRESS_TYPE_COMPLETED

Indicates that the connection request has completed

See Also:

• Constant Field Values

Constructor Details

NetworkEvent

public NetworkEvent(ConnectionRequest source,
 Exception error)

Constructs an event for an error message

Parameters

• source: source of the error message

• error: the exception

NetworkEvent

public NetworkEvent(ConnectionRequest request,
 int responseCode,
 String message)

Constructs a response code even

Parameters

• request: the connection request indicating progress

• responseCode: the code

• message: the error message

NetworkEvent

public NetworkEvent(ConnectionRequest request,
 int progressType)

Constructs a network status update event used to update progress indicators and application logic of the current state in the NetworkManager

Parameters

• request: the connection request indicating progress

• progressType

NetworkEvent

public NetworkEvent(ConnectionRequest request,
 Object metaData)

Constructs a callback event from a connection request with some arbitrary associated meta data

Parameters

• request: the connection request

• metaData: the data associated with the event

Method Details

getConnectionRequest

public ConnectionRequest getConnectionRequest()

Equivalent to getSource() casted to connection request

Returns

the source connection request

getError

public Exception getError()

Returns

the error

setError

public void setError(Exception error)

Parameters

• error: the error to set

getProgressType

public int getProgressType()

Indicates the type of progres indication for this event

Returns

Returns:

One of PROGRESS_TYPE_COMPLETED, PROGRESS_TYPE_INITIALIZING, PROGRESS_TYPE_INPUT, PROGRESS_TYPE_OUTPUT

getResponseCode

public int getResponseCode()

Indicates the response code sent by the response code listener

Returns

HTTP error code

getLength

public int getLength()

Returns the length of the download event or the upload event in case it is known. -1 is returned when the value is unknown.

Returns

the length length in bytes or -1

getSentReceived

public int getSentReceived()

Returns the amount of data received up to this event or sent up to this event (depending on the event type).

Returns

the receieved or sent value

getProgressPercentage

public int getProgressPercentage()

Returns the percentage of progress for a download operation assuming length is known

Returns

the percentage of the download or -1

getMetaData

public Object getMetaData()

Returns

the metaData

getMessage

public String getMessage()

Returns

the message