" >
当前页面: 开发资料首页 → J2ME 专题 → 高可靠性移动应用程序-移动数据库和J2ME工具(二) 内容: 翻译作者:jungleguo 2003-11-15
原文: http://www.javaworld.com/javaworld/jw-06-2003/jw-0606-wireless-p2.html
一个应用程序例子
现在通过一个简单的例子,我们检测一下移动数据库应用程序的典型用法和关键组件。
移动联系管理器
这是一个由PointBase提供的移动联系管理器的例子。联系管理器 contact manager包括在PointBase 4.x中。为了读者方便,我已经把源代码打包成zip文件放在Resource中。如果你想编译和运行例子,你必须先从PointBase处下载适当的jar文件。
这个应用程序本身比较简单。它主要沿用了高级地址本应用程序的通用特性。例如,它允许用户存储联系人名字,地址和电话号码;提供自觉浏览和搜索接口;和后台数据库服务器同步。图1和图2分别显示了该应用程序在标准模式和同步模式下的操作。这些屏幕快照来自一个由Insignia’s Jeode PersonalJava VM驱动的Pocket PC 和一个由J2SE驱动的Mac OS X 膝上型电脑。相同字节代码的应用程序没有经过修改运行在许多平台上,证明了Java的威力。
图1 在袖珍PC Jeode PersonalJava上的标准联系管理器
图2 在Mac OS X上的两个同步的联系管理器spoke
客户端应用程序UI(用户界面)是用AWT写的。这是被PersonalJava或J2ME/FP/PP设备所支持的唯一标准UI库。除了这些UI驱动,我们还有另一个代码层,它提供访问一般的设备上JDBC数据库。这个数据库访问层也提供了与后台服务器同步移动数据的逻辑,它是通过PointBase专有UniSync同步服务器来实现的。现在我们来看看数据访问层的代码,它包括在一个单独的类:DBManager.
设备上的数据访问
类DBManager是一个单独的类,它提供从应用程序单点访问数据。这个单独模式避免了嵌入式数据库的线程复杂性。下面的代码片断显示了DBManager的构造器和初始化的代码。它连接数据库,定义表,将测试数据导入表中,创建为以后时候的SQL状态模版(PreparedStatement)。正如我们所看到的,这里用到的都是标准JDBC。对于企业Java 开发者下面的代码应该很容易明白:
例1 连接移动数据库和初始化访问对象
<table style="TABLE-LAYOUT: fixed" cellSpacing=0 borderColorDark=#ffffff cellPadding=4 width="98%" align=center bgColor=#e6e6e6 borderColorLight=#009ace border=1>
<tr>
<td style="WORD-WRAP: break-word">class DBManager {
// DBManager is a singleton class.
private static DBManager instance;
private String driver;
private String url;
private String user;
private String password;
private boolean delay;
private Connection connection;
private Statement statement;
private PreparedStatement insert;
private PreparedStatement find;
private PreparedStatement delete;
private PreparedStatement update;
private PreparedStatement all;
static DBManager getInstance() {
if (instance == null) {
instance = new DBManager();
}
return instance;
}
private DBManager() {
// Get parameters from runtime properties.
// This allows us to switch to different JDBC databases
// without changing the application code.
Properties properties = ContactManager.getProperties();
driver =
properties.getProperty("driver", "com.pointbase.me.jdbc.jdbcDriver");
url =
properties.getProperty("url", "jdbc:pointbase:micro:pbdemo");
user =
properties.getProperty("user", "PBPUBLIC");
password =
properties.getProperty("password", "PBPUBLIC");
delay =
properties.getProperty("delayread","true").equals("true");
connect();
}
private void connect() {
try {
// Load the driver class.
Class.forName(driver);
// If the database doesn't exist, create a new database.
connection = DriverManager.getConnection(url, user, password);
// Create template statement objects.
statement = connection.createStatement();
createStatement();
// If the database is newly created, load the schema.
boolean newdb=initDatabase();
// Load sample data for the new tables.
if(newdb) {
SampleDataCreator.insert(connection);
}
} catch (Exception e) {
e.printStackTrace();
System.exit(1);
}
}
void disconnect() {
try {
connection.commit();
statement.close();
insert.close();
find.close();
delete.close();
update.close();
all.close();
connection.close();
System.exit(0);
} catch (Exception e) {
e.printStackTrace();
System.exit(1);
}
}
// Create the table and load the schema.
private boolean initDatabase() {
try {
String sql = "CREATE TABLE NameCard (ID INT PRIMARY KEY, "+
"Name VARCHAR(254), Company VARCHAR(254), Title VARCHAR(254), "+
"Address1 VARCHAR(254), Address2 VARCHAR(254), "+
"Phone VARCHAR(254), Email VARCHAR(254), "+
"Picture Binary(1000000))";
// If the table already exists, this will throw an exception.
statement.executeUpdate(sql);
// This means the database already exists.
return true;
} catch (SQLException e) {
// Ignore the error - the table already exists, which is good
// so we don't need to add demo data later on.
return false;
}
}
// Create statement templates.
private void createStatement() {
try {
insert = connection.prepareStatement(
"INSERT INTO NameCard (ID, Name, Company, Title, Address1, "+
"Address2, Phone, Email, Picture) "+
"valueS (?, ?, ?, ?, ?, ?, ?, ?, ?)");
find = connection.prepareStatement(
"SELECT * FROM NameCard WHERE (Name LIKE ?) "+
"AND (Company LIKE ?) AND (Title LIKE ?) "+
"AND ((Address1 LIKE ?) OR (Address2 LIKE ?)) "+
"AND (Phone LIKE ?) AND (Email LIKE ?)");
delete = connection.prepareStatement(
"DELETE FROM NameCard WHERE ID = ?");
update = connection.prepareStatement(
"UPDATE NameCard SET ID=?, Name=?, Company=?, Title=?, "+
"Address1=?, Address2=?, Phone=?, Email=?, Picture=? "+
"WHERE ID = ?");
all = connection.prepareStatement(
"SELECT ID, Name, Company, Title, Address1, Address2, "+
"Phone, Email FROM NameCard");
} catch (SQLException e) {
e.printStackTrace();
}
}
// Other methods.
}</td></tr></table>在DBManager中的其他方法通过简单JDBC API调用进行访问数据库。如下的代码片断展示了搜索和操纵名称卡片记录的方法。这些方法使用了我们之前定义的SQL模版。
例2 数据访问方法
<table style="TABLE-LAYOUT: fixed" cellSpacing=0 borderColorDark=#ffffff cellPadding=4 width="98%" align=center bgColor=#e6e6e6 borderColorLight=#009ace border=1>
<tr>
<td style="WORD-WRAP: break-word">Vector findNameCardsByKeyword(String name, String company,
String title, String address1, String address2,
String phone, String email) {
Vector NameCards = new Vector();
String[] keywords = {name, company, title, address1, address2,
phone, email};
try {
for (int i = 0; i < keywords.length; i++) {
String criteria = (keywords[i].equals("")) ? "%" :
"%" + keywords[i] + "%";
find.setString(i + 1, criteria);
}
ResultSet resultSet = find.executeQuery();
while (resultSet.next()) {
NameCard nameCard = new NameCard(resultSet.getInt(1),
resultSet.getString(2), resultSet.getString(3),
resultSet.getString(4), resultSet.getString(5),
resultSet.getString(6),
resultSet.getString(7), resultSet.getString(8));
if (!delay)
loadPicture(nameCard);
NameCards.addElement(nameCard);
}
} catch (SQLException e) {
e.printStackTrace();
}
return NameCards;
}
void addNameCard(NameCard nameCard) {
nameCard.setID(getNewID());
try {
insert.setInt(1, nameCard.getID());
insert.setString(2, nameCard.getName());
insert.setString(3, nameCard.getCompany());
insert.setString(4, nameCard.getTitle());
insert.setString(5, nameCard.getAddress1());
insert.setString(6, nameCard.getAddress2());
insert.setString(7, nameCard.getPhone());
insert.setString(8, nameCard.getEmail());
insert.setBytes(9, nameCard.getPicture().getBytes());
insert.executeUpdate();
} catch (SQLException e) {
e.printStackTrace();
}
}
void updateNameCard(NameCard nameCard) {
try {
update.setInt(1, nameCard.getID());
update.setString(2, nameCard.getName());
update.setString(3, nameCard.getCompany());
update.setString(4, nameCard.getTitle());
update.setString(5, nameCard.getAddress1());
update.setString(6, nameCard.getAddress2());
update.setString(7, nameCard.getPhone());
update.setString(8, nameCard.getEmail());
update.setBytes(9, nameCard.getPicture().getBytes());
update.setInt(10, nameCard.getID());
update.executeUpdate();
} catch (SQLException e) {
e.printStackTrace();
}
}
void deleteNameCard(NameCard nameCard) {
try {
delete.setInt(1, nameCard.getID());
delete.executeUpdate();
} catch (SQLException e) {
e.printStackTrace();
}
}
void loadPicture(NameCard nameCard) {
try {
ResultSet resultSet =
statement.executeQuery(
"SELECT Picture FROM NameCard WHERE ID = " +
nameCard.getID());
resultSet.next();
Picture picture = new Picture();
picture.setBytes(resultSet.getBytes(1));
nameCard.setPicture(picture);
} catch (SQLException e) {
e.printStackTrace();
}
}
private int getNewID() {
try {
ResultSet resultSet = statement.executeQuery(
"SELECT MAX(ID)+1 FROM NameCard");
if (resultSet.next()) {
return resultSet.getInt(1);
} else {
return 0;
}
} catch (Exception e) {
e.printStackTrace();
}
return 0;
}</td></tr></table>与后台数据库同步
类DBManager也允许应用程序开发者用PointBase 专有UniSync引擎与后台数据库同步移动数据。不同的厂商使用不同的同步引擎,但他们的概念都是相类似的。同步过程按照如下这些步骤进行:
1. 在后台服务器和移动设备上创建相应的数据库和表
2. 在同步服务器上创建一个hub。这个hub包含发布信息。它指定和标识用于同步(发布)的后台表(或部分表)。
3. 使用hub来创建spoke。spoke是在同步服务器上表示移动设备的对象。每个spoke都有一个ID。它能通过在同一个hub里的订阅对象来订阅发布。通过使用一个spokeID,移动设备匹配spoke并对订阅的后台表进行同步。
4. 启动同步服务器。基本上通过com.pointbase.me.sync.Server 类的main()方法来执行。这个服务器类用于PointBase 发布包。还有其他几个方法在不同环境中运行服务器。您可以参考PointBase文档来得到更多的细节和例子。默认情况下,服务器监听端口8124。
5. 使用一个spokeID和在移动设备上的类 spoke stub 来初始化同步过程。
图3 UniSync同步服务器框架图解
例3 中的类ResetServer显示了在UniSync服务器上如何创建hub和spoke:
例3 安装同步服务器
<table style="TABLE-LAYOUT: fixed" cellSpacing=0 borderColorDark=#ffffff cellPadding=4 width="98%" align=center bgColor=#e6e6e6 borderColorLight=#009ace border=1>
<tr>
<td style="WORD-WRAP: break-word">manager=SyncManager.getInstance(caturl,catdriver,catuser,catpassword);
String dsname;
dsname=SyncDataSource.DEFAULT;
String hubname="Hub";
Hub hub=manager.createHub(hubname);
Publication pub;
String pubname;
SpokeConfig spoke;
Subscription sub;
String subname="SubNameCard";
String tablename="NAMECARD";
String[] tables=new String[]{tablename};
// Publish the complete name-card table
pubname="PubNameCard";
pub=hub.newPublication(pubname,dsname,tables);
hub.publish(pub);
// Create two spokes and subscribe to this publication
for(int i=1;i<=2;i++) {
String name="Spoke"+i;
spoke=hub.createSpokeConfig(name);
spoke.savePassword("pass"+i);
sub=spoke.newSubscription(subname,SyncDataSource.DEFAULT,pubname);
spoke.subscribe(sub);
}
// Publish the name-card table without the picture column
pubname="PubNameCardNoPicture";
pub=hub.newPublication(pubname,dsname,tables);
SyncTable table=pub.getSyncTable(tablename);
table.dropSyncColumns(new String[]{"PICTURE"});
hub.publish(pub);
// Create two spokes and subscribe to this publication
for(int i=3;i<=4;i++) {
String name="Spoke"+i;
spoke=hub.createSpokeConfig(name);
spoke.savePassword("pass"+i);
sub=spoke.newSubscription(subname,SyncDataSource.DEFAULT,pubname);
spoke.subscribe(sub);
}
manager.close();</td></tr></table>下面的DBManager代码片断显示了如何获得spoke stub 和如何在设备上处理同步。代码中的注释解释了应用程序的同步和独立版本的不同:
例4 通过同步服务器访问数据
<table style="TABLE-LAYOUT: fixed" cellSpacing=0 borderColorDark=#ffffff cellPadding=4 width="98%" align=center bgColor=#e6e6e6 borderColorLight=#009ace border=1>
<tr>
<td style="WORD-WRAP: break-word">// Import proprietary classes for sync
import com.pointbase.me.jdbc.*;
class DBManager {
// In addition to JDBC connection variables,
// we also need to define variables for sync
// ... ...
private Spoke spoke;
private String spokename;
private int spoke_id;
private int spoke_range_start,spoke_range_end;
final static int ROWS_PER_SPOKE=1<<16;
private String syncurl;
private String syncpassword;
private DBManager() {
// Get DB connection parameters
// ... ...
// Get sync parameters
syncurl =
properties.getProperty("syncurl", "http://localhost:8124";);
String spokeid =
properties.getProperty("spokeid", "1");
spokename =
properties.getProperty("spoke", "Spoke"+spokeid);
syncpassword =
properties.getProperty("syncpassword", "pass"+spokeid);
url =
properties.getProperty("url",
"jdbc:pointbase:micro:pbdemo"+spokeid);
connect();
}
// The complete connect method using synchronization server
private void connect() {
try {
System.out.println("Connecting to the database...");
Class.forName(driver);
// If the database doesn't exist, create a new database
connection = DriverManager.getConnection(url, user, password);
statement = connection.createStatement();
// Check sync metadata and create tables
loadMeta();
// Create prepared statements
createStatement();
} catch (Exception e) {
e.printStackTrace();
System.exit(1);
}
}
// The complete newID method using the sync server
private int getNewID() {
try {
ResultSet rs = statement.executeQuery(
"SELECT MAX(ID)+1 FROM NameCard WHERE "+
"ID>="+spoke_range_start+" AND ID<"+spoke_range_end);
rs.next();
int id=rs.getInt(1);
if(rs.wasNull()) {
return spoke_range_start;
} else {
return id;
}
} catch (Exception e) {
e.printStackTrace();
}
return 0;
}
// Create table and load metadata from the sync hub
void loadMeta() {
try {
SyncManager manager=SyncManager.getInstance(connection);
spoke=manager.getSpoke(spokename);
if(spoke==null) {
System.out.println(
"Loading MetaData from url "+syncurl+
" for spoke "+spokename+
" using password "+syncpassword);
spoke=manager.createSpoke(spokename);
spoke.savePassword(syncpassword);
spoke.saveHubURL(syncurl);
spoke.loadConfig();
spoke.getSnapshot();
}
spoke_id = spoke.getSpokeId();
System.out.println("SpokeID is "+spoke_id);
spoke_range_start = ROWS_PER_SPOKE * spoke_id;
spoke_range_end = spoke_range_start + ROWS_PER_SPOKE - 1;
} catch (SyncException e) {
e.printStackTrace();
}
}
// Synchronize spoke databases (mobile databases) with the hub
// and backend databases
void sync() {
try {
spoke.sync();
} catch (SyncException e) {
e.printStackTrace();
}
}
// Other data access methods are the same as the non-synced version.
}</td></tr></table>
摘要: