Đây là bộ tài liệu tìm hiểu và hướng dẫn lập trình ứng dụng JAVA cho Blackberry.
Đầu tiên là cuốn “Beginning Blackberry Development – Apress”. Theo đánh giá của mình, cuốn này khá hay và bổ ích cho newbie
Thứ hai là cuốn “Advance Blackberry Development – Apress”. Sau khi đọc cuốn Begining bạn nên đọc cuốn này. Đây là phần nâng cao của Begining.
Lưu trữ dữ liệu là một phần khác quan trọng trong các ứng dụng bao gồm các ứng dụng desktop, web hay mobile.
Có rất nhiều cách để lưu trữ dữ liệu trên ứng dụng Blackberry như:
Các API BlackBerry bao gồm một framework phong phú để xây dựng giao diện người dùng cho các ứng dụng. Trong bài này, chúng ta cùng tìm hiểu cách sử dụng các thành phần giao diện người dùng BlackBerry để xây dựng một ứng dụng với một vài màn hình và một số điều khiển để đáp ứng với input của người dùng.
Tất cả các phần tử trực quan(visible) có thể hiển thị trên màn hình của Blackberry là một trong 3 kiểu sau:
Fields được dẫn xuất từ net.rim.device.api.ui.Field. Có rất nhiều Field dựng sẵn hữu ích trong gói net.rim.device.api.ui.component.
Managers được dẫn xuất từ gói net.rim.device.api.ui.Manager, nó kế thừa từ lớp net.rim.device.api.ui.Field. Một số manager hữu ích được định nghĩa trong gói net.rim.device.api.ui.container.
Sreens được dẫn xuất từ gói net.rim.device.api.ui.Screen, nó kế thừa từ lớp Manager. Có một số screen hữu ích trong gói net.rim.device.api.ui.container.
Lưu ý Mặc dù Screen kế thừa từ Field, nhưng bạn không thể thêm một Screen vào một Manager.
Giao diện mà chúng ta sẽ xây dựng như hình vẽ sau:
Bây giờ, ta tạo ra một project UiFun, sau đó tạo ra một package blog.mobileprogramming.uifun; tiếp theo tạo 2 lớp UiFunApplication và UiFunMainScreen.
package blog.mobileprogramming.uifun;
import net.rim.device.api.ui.UiApplication;
public class UiFunApplication extends UiApplication {
public UiFunApplication() {
UiFunMainScreen mainScreen = new UiFunMainScreen();
pushScreen(mainScreen);
}
public static void main(String[] args) {
UiFunApplication app = new UiFunApplication();
app.enterEventDispatcher();
}
}
package blog.mobileprogramming.uifun;
import net.rim.device.api.ui.container.MainScreen;
public class UiFunMainScreen extends MainScreen {
public UiFunMainScreen() {
}
}
Đầu tiên, ta thêm một thể hiện net.rim.device.api.ui.component.BitmapField thể show image lên đỉnh màn hình. Các thiết bị Blackberry có thể hiển thị các hình ảnh PNG, JPEG hay GIF, tuy nhiên hầu hết các ứng dụng sử dụng PNGs bởi chúng có kích thước nhỏ, chất lượng cao và hỗ trợ transparent.
Nếu bạn sử dụng JDE Plugin for Eclipse, thêm image vào project Eclipse bằng cách tạo một folder “res”cùng cấp với folder “src”.
Tạo một thể hiện BitmapField để thêm vào Screen, trước khi tạo ra thể hiện này, tạo một đối tượng Bitmap để load image từ resource của project.
Bitmap logoBitmap = Bitmap.getBitmapResource(“res/apress_log.png”);
Trong Constructor của lớp UiFunApplication, ta làm như sau:
package blog.mobileprogramming.uifun;
import net.rim.device.api.system.Bitmap;
import net.rim.device.api.ui.Field;
import net.rim.device.api.ui.component.BitmapField;
import net.rim.device.api.ui.container.MainScreen;
public class UiFunMainScreen extends MainScreen {
BitmapField bitmapField;
public UiFunMainScreen() {
Bitmap logoBitmap = Bitmap.getBitmapResource(“res/apress_logo.png”);
bitmapField = new BitmapField(logoBitmap, Field.FIELD_HCENTER);
add(bitmapField);
}
}
Bây giờ, nếu bạn chạy ứng dụng sẽ cho giao diện như sau:
Hầu như tất cả các Field và Manager đều có một constructor mà có chứa tham số style. Style được đánh dấu bởi các flags style, mỗi style sẽ được sử dụng kết hợp với nhau bởi toán tử “|”. Flags được định nghĩa trong API, mỗi style sẽ có tác động nhất định đến Field hoặc Manage, chẳng hạn như nó quy định vị trí, hành vi…
Ta sẽ sử dụng lớp EditField để thiết lập usename, PasswordEditField để thiết lập password. Chúng ta không cần sử dụng style đặc biệt cho các Field này.
EditField usernameField;
PasswordEditField passwordField;
…
usernameField = new EditField(“Username:”, “”);
passwordField = new PasswordEditField(“Password:”, “”);
add(usernameField);
add(passwordField);
Tạo domain nên sử dụng drop-down list, trong Blackberry API, một giao diện net.rim.device.api.ui.component.ChoiceField sử dụng tương tự như một drop-down list. Bạn có thể thực thi gian diện này một cách trực tiếp, nhưng trong ví dụ này, ta chỉ sử dụng một component thực thi giao diện này, đó là net.rim.device.api.ui.component.
ObjectChoiceField, nếu bạn muốn list các số, sử dụng net.rim.device.api.ui.component.
NumericChoiceField để thay thế.
ObjectChoiceField domainField;
CheckboxField rememberCheckbox;
…
domainField = new ObjectChoiceField(“Domain:”, new String[] {“Home”, “Work”});
add(domainField);
rememberCheckbox = new CheckboxField(“Remember password”, false);
add(rememberCheckbox);
Để tạo 2 button Clear và Login, ta tạo ra 2 thể hiện từ lớp ButtonField, đồng thời gán vào style là ButtonField.CONSUME_CLICK. Nếu không sử dụng style này, thì sự kiện click sẽ được truyền vào Screen, một menu sẽ được bật lên khi người dùng click vào button, mặc dù button vẫn làm cho action này thực hiện.
BitmapField bitmapField;
EditField usernameField;
clearButton = new ButtonField(“Clear”, ButtonField.CONSUME_CLICK);
loginButton = new ButtonField(“Login”, ButtonField.CONSUME_CLICK);
add(clearButton);
add(loginButton);
Tóm lại, code sau khi thêm các thành phần giao diện trong lớp UiFunMainScreen như sau:
package blog.mobilesprogramming.uifun;
import net.rim.device.api.system.Bitmap;
import net.rim.device.api.ui.Field;
import net.rim.device.api.ui.component.BitmapField;
import net.rim.device.api.ui.component.ButtonField;
import net.rim.device.api.ui.component.CheckboxField;
import net.rim.device.api.ui.component.EditField;
import net.rim.device.api.ui.component.ObjectChoiceField;
import net.rim.device.api.ui.component.PasswordEditField;
import net.rim.device.api.ui.container.MainScreen;
public class UiFunMainScreen extends MainScreen {
BitmapField bitmapField;
EditField usernameField;
PasswordEditField passwordField;
ObjectChoiceField domainField;
CheckboxField rememberCheckbox;
ButtonField clearButton;
ButtonField loginButton;
public UiFunMainScreen() {
Bitmap logoBitmap = Bitmap.getBitmapResource(“res/apress_logo.png”);
bitmapField = new BitmapField(logoBitmap, Field.FIELD_HCENTER);
add(bitmapField);
usernameField = new EditField(“Username:”, “”);
passwordField = new PasswordEditField(“Password:”, “”);
add(usernameField);
add(passwordField);
domainField = new ObjectChoiceField(“Domain:”, new String[] { “Home”,”Work” });
add(domainField);
rememberCheckbox = new CheckboxField(“Remember password”, false);
add(rememberCheckbox);
clearButton = new ButtonField(“Clear”,ButtonField.CONSUME_CLICK);
loginButton = new ButtonField(“Login”,ButtonField.CONSUME_CLICK);
add(clearButton);
add(loginButton);
}
}
Bây giờ, nếu bạn chạy ứng dụng sẽ như hình vẽ sau:
Lớp UiFunMainScreen trong ví dụ này kế thừa từ MainScreen, nên nó có một trình quản lý layout mặc định là VerticalFieldManager để quản lý các Field. Khi thêm bất kỳ Field nào vào ứng dụng, trình quản lý này sẽ sắp xếp các Field theo chiều dọc. Tuy nhiên trong ví dụ này, ta muốn một số thành phần được sắp xếp theo chiều dọc, riêng các Button thì sẽ sắp xếp theo chiều ngang; để làm được như vậy, chúng ta sẽ sử dụng HorizonetalFieldManager với style là Field.FIELD_RIGHT(canh bên phải) để đẩy các Button vào màn hình.
HorizontalFieldManager buttonManager = new HorizontalFieldManager(Field.FIELD_RIGHT);
buttonManager.add(clearButton);
buttonManager.add(loginButton);
add(buttonManager);
Ngoài ra, ta sẽ sử dụng thêm một đối tượng SeparatorField để vẽ một thanh chắn ngang bên dưới image với các Field của ứng dụng.
Bitmap logoBitmap = Bitmap.getBitmapResource(“res/apress_logo.png”);
bitmapField = new BitmapField(logoBitmap, Field.FIELD_HCENTER);
add(bitmapField);
add(new SeparatorField());
add(new LabelField(“Please enter your credentials:”));
usernameField = new EditField(“Username:”, “”);
passwordField = new PasswordEditField(“Password:”, “”);
add(usernameField);
add(passwordField);
domainField = new ObjectChoiceField(“Domain:”, new String[] {“Home”, “Work”});
add(domainField);
rememberCheckbox = new CheckboxField(“Remember password:”, false);
add(rememberCheckbox);
add(new SeparatorField());
clearButton = new ButtonField(“Clear”, ButtonField.CONSUME_CLICK);
loginButton = new ButtonField(“Login”, ButtonField.CONSUME_CLICK);
HorizontalFieldManager buttonManager =
new HorizontalFieldManager(Field.FIELD_RIGHT);
buttonManager.add(clearButton);
buttonManager.add(loginButton);
add(buttonManager);
Bây giờ, nếu bạn chạy đoạn code trên, nó sẽ như hình vẽ sau:
Bài viết liên quan:
Lập trình với BlackBerry – Phần 1
Đang update các source demo cho các bạn, sẽ cập nhật trong thời gian sớm nhất!
Nguồn tham khảo: mobileprograming Blog và Beginning_BlackBerry_Development
Một ứng dụng thường bắt đầu theo một trong 3 cách sau:
Trong mọi trường hợp, phương thức main là một entry point đầu tiên của ứng dụng. Các thiết bị Blackberry sẽ tạo một tiến trình để gọi phương thức main. Khi phương thức main exit, tiến trình cũng kết thúc và ứng dụng exit. Điều này có nghĩa rằng, nếu bạn muốn ứng dụng làm bất cứ điều gì, bạn sẽ làm điều đó trong phương thức main.
Phương thức main nhận một mảng các đối tượng String làm tham số. Thông thường, mảng này empty, nhưng các tham số có thể được gán nếu bạn định nghĩa chúng trong properties project hay nếu chúng được gán bởi một tiến trình khác mà tiến trình này start ứng dụng.
HelloWorldApp helloWorld = (HelloWorldApp)UiApplication.getUiApplication();
Ứng dụng này đáp ứng các sự kiện nhập vào bàn phím, trackball, hoặc chuyển động màn hình cảm ứng và nhấp chuột và các sự kiện khác như thông điệp hệ thống.
Nói chung, một ứng dụng BlackBerry exit khi màn hình cuối cùng được remove từ display stack (bằng cách đóng nó). Bạn có thể gọi phương thức System.exit() để thoát khỏi ứng dụng, nhưng cách này được khuyến nghị nên tránh và nên clean up ứng dụng đang tồn tại bằng cách đóng tất cả các màn hình. Khi thoát ứng dụng, tất cả các trạng thái ứng dụng sẽ được clean up, và lần tiếp theo nếu người dùng nhấp vào icon của ứng dụng thì phương thức main sẽ được gọi trở lại với một tiến trình mới.
BlackBerry UI API là đơn luồng(single-thread). Điều này có nghĩa rằng tất cả các thông tin cập nhật giao diện người dùng và sự kiện được xử lý bởi cùng một thread, hay chính xác hơn, phải được thực hiện trong khi giữ khóa sự kiện, mà hầu hết thời gian được tổ chức bởi thread UI. Nó có một vài tác động đối với các ứng dụng BlackBerry: các thread khác không thể truy cập trực tiếp vào UI mà không đạt được khóa sự kiện một cách rõ ràng(một ngoại lệ sẽ được ném ra nếu bạn cố gắng), và nếu bạn thực hiện một hoạt động trên event thread mà nó chiếm nhiều thời gian, toàn bộ giao diện người dùng sẽ tạm dừng trong khi hoạt động đó đang diễn ra.
Bạn luôn luôn có thể nhận biết nếu code của bạn đang được thực hiện bởi event thread bằng cách gọi phương thức UiApplication.isEventDispatchThread(). Tuy nhiên, thông thường chúng ta không gọi phương thức này. Một nguyên tắc nhỏ để nhận biết ứng dụng đang làm việc trên event thread:
Tất nhiên, có nhiều khi bạn muốn một sự kiện trong thread khác để được phản ánh(reflect) trong UI, ví dụ tạo một thread để xử lý quá trình download file. Để làm điều đó, có một vài phương pháp.
Lưu ý Cả hai phương thức invokeLater() và invokeAndWait() cùng hoạt động như nhau – đó là đưa vào hàng đợi một thể hiện của java.lang.Runnable để được thực thi trên event thread. Sự khác biệt là invokeLater() trả về ngay lập tức, trong khi invokeAndWait() không trả lại cho đến khi phương thức run() của Runnable đã kết thức việc thực thi, và do đó, block thread gọi nó.
Đầu tiên, thay thế biến cục bộ labelField thành một biến thành viên, sau đó thêm một phương thức appendLabelText().
public class HelloWorldMainScreen extends MainScreen {
private LabelField labelField;
public HelloWorldMainScreen() {
labelField = new LabelField(“Hello World”);
add(labelField);
}
public void appendLabelText(String text) {
labelField.setText(labelField.getText() + “\n” + text);
}
}
Bởi vì phương thức appendLabelText() gọi phương thức LabelField.setText(), lời gọi này chỉ có thể được thực hiện event thread. Nếu bạn cố gắng gọi phương thức này trực từ thread khác, một ngoại lệ sẽ được ném.
Bây giờ, chúng ta sẽ tạo một lớp MainScreenUpdaterThread kế thừa từ Thread để thực hiện công việc cập nhật. Nó sẽ lặp từ 1 đến 10. Mỗi lần lặp, nó sẽ đợi 5 giây và sau đó thêm một đoạn text và LabelField.
package blog.mobileprogramming;
import net.rim.device.api.ui.UiApplication;
public class MainScreenUpdaterThread extends Thread {
HelloWorldMainScreen mainScreen;
public MainScreenUpdaterThread(HelloWorldMainScreen mainScreen) {
this.mainScreen = mainScreen;
}
public void run() {
for (int i = 0; i < 10; i++) {
try {
Thread.sleep(5000);
} catch (InterruptedException ex) {
}
// Queue a new task on the event thread
UiApplication.getUiApplication().invokeLater(new Runnable() {
public void run() {
mainScreen.appendLabelText(“Update”);
}
});
}
}
}
Để cập nhật thực sự UI, chúng ta sử dụng lớp nội bộ vô danh(anonymous inner class), đó là lớp mà chúng ta định nghĩa tại thời điểm khởi tạo nó. Lớp vô danh này gọi một phương thức mà cần được gọi trên event thread, đó là phương thức appendLabelText().
Bây giờ, trong constructor của HelloWorldMainScreen, chúng ta thực hiện như sau:
public HelloWorldMainScreen() {
labelField = new LabelField(“Hello World”);
add(labelField);
MainScreenUpdaterThread thread = new MainScreenUpdaterThread(this);
thread.start();
}
Cuối cùng là ta chạy ứng dụng, out put của nó như hình sau đây:
Chúng ta sẽ sử dụng một phương pháp thứ 2 để cập nhật UI từ một thread khác; đó là bên trong lớp MainScreenUpdateThread, chúng ta goi phương thức getEventLock() để nhận event lock.
public void run() {
for (int i = 0; i < 10; i++) {
try {
Thread.sleep(5000);
} catch (InterruptedException ex) {
}
// Ensure we have the event lock
synchronized(UiApplication.getEventLock()) {
mainScreen.appendLabelText(“Update”);
}
}
}
Phương pháp này cho ra cùng một kết quả với phương pháp đầu tiên.
Theo mặc định, một ứng dụng sẽ thoát khi màn hình cuối cùng của nó được đóng; tuy nhiên, bạn có thể override hành vi này để thiết lập một ứng dụng chạy background, có nghĩa là UI sẽ không được hiển thị, nhưng ứng dụng vẫn tiếp tục chạy trong khi người dùng thực hiện các công việc khác. Ứng dụng chạy ở dạng Background chỉ thực sự hữu ích trong các tình huống sau:
Một ứng dụng có thể được chuyển sang Background nếu một người dùng khi nhấn phím red phone hay chuyển sang các task một cách tường minh. Bạn có thể phát hiện trạng thái background này bằng cách override phương thức UiApplication.deactivate(). Tương tự như vậy, bạn có thể phát hiện các ứng dụng của bạn trở về Foreground bằng cách gọi phương thức UiApplication.activate().
Bây giờ, sữa đổi HelloWorldApp để hiển thị một message khi Hello World đi vào Background hay Foreground
public class HelloWorldApp extends UiApplication {
private HelloWorldMainScreen mainScreen;
public HelloWorldApp() {
mainScreen = new HelloWorldMainScreen();
pushScreen(mainScreen);
}
public void deactivate() {
mainScreen.appendLabelText(“Went to background”);
}
public void activate() {
mainScreen.appendLabelText(“Came to foreground”);
}
/**
* @param args
*/
public static void main(String[] args) {
HelloWorldApp app = new HelloWorldApp();
app.enterEventDispatcher();
}
}
Khi chạy ứng dụng này, ngay lập tức sẽ thấy một message ”Came to foreground”.
Message được hiển thị bởi vì những kích hoạt ban đầu của ứng dụng. Nhấn nút đỏ, và sau đó chọn icon một vài lần để chuyển ứng dụng từ foreground sang background.
Bạn có thể chuyển ứng dụng sang Background bằng cách gọi phương thức UiApplication.requestBackground(). Để làm cho Hello World chuyển sang Background thay vì exit khỏi ứng dụng khi người dùng đóng màn hình chính, hãy ghi đè phương thức Screen.close() trong HelloWorldMainScreen:
public class HelloWorldMainScreen extends MainScreen {
//…
public void close() {
UiApplication.getUiApplication().requestBackground();
}
}
NGuồn: mobileprograming Blog
