BlackBerry Java Development EnvironmentVersion: 4.7.0

Feature and Technical Overview

SWD-552026-1212113555-001

Contents1 Overview....................................................................................................................................................................................... 2

2 Key features.................................................................................................................................................................................. 3

3 New in this release...................................................................................................................................................................... 5

Screen and UI.................................................................................................................................................................................. 5

Touch screen user input......................................................................................................................................................... 5

Touch screen keyboard.......................................................................................................................................................... 5

Accelerometer......................................................................................................................................................................... 6

Screen display direction........................................................................................................................................................ 6

Home screen background image.......................................................................................................................................... 6

Multimedia....................................................................................................................................................................................... 7

Image and video handling..................................................................................................................................................... 7

Video recorder integration.................................................................................................................................................... 7

Digital rights management................................................................................................................................................... 7

4 Related resources........................................................................................................................................................................ 8

5 System Requirements................................................................................................................................................................. 9

6 Glossary......................................................................................................................................................................................... 10

7 Provide feedback......................................................................................................................................................................... 11

8 Legal notice.................................................................................................................................................................................. 12

Overview 1

The BlackBerry® Java® Development Environment is a Java® development environment for creating applications forBlackBerry® devices. You can use MIDP APIs, CLDC APIs to build a Java® Platform Micro Edition application or use the BlackBerryAPIs to create a custom application that uses the features a BlackBerry device. These features include GPS and location-basedservices, multimedia, calendar and email access, a customizable UI, and interaction with a trackwheel or touch screen. You canalso create an application that interacts with the components of the BlackBerry solution including the BlackBerry® EnterpriseServer, push email, BlackBerry® Device Software applications, and server-side resources.

The BlackBerry JDE includes a suite of tools for creating, testing, packaging, and distributing applications. These tools include aBlackBerry® Smartphone Simulator, a code signing tool for using protected APIs, support for communication protocols, andintegration with other development environments such as NetBeans™.

Feature and Technical Overview Overview

2

Key features 2

Feature Description

simulation tools You can use the BlackBerry® simulators to test a BlackBerry device application on

a desktop computer, simulate sending and receiving data with a BlackBerry®

Enterprise Server, and send messages between the BlackBerry® Smartphone

Simulator and either a messaging application, such as Microsoft® Outlook®, or

POP3 and SMTP servers.

customizable UI You can use the BlackBerry APIs to create a BlackBerry device application UI with

the same features and layout as the UI of many BlackBerry® Device Software

applications.

tools for building client applications You can create a BlackBerry device application that is standalone or connects to

resources on the Internet or an organization's intranet.

integration with BlackBerry solutions

and device features

You can use the BlackBerry APIs to create a BlackBerry device application that uses

key features of the BlackBerry solution such as email, phone, instant messaging,

the Internet, and SMS. You can also let a BlackBerry device applicaton use key

features of a BlackBerry device such as GPS and location-based services, video

playback, and the trackball.

multilanguage support You can create a BlackBerry device application that can automatically display

information in a language specific to a geographic region.

data storage You can create a BlackBerry device application that stores data in persistent storage

on a BlackBerry device or a microSD card.

support for multiple development

environments

You can integrate a BlackBerry device application with Java® development

environments including Eclipse™ or NetBeans™.

support for development tools You can use a full set of development, optimization, and debugging tools including

windows with breakpoints, locks, memory profiling, and an objects analyser, to

create a BlackBerry device application.

support for Java Platform Micro Edition

technology

You can create a BlackBerry device application that uses standard Java®

specification requests.

use of protocol and programming

language support

You can create a BlackBerry device application that communicates with server-side

applications written in a variety of programming languages and using standard

protocols and data formats such as HTTPs, TCP/IP and XML.

Feature and Technical Overview Key features

3

Feature Description

push content support You can make sure that your customers are connected to communication and

corporate data by actively sending them data.

security You can create a BlackBerry device application that uses security features such as

AES or Triple DES encryption to transfer data.

Feature and Technical Overview Key features

4

New in this release 3

Screen and UIEnhancements to the BlackBerry® Screen and UI APIs let you create a BlackBerry device application that works with the new UIfeatures of the BlackBerry® Storm smartphone. These features include a clickable touch screen, a touch screen keyboard, anaccelerometer for sensing the orientation and acceleration of the BlackBerry device, and the ability to allow or prevent theBlackBerry device from changing the display direction of the screen.

