| example.http.HttpView
| HttpView | | public class HttpView extends MIDlet implements CommandListener,Runnable(Code) | | An example MIDlet to fetch a page using an HttpConnection.
Refer to the startApp, pauseApp, and destroyApp
methods so see how it handles each requested transition.
|
| Constructor Summary | |
| public | HttpView()
initialize the MIDlet with the current display object. |
| Method Summary | |
| void | cleanUp(HttpConnection conn, InputStream input, OutputStream output)
Clean up all objects used by the HttpConnection. | | void | clearForm(Form form)
Clear out all items in a Form. | | public void | commandAction(Command c, Displayable s)
| | public void | destroyApp(boolean unconditional)
Destroy must cleanup everything. | | void | genErrorsForm(String s, Throwable ex)
Set the Alert to the exception message and display it. | | void | genHeaderForm(HttpConnection c)
Generate and fill in the Form with the header fields. | | void | genProgressForm(String name, String url)
Generate the options form with URL title and progress gauge. | | void | genRequestForm(HttpConnection c)
Generate the form with the request attributes and values. | | HttpConnection | handleRedirects(HttpConnection c)
Check for redirect response codes and handle
the redirect by getting the new location and
opening a new connection to it. | | public void | pauseApp()
Pause signals the thread to stop by clearing the thread field. | | public void | run()
Fetch the specified url in a separate thread and update the
progress bar as it goes.
If the user cancels the fetch, the thread be changed from this thread.
If this happens no further updates should be made to the
displayable forms. | | void | setConfig(HttpConnection c)
Add request properties for the configuration, profiles,
and locale of this system. | | void | setupList()
Check the attributes in the descriptor that identify
url's and titles and initialize the lists of urls
and urlList. | | void | showAlert(String s, Screen next)
Set the alert string and display it. | | public void | startApp()
Start creates the thread to do the timing. |
| alert | | Alert alert(Code) | | user interface alert component.
|
| backCommand | | Command backCommand(Code) | | user interface command to return back to previous screen.
|
| cancelCommand | | Command cancelCommand(Code) | | user interface command to cancel the current screen.
|
| content | | TextBox content(Code) | | user interface text box for the contents of the fetched URL.
|
| display | | Display display(Code) | | current display.
|
| errorsCommand | | Command errorsCommand(Code) | | user interface command to display errors from current request.
|
| errorsForm | | Form errorsForm(Code) | | form to display exceptions
|
| exitCommand | | Command exitCommand(Code) | | user interface command for indicating Exit request.
|
| getCommand | | Command getCommand(Code) | | user interface command to request an HTTP GET transaction.
|
| headCommand | | Command headCommand(Code) | | user interface command to request an HTTP HEAD transaction.
|
| headerForm | | Form headerForm(Code) | | user interface screen for HTTP headers
|
| headersCommand | | Command headersCommand(Code) | | user interface command to request current HTTP headers.
|
| helpCommand | | Command helpCommand(Code) | | user interface command to display help message.
|
| newURLCommand | | Command newURLCommand(Code) | | user interface command to enter a new URL
|
| okCommand | | Command okCommand(Code) | | user interface command to confirm current screen.
|
| postCommand | | Command postCommand(Code) | | user interface command to request an HTTP POST transaction.
|
| progressForm | | Form progressForm(Code) | | user interface form to hold progress results.
|
| progressGauge | | Gauge progressGauge(Code) | | user interface progress indicator.
|
| reloadCommand | | Command reloadCommand(Code) | | user interface command for indicating a page reload request.
|
| removeURLCommand | | Command removeURLCommand(Code) | | user interface command to remove the current URL
|
| requestCommand | | Command requestCommand(Code) | | current HTTP request type - GET, HEAD, or POST
|
| requestForm | | Form requestForm(Code) | | form to display request including parsing
|
| requestsCommand | | Command requestsCommand(Code) | | user interface command to display current HTTP request headers.
|
| thread | | Thread thread(Code) | | instance of a thread for asynchronous networking and user interface.
|
| urlList | | List urlList(Code) | | user interface component containing a list of URLs
|
| urlbox | | TextBox urlbox(Code) | | data entry text box for inputting URLs
|
| HttpView | | public HttpView()(Code) | | initialize the MIDlet with the current display object.
|
| cleanUp | | void cleanUp(HttpConnection conn, InputStream input, OutputStream output)(Code) | | Clean up all objects used by the HttpConnection. We must
close the InputStream, OutputStream objects, as well as the
HttpConnection object, to reclaim system resources. Otherwise,
we may not be able to make new connections on some platforms.
Parameters:
conn - the HttpConnection
Parameters:
input - the InputStream of the HttpConnection, may be nullif it's not yet opened.
Parameters:
output - the OutputStream the HttpConnection, may be nullif it's not yet opened. |
| clearForm | | void clearForm(Form form)(Code) | | Clear out all items in a Form.
Parameters:
form - the Form to clear. |
| commandAction | | public void commandAction(Command c, Displayable s)(Code) | | Respond to commands, including exit
Parameters:
c - user interface command requested
Parameters:
s - screen object initiating the request |
| destroyApp | | public void destroyApp(boolean unconditional)(Code) | | Destroy must cleanup everything. The thread is signaled
to stop and no result is produced.
Parameters:
unconditional - true if a forced shutdown was requested |
| genErrorsForm | | void genErrorsForm(String s, Throwable ex)(Code) | | Set the Alert to the exception message and display it.
Parameters:
s - the Exception title string
Parameters:
ex - the Exception |
| genHeaderForm | | void genHeaderForm(HttpConnection c) throws IOException(Code) | | Generate and fill in the Form with the header fields.
Parameters:
c - the open connection with the result headers. |
| genProgressForm | | void genProgressForm(String name, String url)(Code) | | Generate the options form with URL title and progress gauge.
Parameters:
name - the title of the URL to be loaded.
Parameters:
url - label for the progress gauge |
| genRequestForm | | void genRequestForm(HttpConnection c) throws IOException(Code) | | Generate the form with the request attributes and values.
Parameters:
c - the open connection with the request headers. |
| handleRedirects | | HttpConnection handleRedirects(HttpConnection c) throws IOException(Code) | | Check for redirect response codes and handle
the redirect by getting the new location and
opening a new connection to it. The original
connection is closed.
The process repeats until there are no more redirects.
Parameters:
c - the initial HttpConnection the final HttpConnection |
| pauseApp | | public void pauseApp()(Code) | | Pause signals the thread to stop by clearing the thread field.
If stopped before done with the iterations it will
be restarted from scratch later.
|
| run | | public void run()(Code) | | Fetch the specified url in a separate thread and update the
progress bar as it goes.
If the user cancels the fetch, the thread be changed from this thread.
If this happens no further updates should be made to the
displayable forms. Those shared objects may be re-used
by the next fetch.
|
| setConfig | | void setConfig(HttpConnection c) throws IOException(Code) | | Add request properties for the configuration, profiles,
and locale of this system.
Parameters:
c - current HttpConnection to receive user agent header |
| setupList | | void setupList()(Code) | | Check the attributes in the descriptor that identify
url's and titles and initialize the lists of urls
and urlList.
The attributes are named "ViewTitle-n" and "ViewURL-n".
The value "n" must start at "1" and increment by 1.
|
| showAlert | | void showAlert(String s, Screen next)(Code) | | Set the alert string and display it.
Parameters:
s - the error message
Parameters:
next - the screen to be shown after the Alert. |
| startApp | | public void startApp()(Code) | | Start creates the thread to do the timing.
It should return immediately to keep the dispatcher
from hanging.
|
|
|