CSE 486586 Distributed Systems Recitation CSE 486586 Spring

CSE 486/586 Distributed Systems Recitation CSE 486/586, Spring 2012

Android Emulator Networking • Note: this is my (Steve’s) best guess; actual details might be different. But it should be good enough for your understanding. • Each emulator instance is attached to a virtual router. • The virtual router runs on top of the host (probably as an application). • The virtual router forwards connections originated from its emulator instance. • However, the virtual router acts as a firewall; it blocks all connection attempts going into its emulator instance from somewhere else. CSE 486/586, Spring 2012 2

Android Emulator Networking App App connect() emu 0 emu 1 emu 2 VR 0 VR 1 VR 2 Host • What if we want to allow others (in general) to connect to an app running inside an emulator instance? – Android provides redirection as a solution. CSE 486/586, Spring 2012 3

Android Emulator Networking • Redirection Basics – In order to allow connection attempts going into the emulator instance, we need to set up redirection from the virtual router to its emulator instance. – Since everything happens on top of the host, the only way to enable any kind of networking is to borrow the host’s IP and ports. – Redirection forces the virtual router to listen on a host port and forward all traffic coming to the host port to the emulator instance. • Process – Pick a host port to borrow (that others will use to connect to) – Set up redirection from that host port to the emulator port that the app is listening on – E. g. , redir add tcp: <host port>: <emulator port> » Meaning, forward all traffic from the host port to the emulator port CSE 486/586, Spring 2012 4

Android Emulator Networking • On emu 0: redir add tcp: 10000: 8080 App may or may not listen on 8080 (not required for redirection). App emu 0 VR 0 8080 10000 VR 0 starts listening on 10000 & forwards all traffic to emu 0’s 8080. Host CSE 486/586, Spring 2012 5

Android Emulator Networking • On emu 0: redir add tcp: 10000: 8080 App may or may not listen on 8080 (not required for redirection). App emu 0 VR 0 8080 10000 VR 0 starts listening on 10000 & forwards all traffic to emu 0’s 8080. Host For any connect() attempt to <host IP: 10000> (either from outside or from an app running on the host), it will succeed. CSE 486/586, Spring 2012 6

Android Emulator Networking • On emu 0: redir add tcp: 10000: 8080 This (port 8080) is not visible to anyone outside of VR 0. All others can only see port 10000. This is why you can use the same server port number in your app. App may or may not listen on 8080 (not required for redirection). App emu 0 VR 0 8080 10000 VR 0 starts listening on 10000 & forwards all traffic to emu 0’s 8080. Host For any connect() attempt to <host IP: 10000> (either from outside or from an app running on the host), it will succeed. CSE 486/586, Spring 2012 7

Android Emulator Networking • On emu 0: redir add tcp: 10000: 8080 • On emu 1: redir add tcp: 20000: 8080 App emu 0 VR 0 App emu 1 8080 VR 1 10000 8080 20000 Since we’re borrowing the host’s port numbers, this has to be different from VR 0’s port number. Host CSE 486/586, Spring 2012 8

Android Emulator Networking • Now all connect() should be to <host IP>: <redirected port> App emu 0 VR 0 App emu 1 8080 VR 1 10000 8080 20000 Host • E. g. , connect() to <host IP>: 10000 will be forwarded to emu 0: 8080 CSE 486/586, Spring 2012 9

Android Emulator Networking • IP Addresses – A virtual router assigns an IP address to its emulator instance (10. 0. 2. 15) and to the host (10. 0. 2. 2) from a private IP range (10. 0/8). – It assigns an IP address to the host mainly for convenience (I think…). • In the previous example, if emu 1 wants to talk to emu 0, it can use: – connect() to 10. 0. 2. 2: 10000 • Effectively, we are identifying different emulators using host port numbers we’re borrowing instead of their IP: port pairs. CSE 486/586, Spring 2012 10

Content Providers • A content provider provides a table view of data. • If you write a content provider, any client application with the permission can enter/read/update/delete data items in your content provider. • A client application (that uses your content provider) uses Content. Resolver to interact with your content provider. • You need to extend Content. Provider and implement necessary methods. CSE 486/586, Spring 2012 11

How a Client Interacts • Table identification URI (android. net. Uri) – E. g. , content: //user_dictionary/words • Insert – public final Uri Content. Resolver. insert (Uri url, Content. Values values) • Update – public final int Content. Resolver. update (Uri uri, Content. Values values, String where, String[] selection. Args) • Query – public final Cursor Content. Resolver. query (Uri uri, String[] projection, String selection, String[] selection. Args, String sort. Order) • Delete – public final int Content. Resolver. delete (Uri url, String where, String[] selection. Args) CSE 486/586, Spring 2012 12

How to Write a Content Provider 1. 2. 3. 4. 5. Declare in Android. Manifest. xml Define a URI that client apps will use Define permissions Implement necessary methods in Content. Provider When implementing Content. Provider, use either the Android file system or SQLite as the actual data storage. CSE 486/586, Spring 2012 13

Declare in Android. Manifest. xml <manifest. . . >. . . <application. . . > <provider android: name=". Example. Provider" />. . . </application> </manifest> CSE 486/586, Spring 2012 14