Touch screen user input

The BlackBerry® UI APIs now let a BlackBerry device application receive events when a BlackBerry device user touches the screenof the BlackBerry® Storm smartphone.

A BlackBerry device application can use the net.rim.device.api.ui.TouchEvent class and thenet.rim.device.api.ui.TouchGesture class to receive and respond when a BlackBerry device user performs anaction, like a tap, click, or swipe, on the device screen.

A touch event corresponds to an action a BlackBerry user performs on the touch screen such as a click. A touch gesture correspondsto a combination of touch events that a BlackBerry user generates when they touch the touch screen such as a slide across thescreen.

A MIDlet can extend the net.rim.device.api.lcdui.BlackBerryCanvas class, thenet.rim.device.api.lcdui.game.BlackBerryGameCanvas class, thenet.rim.device.api.lcdui.BlackBerryCustomItem class, or the pointer methods in thejavax.microedition.lcdui.Canvas class to receive and respond when a BlackBerry device user performs an actionon the device screen.

Touch screen keyboard

The BlackBerry® UI APIs now let a BlackBerry device application interact with the touch screen keyboard.

A BlackBerry device application can use the net.rim.device.api.ui.Screen. getVirtualKeyboard()method to access the touch screen keyboard for the current application screen.

A BlackBerry device application can use the setVisibility(int) method of thenet.rim.device.api.ui .VirtualKeyboard class to display or hide the touch screen keyboard.

Feature and Technical Overview New in this release

5

Accelerometer

The BlackBerry® Storm device includes an acclerometer that senses the orientation and acceleration of the device. When aBlackBerry device user moves the device, the accelerometer senses the movement in 3-D space along the x, y, and z axis. ABlackBerry device user can change the orientation of the device which can change the display direction of a screen for a BlackBerrydevice application between portrait and landscape.

The Accelerometer APIs in the net.rim.device.api.system package let a BlackBerry device application respond tothe orientation and acceleration of a BlackBerry device. For example, you can manipulate a game application to change thedirection and speed of a moving object on the screen as a BlackBerry device user moves and rotates the BlackBerry device atdifferent speeds.

Screen display direction

When the orientation of the BlackBerry® Storm device changes, the display direction of the screen of a BlackBerry deviceapplication can also change. The display direction refers to the top of the drawing area of the screen relative to the location ofthe BlackBerry logo on the BlackBerry device. The display direction of an application screen can be north, south, east, west,landscape, or portrait.

The BlackBerry® UI APIs now let a BlackBerry device application retrieve the display direction of the screen and prevent aBlackBerry device from changing the display direction of the screen.

A BlackBerry device application can use the net.rim.device.api.system.Display.getOrientation()method to retrieve the display direction of the screen. A BlackBerry device application can usethe net.rim.device.api.ui.UiEngineInstance .setAcceptableDirections(int) method toset the screen to only display in certain directions when a BlackBerry device user changes the orientation of the BlackBerry Stormdevice. For example, an application that displays a document could set the screen to always display in landscape mode.

Home screen background image

The BlackBerry® UI APIs now let a BlackBerry device application set the image that appears as the background of the Homescreen on a BlackBerry device.

A BlackBerry device application can use net.rim.blackberry.api.homescreen.HomeScreen.setBackgroundImage(String uri) with an image file that resides in flash memory or a microSD Card to set thebackground image. A typical format for the URI is "file:///store/home/user/pictures/file.jpg." Invokingnet.rim.blackberry.api.homescreen.HomeScreen. setBackgroundImage(String uri) willoverride images that other applications have set.

Feature and Technical Overview Screen and UI

6

MultimediaEnhancements to the BlackBerry® APIs let you create a BlackBerry device application that can receive image files and video filesfrom the camera application, video recorder application, and the file explorer. You can also create a BlackBerry device applicationthat can launch the video recorder application and record video.

Image and video handling

The BlackBerry® APIs now add menu items to the camera application and video recorder that let a BlackBerry device user sendmedia files to a BlackBerry device application.

A BlackBerry device application uses the javax.microedition.content.ContentHandler API to register asa content handler. After registration, when a BlackBerry device user takes a picture or records a video, menu items appear in thecamera application, the video recorder, and the file explorer. A BlackBerry device user can use the menu items to send an imagefile or video file to the BlackBerry device application.

