com.softwareag.mobile.runtime.comms

Class HttpConnectionHandler

java.lang.Object

com.softwareag.mobile.runtime.comms.HttpConnectionHandler

All Implemented Interfaces:

java.lang.Runnable

public class HttpConnectionHandler
extends java.lang.Object
implements java.lang.Runnable

Launches new http-connection threads

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTION_DELETE
static int	ACTION_GET
static int	ACTION_HEAD
static int	ACTION_POST
static int	ACTION_PUT
boolean	cancelled The user can cancel the connection by setting this to true
javax.microedition.io.HttpConnection	conn
java.lang.Thread	conn_thread
int	connection_status
static int	Encoding_Default
static int	Encoding_Form
static int	Encoding_Json
static int	Encoding_OctetStream
static int	Encoding_Xml
byte[]	init_data_to_send
int	init_encoding_format
java.lang.String[]	init_request_properties
int	init_required_action
java.lang.String	init_url
boolean	response_being_received This is set when the response starts coming in
int	response_code
byte[]	response_data The data that's coming in
int	response_data_read The amount of data that's been read so far
java.lang.String[]	response_header The header data that's coming in
int	response_length This will be set to the length (or -1 if the length isn't known)

Constructor Summary

Constructors

Constructor and Description
HttpConnectionHandler()

Method Summary

Methods

Modifier and Type	Method and Description
void	closeConnection() Close this connection (doesn't kill its thread though)
void	initConnection(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties) Initialise the connection and start a new thread for it
void	initConnection(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties, int required_action) Initialise the connection and start a new thread for it with the required action.
void	initConnection(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties, int required_action, int timeout_ms) Initialise the connection and start a new thread for it with the required action.
void	killThread() Kills this connection's thread and closes its connection
void	openConnection() Tries to open up a connection using the init_ data that was set previously
static HttpConnectionHandler	openHttpConnectionByteArrayData(java.lang.String url, int encoding_format, byte[] data_to_send)
static HttpConnectionHandler	openHttpConnectionByteArrayData(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties) Opens up an http(s)-connection, assuming that the required action is ACTION_POST if data_to_send is not null, or ACTION_GET if it is.
static HttpConnectionHandler	openHttpConnectionByteArrayData(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties, int required_action) Opens up an http(s)-connection
static HttpConnectionHandler	openHttpConnectionByteArrayData(java.lang.String url, int encoding_format, byte[] data_to_send, java.lang.String[] request_properties, int required_action, int timeout) Opens up an http(s)-connection
static void	openHttpConnectionStringData(java.lang.String url, int encoding_format, java.lang.String data_to_send)
static void	openHttpConnectionStringData(java.lang.String url, int encoding_format, java.lang.String data_to_send, java.lang.String[] request_properties) Opens up an http(s)-connection.
static void	openHttpConnectionStringData(java.lang.String url, int encoding_format, java.lang.String data_to_send, java.lang.String[] request_properties, int required_action) Opens up an http(s)-connection.
static void	openHttpConnectionStringData(java.lang.String url, int encoding_format, java.lang.String data_to_send, java.lang.String[] request_properties, int required_action, int timeout_ms) Opens up an http(s)-connection.
void	run() The main method kicked off when the http-thread starts
void	setPostHeaders() Put this in its own method so we can extend this easily
void	setPutHeaders() Put this in its own method so we can extend this easily
static java.lang.String	urlDecode(java.lang.String url) URL decodes a string
static java.lang.String	urlEncode(java.lang.String url) URL encodes a string

Methods inherited from class java.lang.Object

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

Field Detail

ACTION_GET

public static final int ACTION_GET

See Also:

Constant Field Values

ACTION_POST

public static final int ACTION_POST

See Also:

Constant Field Values

ACTION_PUT

public static final int ACTION_PUT

See Also:

Constant Field Values

ACTION_DELETE

public static final int ACTION_DELETE

See Also:

Constant Field Values

ACTION_HEAD

public static final int ACTION_HEAD

See Also:

Constant Field Values

Encoding_Default

public static final int Encoding_Default

See Also:

Constant Field Values

Encoding_OctetStream

public static final int Encoding_OctetStream

See Also:

Constant Field Values

Encoding_Form

public static final int Encoding_Form

See Also:

Constant Field Values

Encoding_Xml

public static final int Encoding_Xml

See Also:

Constant Field Values

Encoding_Json

public static final int Encoding_Json

See Also:

Constant Field Values

conn_thread

public java.lang.Thread conn_thread

conn

public javax.microedition.io.HttpConnection conn

connection_status

public int connection_status

cancelled

public boolean cancelled

The user can cancel the connection by setting this to true

init_url

public java.lang.String init_url

init_encoding_format

public int init_encoding_format

init_data_to_send

public byte[] init_data_to_send

init_request_properties

public java.lang.String[] init_request_properties

init_required_action

public int init_required_action

response_code

public int response_code

response_being_received

public boolean response_being_received

This is set when the response starts coming in

response_length

public int response_length

This will be set to the length (or -1 if the length isn't known)

response_data_read

public int response_data_read

The amount of data that's been read so far

response_data

public byte[] response_data

The data that's coming in

response_header

public java.lang.String[] response_header

The header data that's coming in

Constructor Detail

HttpConnectionHandler

public HttpConnectionHandler()

Method Detail

openHttpConnectionByteArrayData

public static HttpConnectionHandler openHttpConnectionByteArrayData(java.lang.String url,
                                                    int encoding_format,
                                                    byte[] data_to_send,
                                                    java.lang.String[] request_properties,
                                                    int required_action,
                                                    int timeout)
                                                             throws UnsupportedConnectionTypeException

Opens up an http(s)-connection

Parameters:

url - URL to set up a connection with

encoding_format - The format to encode the data (should be one of the Encoding_ values)

data_to_send - data to send (or null, if this is just a get)

request_properties - String array of key-value pairs for setRequestProperty

required_action - The expected action to take with the connection, one of ACTION_GET, ACTION_PUT, ACTION_POST, ACTION_HEAD or ACTION_DELETE

timeout - connection timeout in milliseconds

Throws:

UnsupportedConnectionTypeException

openHttpConnectionByteArrayData

public static HttpConnectionHandler openHttpConnectionByteArrayData(java.lang.String url,
                                                    int encoding_format,
                                                    byte[] data_to_send,
                                                    java.lang.String[] request_properties,
                                                    int required_action)
                                                             throws UnsupportedConnectionTypeException

Opens up an http(s)-connection

Parameters:

url - URL to set up a connection with

encoding_format - The format to encode the data (should be one of the Encoding_ values)

data_to_send - data to send (or null, if this is just a get)

request_properties - String array of key-value pairs for setRequestProperty

required_action - The expected action to take with the connection, one of ACTION_GET, ACTION_PUT, ACTION_POST, ACTION_HEAD or ACTION_DELETE

Throws:

UnsupportedConnectionTypeException

openHttpConnectionByteArrayData

public static HttpConnectionHandler openHttpConnectionByteArrayData(java.lang.String url,
                                                    int encoding_format,
                                                    byte[] data_to_send,
                                                    java.lang.String[] request_properties)

Opens up an http(s)-connection, assuming that the required action is ACTION_POST if data_to_send is not null, or ACTION_GET if it is.

Parameters:

url - URL to set up a connection with

encoding_format - The format to encode the data (should be one of the Encoding_ values)

data_to_send - data to send (or null, if this is just a get)

request_properties - String array of key-value pairs for setRequestProperty

openHttpConnectionByteArrayData

public static HttpConnectionHandler openHttpConnectionByteArrayData(java.lang.String url,
                                                    int encoding_format,
                                                    byte[] data_to_send)

openHttpConnectionStringData

public static void openHttpConnectionStringData(java.lang.String url,
                                int encoding_format,
                                java.lang.String data_to_send,
                                java.lang.String[] request_properties,
                                int required_action,
                                int timeout_ms)
                                         throws UnsupportedConnectionTypeException

Opens up an http(s)-connection. Assumes a non-null string
(Calls the byte version of this method under the hood)

Throws:

UnsupportedConnectionTypeException

openHttpConnectionStringData

public static void openHttpConnectionStringData(java.lang.String url,
                                int encoding_format,
                                java.lang.String data_to_send,
                                java.lang.String[] request_properties,
                                int required_action)
                                         throws UnsupportedConnectionTypeException

Opens up an http(s)-connection. Assumes a non-null string
(Calls the byte version of this method under the hood)

Throws:

UnsupportedConnectionTypeException

openHttpConnectionStringData

public static void openHttpConnectionStringData(java.lang.String url,
                                int encoding_format,
                                java.lang.String data_to_send,
                                java.lang.String[] request_properties)

Opens up an http(s)-connection. Assumes a non-null string
(Calls the byte version of this method under the hood)

openHttpConnectionStringData

public static void openHttpConnectionStringData(java.lang.String url,
                                int encoding_format,
                                java.lang.String data_to_send)

urlEncode

public static java.lang.String urlEncode(java.lang.String url)

URL encodes a string

urlDecode

public static java.lang.String urlDecode(java.lang.String url)

URL decodes a string

initConnection

public void initConnection(java.lang.String url,
                  int encoding_format,
                  byte[] data_to_send,
                  java.lang.String[] request_properties)

Initialise the connection and start a new thread for it

initConnection

public void initConnection(java.lang.String url,
                  int encoding_format,
                  byte[] data_to_send,
                  java.lang.String[] request_properties,
                  int required_action,
                  int timeout_ms)
                    throws UnsupportedConnectionTypeException

Initialise the connection and start a new thread for it with the required action.

Parameters:

required_action - The expected action to take with the connection, one of ACTION_GET, ACTION_PUT, ACTION_POST, ACTION_HEAD or ACTION_DELETE

Throws:

UnsupportedConnectionTypeException

initConnection

public void initConnection(java.lang.String url,
                  int encoding_format,
                  byte[] data_to_send,
                  java.lang.String[] request_properties,
                  int required_action)
                    throws UnsupportedConnectionTypeException

Initialise the connection and start a new thread for it with the required action.

Parameters:

required_action - The expected action to take with the connection, one of ACTION_GET, ACTION_PUT, ACTION_POST, ACTION_HEAD or ACTION_DELETE

Throws:

UnsupportedConnectionTypeException

closeConnection

public void closeConnection()

Close this connection (doesn't kill its thread though)

killThread

public void killThread()

Kills this connection's thread and closes its connection

setPostHeaders

public void setPostHeaders()
                    throws java.io.IOException

Put this in its own method so we can extend this easily

Throws:

java.io.IOException

setPutHeaders

public void setPutHeaders()
                   throws java.io.IOException

Put this in its own method so we can extend this easily

Throws:

java.io.IOException

openConnection

public void openConnection()

Tries to open up a connection using the init_ data that was set previously

run

public void run()

The main method kicked off when the http-thread starts

Specified by:

run in interface java.lang.Runnable