CSCI 7010UGAMarch 23rd, 2010
BES/MDSTCP/IPBISWiFiWAP 2.0WAP 1.0
Blackberry Enterprise Server/Mobile Data System used if the Blackberry device is owned
by a company and is set up to run through their servers
lets the Blackberry device make a secure connection to corporate servers
Transmission Control Protocol/Internet Protocol
a “regular” internet connectionworks with most devices
Blackberry Internet Service for devices that aren’t under a BES
used to send email Internet connections, but less secure
than BES but you need to be part of the
Blackberry Alliance Program to use it
802.11 B/G and sometimes A allows device to connect to network via
a WiFi router device user has to configure device to
connect to the router Pro: better speed, lower latency, no
carrier data charges Con: WiFi coverage less than wireless
network coverage can write app so that it looks for WiFi
first and then falls back to BES or BIS
Wireless Access Protocolconnects through wireless carrier’s
WAP gatewayno Blackberry-specific infrastructure
but user’s plan must support WAP 2.0 (most do)
don’t need to configure as with TCP/IP
older version of WAPsupported by all Blackberry devicesbut doesn’t support secure
connections as do other methods
What should you do? If activated on a BES:
use BES/MDS If not activated on a BES:
use WAP 2.0 fall back to TCP/IP
In either case, might want to check for WiFi
how the device maintains info about its configuration
records about optional applicationsemail account configurationconnection methods available on a
device
open device Options
click Advanced Options Service Book
Demo on the simulator
Two parts: CID – defines the type of record UID – a unique identifier
most connection methods have a record in the service book
javax.microedition.io.Connector used it before to open files can also use it to open network connections
Example: HttpConnection connection = (HttpConnection)
Connector.open(“http://www.cnn.com”); or HttpConnection connection = (HttpConnection)
Connector.open(“http://www.apress.com”);
Connection_type connectionName= (Connection_type) Connector.open(URL);
Connection_type is some subclass of ConnectionconnectionName is a variable name that you
chooseURL takes the form
scheme://host:port/path[optional parameters]Example URLs:
file://myfile.htmlhttp://www.apress.com:80/book/catalogsocket://www.apress.com:80https://www.amazon.com/gp/flex/sign-in/select.html
Hypertext transfer protocol protocol of the World Wide Web connectionless request-response
opens a connection to an http serversends a request message receives the responsedisplays result
listens for a connection from client receives a requestdelivers a responsecloses the connection
initial line (different for request & response)
header lines (zero or more)blank lineoptional message body
METHOD path http_version GET /path/to/file/index.html HTTP/1.0
METHOD: GET – “Please send this resource” POST – “Here are some details about it” HEAD – “Just checking some info about it”
PATH: the part of the URL after the host name
also know as “status line” HTTP_version status_code
reason_phrase HTTP/1.0 200 OK HTTP/1.1 404 Not Found
status codes: 100s – informational 200s – success of some kind 300s – redirect to another URL 400s – client error 500s – server error
Let’s run it from a web browser first ...
package com.beginningblackberry.networking;
import net.rim.device.api.ui.UiApplication;
public class NetworkingApplication extends UiApplication {
public NetworkingApplication() {NetworkingMainScreen scr = new
NetworkingMainScreen();pushScreen(scr);
}
public static void main(String[] args) {NetworkingApplication app = new
NetworkingApplication();app.enterEventDispatcher();
}}
package com.beginningblackberry.networking;import net.rim.device.api.ui.container.MainScreen;
public class NetworkingMainScreen extends MainScreen {private EditField urlField;private BitmapField imageOutputField;private RichTextField textOutputField;
.... methods on following slides
}
public NetworkingMainScreen() {
setTitle("Networking");urlField = new EditField("URL:", "");textOutputField = new RichTextField();imageOutputField = new BitmapField();
add(urlField); add(new SeparatorField());
postDataField = new EditField("Post data:", "");add(postDataField); add(new SeparatorField());
add(new LabelField("Image retrieved:"));add(imageOutputField); add(new SeparatorField());add(new LabelField("Text retrieved:"));add(textOutputField);
}
protected void makeMenu(Menu menu, int instance) {super.makeMenu(menu, instance);menu.add(new MenuItem("Get", 10, 10) {
public void run() {getURL();} }
);menu.add(new MenuItem("Post", 10, 10) {
public void run() {postURL();}}
);menu.add(new MenuItem("Socket Get", 10, 10) {
public void run() {socketGet();}}
);}
http://www.purpletech.com/talks/Threads.ppt
More on multi-threading (if you’re interested):
http://www.cs.uga.edu/~eileen/Concurrency_tutorials
You can learn about any component by looking at the API documentation.
See:http://www.blackberry.com/developers/docs/4.1api/index.htmlto learn more about the MenuItem component
private void getURL() {HttpRequestDispatcher dispatcher =
new HttpRequestDispatcher(urlField.getText(), "GET", this);dispatcher.start();
}
... creates a new thread for the network-related operation
... and starts it up
package com.beginningblackberry.networking;
/* * Class to handle creating the request, sending it off, * and receiving the response */
public class HttpRequestDispatcher extends Thread { private String url; private String method; // GET or POST private NetworkingMainScreen screen; private byte[] postData;...
}
public HttpRequestDispatcher(String url, String method, NetworkingMainScreen screen) { this.url = url; this.method = method; this.screen = screen; }
public HttpRequestDispatcher(String url, String method,NetworkingMainScreen screen, byte[] postData) {
this.url = url; this.method = method; this.screen = screen; this.postData = postData; }
public void run(){try{HttpConnection connection = (HttpConnection) Connector.open(url);
int responseCode = connection.getResponseCode();
if (responseCode != HttpConnection.HTTP_OK){screen.requestFailed(“Unexpected
response code: “ + responseCode); connection.close(); return; }...
String contentType = connection.getHeaderField(“Content-type”);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
InputStream responseData = connection.openInputStream();byte[] buffer = new byte[10000];
int bytesRead = responseData.read(buffer);while (bytesRead > 0){
baos.write(buffer, 0, bytesRead);bytesRead = responseData.read(buffer);
}baos.close();connection.close();screen.requestSucceeded(baos.toByteArray(), contentType);} catch (IOException ex){ screen.requestFailed(ex.toString());}}
public void requestSucceeded(byte[] result, String contentType) {if (contentType.equals("image/png") ||
contentType.equals("image/jpeg") ||contentType.equals("image/gif")) {
Bitmap bitmap = Bitmap.createBitmapFromBytes(result, 0, result.length, 1);
synchronized (UiApplication.getEventLock()) {imageOutputField.setBitmap(bitmap);
}}else if (contentType.startsWith("text/")) {
String strResult = new String(result);synchronized (UiApplication.getEventLock()) {textOutputField.setText(strResult);}
}else {
synchronized (UiApplication.getEventLock()) {Dialog.alert("Unknown content type: " + contentType);}
}}
public void requestFailed(final String message) {UiApplication.getUiApplication().invokeLater(new Runnable() {
public void run() {Dialog.alert("Request failed. Reason: " + message);
}});
}
}
.... and we’ve skipped some gory detail for now
See: http://beginningblackberry.appspot.com
Enter some words in the form – apple berry cinnamon doughnut
returns doughnut cinnamon berry apple
What’s in the web application?
<html> <head><title>Form</title></head><body><img src="img/apress_logo.png" /><br /> <form action="/" method="POST"><br /> <input type="text" name="content"></input> <input type="submit" value="Go!"/> </form> </body></html>
<form action="/" method="POST">- defines a form that the browser uses
to send data to the web application- send data to the ULR “/” (the base
URL )- using HTTP POST
<input type="text" name="content"></input>
defines the text boxgives it the name “content”
the application expects the content to be something like:
content = ONE+TWO+THREE“+” interpreted as a space
<input type="submit" value="Go!"/> defines the “Go” button as invoking
POST
</form> indicates end of the form
private byte[] postData;- to pass the POST body to the dispatcher
public HttpRequestDispatcher(String url, String method, NetworkingMainScreen screen, byte[] postData){
this.url = url;this.method = method;this.screen = screen;this.postData = postData;
}- constructor to initialize
if (method.equals(“POST”) && postData != null){connection.setRequestProperty(“Content-type”, “application/x-www-form-urlencoded”);
OutputStream requestOutput = connection.openOutputStream();
requestOutput.write(postData);requestOutput.close();
}
private void postURL(){ String postString = postDataField.getText();
URLEncodedPostData encodedData = new URLEncodedPostData(null, false);
encodedData.append(“content”, postString);
HttpRequestDispatcher dispatcher = new HttpRequestDispatcher(urlField.getText(), “
POST”, this, encodedData.getBytes());
dispatcher.start();}
let’s look at the code
explanation ... and let’s look at the code ...
private void socketGet() { SocketConnector connector = new
SocketConnector(urlField.getText(), this); connector.start(); }
private void postURL() { String postString = postDataField.getText(); URLEncodedPostData encodedData = new
URLEncodedPostData(null, false); encodedData.append("content", postString); HttpRequestDispatcher dispatcher = new
HttpRequestDispatcher(urlField .getText(), "POST", this, encodedData.getBytes()); dispatcher.start(); }