Defining a URI • Typical format – content: //<authority>/<table name> – Authority: a global (Android-wide) name for the provider » E. g. , edu. buffalo. cse 486. proj 1. provider – Table name: the name of a table that the provider exposes » Note: a provider can expose more than one table. • Should be added to Android. Manifest. xml – E. g. , <provider android: authorities=“edu. buffalo. cse 486. proj 1. provider” …>…</provider> CSE 486/586, Spring 2012 15

Define Permissions • Should define permissions (for others) in Android. Manifest. xml • android: permission: Single provider-wide read/write permission. – E. g. , <provider android: permission=“edu. buffalo. cse 486. proj 1. provider. permission. USE_PROJ 1_PROVIDER” …>…</provider> • android: read. Permission: Provider-wide read permission. • android: write. Permission: Provider-wide write permission. CSE 486/586, Spring 2012 16

Necessary Methods • query() – Retrieve data from your provider. • insert() – Insert a new row into your provider. • update() – Update existing rows in your provider. • delete() – Delete rows from your provider. • get. Type() – Return the MIME type corresponding to a content URI. • on. Create() – Initialize your provider. The Android system calls this method immediately after it creates your provider. Notice that your provider is not created until a Content. Resolver object tries to access it. • These need to handle concurrent accesses (need to be thread-safe) CSE 486/586, Spring 2012 17

Storage Options • • Internal storage: file system, private to the app External storage: file system, open to everybody SQLite: database, private to the app Read: http: //developer. android. com/guide/topics/datastorage. html CSE 486/586, Spring 2012 18

Internal Storage • Saving files directly on the device's internal storage. • User uninstallation files are removed. • To create and write a private file to the internal storage: – Call open. File. Output() with the name of the file and the operating mode. This returns a File. Output. Stream. – Write to the file with write(). – Close the stream with close(). • E. g. , String FILENAME = "hello_file"; String string = "hello world!”; File. Output. Stream fos = open. File. Output(FILENAME, Context. MODE_PRIVATE); fos. write(string. get. Bytes()); fos. close(); CSE 486/586, Spring 2012 19

Internal Storage • MODE_PRIVATE create the file (or replace a file of the same name) and make it private to your application. • Other modes available are: – MODE_APPEND, MODE_WORLD_READABLE, and MODE_WORLD_WRITEABLE. • To read a file from internal storage: – Call open. File. Input() and pass it the name of the file to read. This returns a File. Input. Stream. – Read bytes from the file with read(). – Then close the stream with close(). CSE 486/586, Spring 2012 20

External Storage • Shared "external storage” – E. g. , a removable storage media (such as an SD card) or an internal (non-removable) storage. • Files saved to the external storage are: – World-readable – Can be modified by the user when they enable USB mass storage to transfer files on a computer. • Checking media availability – Before you do any work with the external storage, you should always call get. External. Storage. State() to check whether the media is available. CSE 486/586, Spring 2012 21

External Storage • Accessing files on external storage (API Level 8 or greater) – Use get. External. Files. Dir() to open a File that represents the external storage directory where you should save your files. – This method takes a type parameter that specifies the type of subdirectory you want, such as DIRECTORY_MUSIC and DIRECTORY_RINGTONES (pass null to receive the root of your application's file directory). This method will create the appropriate directory if necessary. – If the user uninstalls your application, this directory and all its contents will be deleted. CSE 486/586, Spring 2012 22

External Storage • Saving files that should be shared – For files not specific to your application and that should not be deleted when your application is uninstalled – Save them to one of the public directories on the external storage. – These directories lay at the root of the external storage, such as Music/, Pictures/, Ringtones/, and others. • (API Level 8 or greater) – Use get. External. Storage. Public. Directory(), passing it the type of public directory you want, such as DIRECTORY_MUSIC, DIRECTORY_PICTURES, DIRECTORY_RINGTONES, or others. This method will create the appropriate directory if necessary. CSE 486/586, Spring 2012 23

Services • A service runs in the background with no UI for longrunning operations. – Playing music, sending/receiving network messages, … – Subclass of android. app. Service • Started service – A service is "started" when an application component (such as an activity) starts it by calling start. Service(). Once started, a service can run in the background indefinitely, even if the component that started it is destroyed. • Bound service – A service is "bound" when an application component binds to it by calling bind. Service(). A bound service offers a clientserver interface that allows components to interact with the service, send requests, get results, and even do so across processes with interprocess communication (IPC). CSE 486/586, Spring 2012 24

How to Write a Service • Declare in Android. Manifest. xml • Implement necessary methods in Service CSE 486/586, Spring 2012 25

Declare in Android. Manifest. xml <manifest. . . >. . . <application. . . > <service android: name=". Example. Service" />. . . </application> </manifest> CSE 486/586, Spring 2012 26

Necessary Methods • on. Start. Command() – The system calls this method when another component, such as an activity, requests that the service be started, by calling start. Service(). • on. Bind() – The system calls this method when another component wants to bind with the service (such as to perform RPC), by calling bind. Service(). • on. Create() – The system calls this method when the service is first created, to perform one-time setup procedures (before it calls either on. Start. Command() or on. Bind()). • on. Destroy() – The system calls this method when the service is no longer used and is being destroyed. CSE 486/586, Spring 2012 27

Service Lifecycle CSE 486/586, Spring 2012 28