net.rim.device.api.browser.field
Class UrlRequestedEvent

java.lang.Object
  net.rim.device.api.browser.field.Event
      net.rim.device.api.browser.field.UrlRequestedEvent

public class UrlRequestedEvent
extends Event

Event to signal the request of an URL.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

Field Summary

Fields inherited from class net.rim.device.api.browser.field.Event

EVENT_BROWSER_CONTENT_CHANGED, EVENT_CANCEL_REQUEST_RESOURCE, EVENT_CLOSE, EVENT_ERROR_DISPLAY, EVENT_EXECUTING_SCRIPT, EVENT_FULL_WINDOW, EVENT_HISTORY, EVENT_LONG_RUNNING_SCRIPT, EVENT_REDIRECT, EVENT_SET_HEADER, EVENT_SET_HTTP_COOKIE, EVENT_STOP, EVENT_TICK_CONTENT_READ, EVENT_UI_DIRECTION_REQUEST, EVENT_URL_REQUESTED, PUBLIC_EVENT_THRESHOLD

Constructor Summary
	UrlRequestedEvent(Object src, String url, byte[] postData, HttpHeaders headers, boolean programmatic, int flags) Creates a new UrlRequestedEvent instance.

Method Summary
	int	getFlags() Retrieves the flags of this event.
	HttpHeaders	getHeaders() Retrieves the HTTP headers from this event.
	byte[]	getPostData() Retrieves the post data from this event.
	String	getURL() Retrieves the URL from this event.
	boolean	isProgrammatic() Determines if this event was programmatic in origin.

Methods inherited from class net.rim.device.api.browser.field.Event

getSource, getSourceURL, getUID, resolveUrl

Methods inherited from class java.lang.Object

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

Constructor Detail

UrlRequestedEvent

public UrlRequestedEvent(Object src,
                         String url,
                         byte[] postData,
                         HttpHeaders headers,
                         boolean programmatic,
                         int flags)

Creates a new UrlRequestedEvent instance.

Parameters:

src - Source that generated this event.

url - URL associated with the event.

postData - data for a POST request, or null if the request uses the GET method.

headers - HTTP headers.

programmatic - programmatic flag.

flags - flags for this event.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

Method Detail

getURL

public String getURL()

Retrieves the URL from this event.

Returns:

URL for this event.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getPostData

public byte[] getPostData()

Retrieves the post data from this event.

Returns:

post data for this event.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getHeaders

public HttpHeaders getHeaders()

Retrieves the HTTP headers from this event.

Returns:

HTTP headers for this event.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

getFlags

public int getFlags()

Retrieves the flags of this event.

Returns:

Specific flags for this event.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0

isProgrammatic

public boolean isProgrammatic()

Determines if this event was programmatic in origin.

Returns:

True if this event's origin was programmatic; otherwise, false.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.0.0