Compiling Cinequest

For iPhone:
- git clone https://github.com/cpollett/Cinequest-iOS.git
- After you have made your initial clone you will use git pull to keep it up to date.
- You should then be able to click on the xcode project file compile and run it.

For Android:

git clone https://github.com/cpollett/Cinequest-Android.git
After you have made your initial clone you will use git pull to keep it up to date.

There is a file called How to build with ant. Follow its instructions:

1)	Execute the following command
	
	android list targets
	This should give a list of available targets to compile Cinequest to
	Pick a recent one say android-19, then do
	
	android update project --target android-19 --path . --subprojects
	
	for each of the following directories
	
	facebook/
	JavaCommon/
	Android/

2)	Navigate to Android/ using terminal and execute the following commands,
	
	ant clean
	ant debug install
 	adb shell am start -n edu.sjsu.cinequest/.HomeActivity

Be patient, also the above assumes that the paths to ant and adb have been set up correctly.

Networking on the iPhone

The iPhone analog of WebView is UIWebView.
You could drag and drop this into a view using Interface Builder.
But since we haven't done UI stuff programmatically yet, let's consider how we could do it.

Create a new single-view application then modify the delegate:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:
    (NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [_window makeKeyAndVisible];

    CGRect bounds = [[UIScreen mainScreen ] applicationFrame];
    UIWebView *webView = [[UIWebView alloc] initWithFrame:bounds];
    webView.scalesPageToFit = YES;

    [_window addSubview:webView];

    NSURL *url = [NSURL URLWithString:@"http://www.pollett.org"];
    NSURLRequest *request = [NSURLRequest requestWithURL:url];
    [webView loadRequest:request];
    return YES;
}

Some UIWebView and UiWebViewDelegate methods

A UIWebView object manages browser history and you can use these to control browsing programmatically with calls like: [webView goBack]; [webView goForward]; [webView reload]; [webView stopLoading];
The web view class also supports a set of delegate methods which will be called automatically when certain events occur.
To set the handler for this methods you could create a subclass of UIWebViewDelegate and then set it with the command:
```
webView.delegate = myDelegate;
```
Here are some of the messages you can override:
- -(BOOL)webView:(UIWebView *)webView, shouldStartLoadWithRequest:(NSURLRequest *)request, navigationType:(UIWebViewNavigationType)navigationType; -- this is called when the web view is instructed to load content. It should return YES to commence loading. The possible navigationType parameters are: UIWebViewNavigationTypeLinkClicked, UIWebViewNavigationTypeFormSubmitted, UIWebViewNavigationTypeBackForward, UIWebViewNavigationTypeReload, UIWebViewNavigationTypeFormResubmitted, UIWebViewNavigationTypeOther.
- -(void)webViewDidStartLoad:(UIWebView)webView; -- notified when the web view begins loading a request
- -(void)webViewDidFinishLoad:(UIWebView)webView; -- notified when the web view finishes loading a request
- -(void)webView:(UIWebView *)webView, didFailLoadWithError:(NSError *)error -- Notified if an error occurs in the loading of a request

Quiz

Which of the following is true?

The Link layer is the TCP/IP layer most responsible for making connections to a port on a device at a given IP address.
We used the class ConnectivityManager in our Android applications to make a socket connection to an IP address at a given port.
HttpURLConnection can be used to open a connection to a web server and make an HTTP request for a web page it.

Getting the Response into Data

So what if we want a quick and dirty way to get the response of a web service?

We can do:

NSData *myData = [NSData dataWithContentsOfURL: [NSURL URLWithString: @"http://web_service_url"]];

Many objects actually have a way to directly use an NSData object. For instance, if the response was an image we could do:
```
UIImage *image = [UIImage imageWithData: myData]; 
```

To get a string out of myData for parsing we could do:

NSString *string = [NSString stringWithFormat:@"%.*s", [myData length], [myData bytes]];

Creating CFSockets

Making sockets on the iPhone is a little bit harder than on Android.
We will only consider the case of writing a socket client not a server.
The socket API is based-off Berkeley sockets but with its own function names and not too many examples.
The basics steps we need are:
- Create a socket context
- Write a callback function
- Set up the address to connect to
- Connect and wait for the connection to complete in a run loop

Description of Our App

Our app connects to a server written in Java.
We send the message "Hello\n".
The Java server sends back a colon separated list of cities
The iPhone app displays these cities in a table.

Code of Server we will connect to

import java.io.*;
import java.net.*;

public final class MyServer extends Thread
{
   private static final int PORT=8889;
   private static final int NUM_CONNECT=1;

   private MyServer() {}

   public static void main(String args[])
   {
      MyServer myServer = new MyServer();
      if(myServer !=null) {myServer.start();}
   }