Video recorder integration

The BlackBerry® APIs now let a BlackBerry device application start the video recorder application.

A BlackBerry device application can use the net.rim.blackberry.api.invoke.Invoke.APP_TYPE_CAMERA field and the net.rim.blackberry.api.invoke. CameraArguments.ARG_VIDEO_RECORDER field as arguments to the net.rim.blackberry.api.invoke.Invoke.invokeApplication method to invoke the video recorder in the camera application and record video.

Digital rights management

The BlackBerry® APIs now let a BlackBerry device application install and use digital rights management licenses for media on aBlackBerry device.

A BlackBerry device application can use the net.rim.device.api.drm.DRMManager class to let a BlackBerry deviceuser play media protected by digital rights management technology on a BlackBerry device.

Each BlackBerry device has one net.rim.device.api.drm.DRMManager and applies the least restrictive licenseto media.

Feature and Technical Overview Multimedia

7

Related resources 4

To download the BlackBerry® Java® Development Environment, visit www.blackberry.com/developers.

For documentation for developers, visit www.na.blackberry.com/eng/support/docs.

For more information about APIs, see the API Reference for the BlackBerry Java Development Environment.

Feature and Technical Overview Related resources

8

System Requirements 5

Item Requirement

computer • Intel® Pentium® processor or compatible (800 MHz or greater)

• minimum 400 MB of RAM or greater available

• minimum 500 MB of disk space available

operating system Any of the following operating systems:

• Microsoft® Windows Vista

• Microsoft® Windows® XP Professional

Java development kit Java® SE Development Kit version 1.6 or later

DirectX Microsoft® DirectX® version 8.0 or later

Feature and Technical Overview System Requirements

9

Glossary 6

AESAdvanced Encryption Standard

CLDCConnected Limited Device Configuration

HTTPHypertext Transfer Protocol

HTTPSHypertext Transfer Protocol over Secure Sockets Layer

MIDPMobile Information Device Profile

Triple DESTriple Data Encryption Standard

XMLExtensible Markup Language

Feature and Technical Overview Glossary

10

Provide feedback 7

To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.

Feature and Technical Overview Provide feedback

11

Legal notice 8

©2008 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ andrelated trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S.and countries around the world.

Eclipse is a trademark of the Eclipse Foundation, Inc. Intel and Pentium are trademarks of Intel Corporation. Java and NetBeansare trademarks of Sun Microsystems, Inc. Microsoft DirectX, Outlook, Windows Vista, and Windows are trademarks of MicrosoftCorporation. All other trademarks are the property of their respective owners.

The BlackBerry smartphone and other devices and/or associated software are protected by copyright, international treaties, andvarious patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318;D445,428; D433,460; D416,256. Other patents are registered or pending in the U.S. and in various countries around the world.Visit www.rim.com/patents for a list of RIM (as hereinafter defined) patents.

This documentation including all documentation incorporated by reference herein such as documentation provided or madeavailable at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition,endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in thisdocumentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation maydescribe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information thatis contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements,or other additions to this documentation to you in a timely manner or at all.

This documentation might contain references to third-party sources of information, hardware or software, products or servicesincluding components and content such as content protected by copyright and/or third-party web sites (collectively the "ThirdParty Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including,without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency,links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Servicesin this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way.

EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDINGWITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OFDURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALINGOR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCEOF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, AREHEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONSMAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENTPERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENTTHEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROMTHE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.

Feature and Technical Overview Legal notice

12

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLEFOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCEDHEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY,INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES,FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OFBUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMSASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS,LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OFSUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARYLOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISEDOF THE POSSIBILITY OF SUCH DAMAGES.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHEROBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITYFOR NEGLIGENCE OR STRICT LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THECAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE,TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHESOR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B)TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIMESERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIRRESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.

IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE,AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITYARISING FROM OR RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that yourairtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsingfunctionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roamingarrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and servicesmay require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third partyrights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licensesare required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products andServices until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM'sproducts and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions,endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relationthereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separatelicenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or otheragreement with RIM.

Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® DesktopSoftware, and/or BlackBerry® Device Software.

Feature and Technical Overview Legal notice

13

The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto.NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIESPROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom

Published in Canada

Feature and Technical Overview Legal notice

14