developing pgtop for android

Developing PGTop for Android

Mark [email protected]

PostgreSQL Conference West 2010

November 3, 2010

__ __

/ \~~~/ \ . o O ( Hello! )

,----( oo )

/ \__ __/

/| (\ |(

^ \ /___\ /\ |

|__| |__|-"

markwkm (PGWest 2010) Developing PGTop for Android November 3, 2010 2 / 36

Overview

Slides available at http://www.sideshare.net/markwkm

• What is PGTop for Android?

• Development environment

• Using the PostgreSQL JDBC driver


http://www.sideshare.net/markwkm

PGTop for Android

A PostgresSQL stats monitoring appfor Android (BSD License):http://github.com/markwkm/PGTop

Note: Must allow non-Market app toinstall because PGTop for Android isnot in the Market.


http://github.com/markwkm/PGTop

Main Screen


Add Database Connection


Database Statistics


Background Writer Statistics


Activity Statistics


The Development Environment

A few more details on the following slides about:

• Java (JDK, etc.)

• Android SDK

• Eclipse [optional]

Full system requirement details:http://developer.android.com/sdk/requirements.html


http://developer.android.com/sdk/requirements.html

Gentoo Linux Plug

Keep in mind I use a 64-bit Gentoo Linux.

1 The ”g” logo is a trademark of Gentoo Foundation, Inc., and that any Gentoo artwork is

copyright Gentoo Foundation, Inc.

2 The ”g” logo and Gentoo artwork are used in content that pertain to ”the Gentoo project”, as

directed by the Gentoo Foundation, Inc., and not any effort outside or beyond the authority of the

Gentoo Foundation, Inc.

3 The content, project, site, product or any other type of item with which the ”g” logo or Gentoo

artwork is associated is not part of the Gentoo project and is not directed or managed by Gentoo

Foundation, Inc.


Java Related Details

• Requires 32-bit Java 5 or 6 development kit (JDK)http://www.oracle.com/technetwork/java/javase/downloads/

• PostgreSQL JDBC3/4 Driver http://jdbc.postgresql.org version9.0-801 or later

• Apache Ant http://ant.apache.org/

Additional commentary mostly pertaining to Linux:

• This doesn’t mean it has to be a 32-bit OS

• But if you have a 64-bit OS, both 32- and 64-bit Java is needed, forbuilding and packaging respectively


http://www.oracle.com/technetwork/java/javase/downloads/

http://jdbc.postgresql.org

http://ant.apache.org/

JDBC3 vs JDBC4

The PostgreSQL JDBC driver is thread-safe. Some additional comments fromhttp://jdbc.postgresql.org/download.html:

• If you are using the 1.6 JVM, then you should use the JDBC4 version.

• JDK 1.4, 1.5 - JDBC 3. This contains support for SSL and javax.sql, butdoes not require J2EE as it has been added to the J2SE release.

• JDK 1.6 - JDBC4. Support for JDBC4 methods is limited. The driverbuilds, but the several of the new methods are stubbed out.


http://jdbc.postgresql.org/download.html

Android SDK Details

http://developer.android.com/sdk/

• Android emulator

• Android jars

• Android packaging tools


http://developer.android.com/sdk/

Eclipse Details

Optional to have Eclipse Classic 3.4 or 3.5, but must be 32-bit versionhttp://www.eclipse.org/downloads/

Advantages for using Eclipse:

• GUI designer for building the user interface

• Hides XML


http://www.eclipse.org/downloads/

Things I learned about

. . . but won’t cover here.

• Using SQLite database methods• User interface widgets

• Spinner

• TextView

• EditView

• CheckBox

• Toast

• Button

• How the threading model works, or doesn’t work with the user interface


Android Programming Examples

• Hello, World (includes example without using Eclipse)http://developer.android.com/resources/tutorials/hello-world.html

• More examples without using Eclipsehttp://developer.android.com/guide/developing/other-ide.html

• More sample applicationshttp://developer.android.com/resources/samples/


http://developer.android.com/resources/tutorials/hello-world.html

http://developer.android.com/guide/developing/other-ide.html

http://developer.android.com/resources/samples/

PostgreSQL JDBC

Now for some simple examples for connecting to a PostgreSQL database andquerying some data. Warning, code formatted to fit better on these slides. . .


Open a Database Connection

Load the PostgreSQL JDBC driver and open a database connection using SSL:

Class.forName("org.postgresql.Driver");

String url;

url = "jdbc:postgresql://pghost:5432/pgdatabase" +

"?sslfactory=org.postgresql.ssl.NonValidatingFactory" +

"&ssl=true";

Connection conn = DriverManager.getConnection(url,

"pguser",

"pgpass");

\\ Don’t forget to close the connection when you’re done.

\\ conn.close();


Execute a Query

Building on the previous slide, select the name of all relations from pg class

and iterate through every row returned:

String sql;

sql = "SELECT relname FROM pg_class WHERE relkind = ’r’;"

Statement st = conn.createStatement();

ResultSet rs = st.executeQuery(sql);

while (rs.next()) {

\\ Columns are enumerated starting with 1.

String relname = rs.getString(1);

}

rs.close();

st.close();


Execute a Query with a Bind Value

Building on the previous slide, select the number of all relations from pg class:

String sql = "SELECT COUNT(*) FROM pg_class WHERE relkind = ?;"

PreparedStatement ps = conn.createStatement();

// Bind variables are enumerated starting with 1;

ps.setString(1, "r");

ResultSet rs = ps.executeQuery(sql);

rs.next();

long count = rs.getLong(1);

rs.close();

ps.close();


More JDBC Code Examples

The PostgreSQL JDBC documentation has more examples athttp://jdbc.postgresql.org/documentation/head/


http://jdbc.postgresql.org/documentation/head/

Using cursors


Executing INSERT, UPDATE, DELETE SQL statements


Creating and modifying database objects


Calling stored functions


Handling binary data


JDBC escapes e.g. strings, outer joins, date-time, scalar functions


PostgreSQL Extensions to the JDBC API

• Geometric data types

• Large objects

• Listen/Notify

• Server prepared statements


Connection pools


Further JDBC Reading

JDBC API Documentation and JDBC Specificationhttp://jdbc.postgresql.org/documentation/head/reading.html


http://jdbc.postgresql.org/documentation/head/reading.html

Ready to debug your new app?

After the Android emulator has started the stdout/stderr messages can beviewed (I didn’t try the debugger).


__ __

/ \~~~/ \ . o O / \

,----( oo ) | Thanks to Google for providing |

/ \__ __/ | phones! |

/| (\ |( \ /

^ \ /___\ /\ |

|__| |__|-"


__ __

/ \~~~/ \ . o O ( Thank you! )

,----( oo )

/ \__ __/

/| (\ |(

^ \ /___\ /\ |

|__| |__|-"


Acknowledgements

Hayley Jane Wakenshaw

__ __

/ \~~~/ \

,----( oo )

/ \__ __/

/| (\ |(

^ \ /___\ /\ |

|__| |__|-"


License

This work is licensed under a Creative Commons Attribution 3.0 UnportedLicense. To view a copy of this license, (a) visithttp://creativecommons.org/licenses/by/3.0/us/; or, (b) send aletter to Creative Commons, 171 2nd Street, Suite 300, San Francisco,California, 94105, USA.


http://creativecommons.org/licenses/by/3.0/us/

developing pgtop for android

Technology