   public void run()
   {
      try
      {
         ServerSocket server = new ServerSocket(PORT, NUM_CONNECT);
         Socket client = server.accept();

         BufferedReader reader = new BufferedReader(
            new InputStreamReader(client.getInputStream()));

         PrintWriter writer = new PrintWriter(new BufferedWriter(
            new OutputStreamWriter(client.getOutputStream())));

         String line = reader.readLine();

         System.out.println("Hello"+line);

         if(line.equals("HELLO"))
         {
            writer.print("Chicago:New York:San Francisco:");
            writer.print("Chicago:New York:San Francisco:");
            writer.println("Chicago:New York:San Francisco\n");
         }
         writer.flush();
      }
      catch(IOException ie)
      {
         ie.printStackTrace();
      }
   }
}

Set up the socket

Sockets on the iPhone are a C library, so the function calls are C.

Here is the code we use to set-up the socket:

CFSocketContext context = { 0, msg, NULL, NULL, NULL };
	
	
CFSocketRef client = CFSocketCreate(NULL, PF_INET, SOCK_STREAM, IPPROTO_TCP,
     kCFSocketConnectCallBack, (CFSocketCallBack)ConnectCallBack, &context);

The CFSocketContext struct looks like:

struct CFSocketContext {
   CFIndex version; // must be 0
   void *info; // data to send
   CFAllocatorRetainCallBack retain; // callback called when do CFRetain, CFRelease,CFCopy
   CFAllocatorReleaseCallBack release;
   CFAllocatorCopyDescriptionCallBack copyDescription;
};

The arguments to CFSocketCreate are:

CFSocketRef CFSocketCreate (
   CFAllocatorRef allocator,
   SInt32 protocolFamily, //PF_INET is IPv4
   SInt32 socketType, 
   SInt32 protocol,
   CFOptionFlags callBackTypes, //when we want to be called back
   CFSocketCallBack callout, //our callback
   const CFSocketContext *context
);

Set up the address to connect to:

Next we set up the address and port we want to connect to

struct sockaddr_in theName;
struct hostent *hp;
CFDataRef addressData;
	
theName.sin_port = htons(8889);
theName.sin_family = AF_INET; //what kind in internet addresses to use; want IP
	
hp = gethostbyname("pollett.org");
if( hp == NULL ) {
   return;
}

memcpy( &theName.sin_addr.s_addr, hp->h_addr_list[0], hp->h_length );
	
addressData = CFDataCreate( NULL, (UInt8 *)&theName, (CFIndex)sizeof( struct sockaddr_in ) );

Set up our Run Loop to wait for the connection to establish

We're ready to connect. But it might take a while for the connection to establish so we want to set up how we wait for this:

CFSocketConnectToAddress(client, addressData, 1); //connect; 1 second timeout

CFRunLoopSourceRef sourceRef =
		CFSocketCreateRunLoopSource(kCFAllocatorDefault, client, 0);
CFRunLoopAddSource(CFRunLoopGetCurrent(), sourceRef, kCFRunLoopCommonModes);
CFRelease(sourceRef);
CFRunLoopRun();

Our Callback Function

The callback is a C function so is not within a class definition. So we just put it outside of the implementation block of the class that is going to use it.

Here is the code:

CFSocketNativeHandle sock;
UInt8 buffer[1024];

void ConnectCallBack(
   CFSocketRef socket,
   CFSocketCallBackType type,
   CFDataRef address,
   const void *data,
   void *info)
{
    char *msg = info;
	
    NSLog(@"%s\n", msg);

    sock = CFSocketGetNative(socket);
	
    send(sock, msg, strlen(msg)+1, 0);
    recv(sock, buffer, sizeof(buffer), 0);
    NSLog(@"Got: %s \n", buffer);

	
    CFRunLoopStop(CFRunLoopGetCurrent()); //return execution to our program
    return;
}

Using Streams

Rather than use send and recv another way you can read and write from a socket connection is to use streams.

Using the native socket we had on the last slide, we could get a stream with code like:

CFReadStreamRef readStream = NULL;
CFWriteStreamRef writeStream = NULL;

CFStreamCreatePairWithSocket(kCFAllocatorDefault, sock, &readStream, &writeStream);

Then one can use methods like: CFReadStreamOpen, CFReadStreamClose, CFReadStreamRead, CFWriteStreamOpen, CFWriteStreamClose, CFWriteStreamWrite to read and write using streams.

One can also convert CFReadStreamRef's and CFWriteStreamRef's to Objective-C objects:


NSOutputStream *networkOutputStream = (NSOutputStream *) writeStream; 
NSInputStream *networkInputStream =(NSInputStream *) readStream;

and then work in Objective-C land.

iPhone Networking

Outline