专注于blackberry » 文档

MNC和MCC

Taigoo — Thu, 28 Aug 2008 09:40:51 +0000

上次发布了一个小软件来查看网络信息的，其中涉及到MNC和MCC。这篇文章是发布一小软件。

MNC: Mobile Network Code

MCC: Mobile Country Code

根据MCC，可以确定是哪一个国家，MNC可以确定是哪一个运营商。

例如，460代表中国，所以MCC是460。联通是01，也即MNC是01，同理，移动的MNC是00。最后460000代表移动，460001代表联通。

完整的MCC和MNC如下表（供以后查用）

MCC	MNC	Country	Network
412	1	Afghanistan	Afghan Wireless Communication Company (AWCC)
412	40	Afghanistan	Areeba
412	20	Afghanistan	Telecom Development Company Afghanistan (ROSHAN)
276	1	Albania	Albanian Mobile Comms
276	2	Albania	Vodafone Albania
603	1	Algeria	Algerian Mobile Network (ATM Mobilis)
603	2	Algeria	Orascom Telecom Algerie Spa (Djezzy)
603		Algeria	Wataniya Telecom
213	3	Andorra	S.T.A. MobilAnd
631	2	Angola	UNITEL S.a.r.l.
365	840	Anguilla	Cable&Wireless
344		Antigua	Cingular
344	30	Antigua	APUA PCS
344	920	Antigua	C&W West Indies
722	310	Argentine Republic	CTI PCS (CTI Movil)
722	34	Argentine Republic	Telecom Personal SA
722	7	Argentine Republic	Telefonica Comunicaciones SA (Movistar)
283	1	Armenia	ArmenTel
283	4	Armenia	Karabaht Telecom
283	5	Armenia	Vivacell (K Telecom)
363		Aruba	New Millenium Telecom Services (Digicel)
363	1	Aruba	Setar GSM
505	6	Australia	Hutchison 3G Australia Pty Ltd
505	12	Australia	Hutchison Telecommunications Pty Ltd (Orange)
505	99	Australia	One.Tel Ltd
505	90	Australia	Singtel Optus Ltd. (YES Optus)
505	71	Australia	Telstra Mobile Comms (MobileNet)
505		Australia	Virgin Mobile
505	7	Australia	Vodafone
232	6	Austria	Connect Austria One
232	10	Austria	Hutchinson 3 G Austria
232	2	Austria	MobilKom Austria A1
232	4	Austria	T-Mobile Austria GmbH (MaxMobil)
232	9	Austria	Tele2 Mobil
232	7	Austria	Telering
400	1	Azerbaijani Republic	Azercell Telekom B.M.
400	2	Azerbaijani Republic	J.V. Bakcell GSM 2000
426	1	Bahrain	Batelco
426	2	Bahrain	MTC Vodafone (Zain)
470	1	Bangladesh	Grameen Phone
470	2	Bangladesh	TM Int’l
342	600	Barbados	C&W West Indies
342		Barbados	Cingular
342	750	Barbados	Digicel Ltd.
257	2	Belarus	MTS
257	1	Belarus	Mobile Digital Communications
206	20	Belgium	BASE NV/SA
206	1	Belgium	Belgacom Mobile Proximus
206	10	Belgium	Mobistar
702	67	Belize	Belize Telecommunications Ltd.
702	68	Belize	International Telecomunications Ltd.
616	3	Benin	Spacetel-Benin (Areeba)
616	2	Benin	Telecel Benin Ltd
350	2	Bermuda	Mobility Limited - GSM 1900
350	1	Bermuda	Telecommunications Ltd (AT&T, Cingular)
736	2	Bolivia	Entel SA
218	3	Bosnia and Herzegovina	Eronet Mobile Communications Ltd
218	5	Bosnia and Herzegovina	JODP for Telecomms of Republic Srpska
218	90	Bosnia and Herzegovina	PE PPT BIH
652	1	Botswana	Mascom Wireless
652	2	Botswana	Orange (Vista Cellular Limited)
724	16	Brazil	BSE
724	0	Brazil	Nextel (Telet)
724	3	Brazil	TIM Brazil - CTMR (CTMR Cel)
724	2	Brazil	TIM Brazil - Global Telecom (Global Telecom)
724	4	Brazil	TIM Brazil -BCP (BCP)
724	31	Brazil	Teleacre Cel - Oi (TNL PCS / Oi)
724	55	Brazil	Teleamazon Cel
724	19	Brazil	Telemig Cel
724	5	Brazil	Telesc Cel - Claro (CLARO/ALBRA)
528	11	Brunei Darussalam	Datastream Technology (DTSCom)
284	3	Bulgaria	BTC Mobile EOOD (vivatel)
284	5	Bulgaria	Cosmo Bulgaria Mobile EAD
284	1	Bulgaria	MobilTel AD
613	2	Burkina Faso	Celtel Burkina Faso
613	1	Burkina Faso	Onatel
613	3	Burkina Faso	Telecel
642	3	Burundi	Telecel Burundi Company
456	1	Cambodia	CamGSM (MobiTel)
456	2	Cambodia	Cambodia Samart Comms
456	18	Cambodia	Cambodia Shinawatra (Camshin)
624	1	Cameroon	MTN Cameroon Ltd
624	2	Cameroon	Orange Cameroon
302	370	Canada	Rogers Wireless (Fido, AT&T, Microcell)
625	1	Cape Verde	Cabo Verde Telecom
346		Cayman Island	Cingular
346	6	Cayman Island	Digicel Cayman Ltd.
346	140	Cayman Island	C&W West Indies
623	2	Central African Republic	Telecel
622	1	Chad	CelTel Tchad SA
730	1	Chile	Entel Telefonia Movil
730	3	Chile	SmartCom
730	2	Chile	Telefonica Movil de Chile
730	10	Chile	Entel PCs Telecom
460	0	China	China Mobile GSM
460	1	China	China Unicom GSM
732	103	Colombia	Colombia Movil SA
732		Colombia	Comunicacion Celular SA Comsel SA
732	123	Colombia	Telefonica Moviles Colombia S.A.
630	1	Congo	CelTel Congo SA
630	10	Congo	Libertis Telecom
	1	Cook Islands	Telecom Cook Islands
712	1	Costa Rica	I.C.E. (Instituto Costarricense de Elect
219	1	Croatia	T-Mobile Croatia (Croatian Telecoms Cronet)
219	2	Croatia	Tele2
219	10	Croatia	VIPnet d.o.o. (Tomato)
368	1	Cuba	C_Com (Etesca)
280	1	Cyprus	Cyprus Telecoms Authority (Cytamobile-Vodafone)
280	10	Cyprus	Areeba Ltd.
230	2	Czech Republic	O2 (EuroTel)
230	1	Czech Republic	T-Mobile
230	3	Czech Republic	Vodafone Czech Republic a.s. (OSKAR)
630	2	Democratic Republic of the Congo	Celtel Congo
630	1	Democratic Republic of the Congo	Vodacom Congo
238	2	Denmark	Dansk Mobil Telefon (Sonofon)
238	6	Denmark	Hi3G
238	1	Denmark	TDC Denmark (TeleDanmark Mobil)
238	77	Denmark	Tele2
238		Denmark	Telia (Orange/Mobilix)
238	30	Denmark	Telia A/S
638	1	Djibouti	Djibouti Telecom SA (Evatis)
366	110	Dominica	C&W West Indies
370	1	Dominican Republic	Orange Dominicana S.A.
514	2	East Timor	Timor Telecom
740	1	Ecuador	Conecel S.A. (Consocio Ecuatoriano de Te
740	0	Ecuador	Movistar
602	3	Egypt	Etisalat
602	1	Egypt	MobiNil
602	2	Egypt	Vodafone
706	1	El Salvador	CTE Telecom Personal SA de CV
706	2	El Salvador	DIGICEL S.A. de C.V.
706	4	El Salvador	Telefonica Moviles El Salvador
706	3	El Salvador	Telemovil El Salvador
627	1	Equatorial Guinea	GETESA
248	1	Estonia	AS EMT
248	2	Estonia	Radiolinja Eesti
248	3	Estonia	Tele2 Eesti AS
636	1	Ethiopia	Ethiopian Telecoms Auth.
288	1	Faroe Islands	Faroese Telecom GSM 900
288	2	Faroe Islands	P/F Kall (Kall GSM)
542	1	Fiji	Vodafone Fiji
244	3	Finland	TeliaSonera Corporation (DNA Finland Oy,Ainacom Oy,DNA Verkot Oy)
244	14	Finland	Alands Mobiltelefon
244	21	Finland	Elisa Corporation (Radiolinja/ Saunalahti)
244	12	Finland	Finnet Group - DNA (Suomen 2G)
208	0	France	Orange/France Telecom (Orange Reunion)
208	10	France	SFR/Cegetel
208	20	France	Bouyges Telecom (Digicel Antilles Francaises Guyane)
340	1	French Guiana	Orange
340	2	French Guiana	Outremer Telecom
340	20	French Guiana	Bouygues telecom Caraibe
547	20	French Polynesia	Tikiphone
628	3	Gabon Republic of	Celtel Gabon SA
628	1	Gabon Republic of	Libertis S.A.
628	2	Gabon Republic of	Telecel Gabon SA
607	2	Gambia	Africel
607	1	Gambia	Gambia Telecommunications Cellular Compa
282	1	Georgia	Geocell Limited
282	2	Georgia	Magti GSM
262	3	Germany	E-Plus
262	8	Germany	O2
262		Germany	PSTN Fixed Line SMS Service (Annyway SMSC)
262	1	Germany	T-Mobile (D1)
262	2	Germany	Vodafone (D2)
262	16	Germany	vistream
620	2	Ghana	Mobile)
620	3	Ghana	Millicom Ghana Limited (tiGO Buzz/Mobitel)
620	1	Ghana	ScanCom (Spacefon)
266	1	Gibraltar	Gibraltar Telecoms Gibtel
202	1	Greece	Cosmote
202	9	Greece	Info Quest - Commercial & Industrial SA
202	5	Greece	Panafon/vodafone
202	10	Greece	WIND Hellas (TIM/Telestet)
290	1	Greenland	Tele Greenland A/S
352	110	Grenada	C&W West Indies
340	1	Guadeloupe	Orange Caraibe Mobiles (France Caraibe - Ameris)
340	20	Guadeloupe	Bouygues Telecom Caraibe
704	2	Guatemala	COMCEL
704	1	Guatemala	SERCOM S.A.
704	3	Guatemala	Telefonica Moviles Guatemala
611	2	Guinea	Sotelgui Lagui
738	1	Guyana	Guyana Telephone&Telegraph Co. (Cellink Plus; Digicel)
708	1	Honduras	Megatel S.V. de C.V. (Tigo)
708	2	Honduras	Telefonica Celular S.A.
454	2	Hongkong	Hong Kong Telecom CSL (Pacific Link)
454	15	Hongkong	Hutchinson Telecom (Orange)
454	10	Hongkong	New World PCS
454	19	Hongkong	PCCW (Mandarin Com. Sunday)
454	12	Hongkong	Peoples Telephone
454	22	Hongkong	SmarTone Mobile Comms (P Plus)
216	1	Hungary	Pannon GSM
216	30	Hungary	T-Mobile (Westel 900)
216	70	Hungary	Vodafone
274	4	Iceland	IMC Island ehf
274	6	Iceland	Núll níu ehf.
274	1	Iceland	Siminn
274	3	Iceland	og Vodafone (TAL hf, Íslandssími GSM ehf.)
274	11	Iceland	Nova
404	6	India	AIRTEL Bharti Airtel Ltd.
404	60	India	Aircel Digilink India Ltd. (ESSAR)
404	42	India	Aircell Ltd.
404	27	India	BPL Mobile (BPL Cellular)
404	86	India	Barakhamba Sales & Services Ltd. (BSSL)
404	53	India	Bharat Sanchar Nigam Ltd. (BSNL - CellOne)
404	87	India	Escorts Telecom Ltd.
404	19	India	Escotel Mobile Comms
404	5	India	FASCEL Ltd. (Hutch-Gujarat)
404	16	India	Hexacom India Ltd. (Oasis)
404	84	India	Hutchinson Max Telecom Ltd. (Orange)
404	24	India	IDEA Cellular Ltd. (BTA Cellcom Ltd.)
404	69	India	Mahanagar Telephone
404	41	India	RPG MAA
404	18	India	Reliance Telecom Private
404	44	India	Spice
404	30	India	Vodafone Essar East Ldt (Hutch Essar East,Usha Martin Telecom Ltd)
404	11	India	Vodafone Essar Telecom Ltd (former Hutch Essar,Sterling Cellular Ltd)
510	8	Indonesia	Natrindo
510	1	Indonesia	PT. Satelindo
510	10	Indonesia	Telkomsel
510	89	Indonesia	Hutchinson 3G
510	21	Indonesia	Indosat-M3
510	11	Indonesia	PT. Excelcomindo Excelcom (XL)
432	14	Iran	KFZO (TKC, Telecommunication Kish Co.)
432	11	Iran	TCI
432	32	Iran	Taliya
418	5	Iraq	Asia Cell Telecommunications Com.
418	20	Iraq	Atheer Telecom Iraq
418	30	Iraq	Orascom Telecom Iraq Corporation (IRAQNA)
272	5	Ireland	Hutchison 3G Ireland
272	3	Ireland	Meteor
272	2	Ireland	O2
272	1	Ireland	Vodafone Eircell
425	2	Israel	Cellcom Israel Ltd
425	5	Israel	Palestine Telecomm Co Ltd
425	1	Israel	Partner Communications (Orange)
425	3	Israel	Pelephone
222	99	Italy	Hi3G
222	1	Italy	Telecom Italia Mobile
222	10	Italy	Vodafone (Omnitel Pronto)
222	88	Italy	Wind Telecommunicazioni
612	5	Ivory Coast	Loteny Telecom (Telecel, MTN)
612	3	Ivory Coast	Orange Côte D\’Ivoire S.A. (SIM, Ivoiris)
338	180	Jamaica	C&W
338	50	Jamaica	Mossel (Digicel)
441	63	japan	J-Phone
440	96	japan	J-Phone Co. Ltd.
441	90	japan	NTT DoCoMo
416	77	Jordan	Petra Jordanien Mobile Telecommunication (MobileCom)
416	3	Jordan	Umniah Mobile Company
416	2	Jordan	Xpress
416	1	Jordan	Zain (Fastlink)
401	2	Kazakhstan	GSM Kazakhstan K’Cell
401	1	Kazakhstan	KaR-Tel LLC (Beeline)
639	3	Kenya	Kencell Communications Ltd
639	2	Kenya	Safaricom Limited
450	8	Korea	KT Freetel Co. Ltd. (KT ICOM)
450	5	Korea	SK Telecom
419	2	Kuwait	Mobile Telecoms MTCNet (Zain)
419	3	Kuwait	National Mobile Telecommunications Co (Wataniya)
437	1	Kyrgyzstan	Sky Mobile GSM (Bitel)
457	1	Lao People’s Democratic Republic	Lao Shinawatra Telecom
457	8	Lao People’s Democratic Republic	Millicom (Tango)
247	1	Latvia	Latvian Mobile Tel.
247	5	Latvia	SIA Bite Latvia
247	2	Latvia	Tele2
415	1	Lebanon	MIC 1 (Alfa)
415	34	Lebanon	FTML Cellis
415	38	Lebanon	MTC (MIC 2 / LibanCell)
606	1	Libya	EL MADAR Telecomm Company
606	0	Libya	Libyana Mobile Phone
295	5	Liechtenstein	Mobilkom AG (FL1 / United Mobile)
295	2	Liechtenstein	Orange AG (VIAG)
295	1	Liechtenstein	Swisscom Mobile Ltd. (FL Telecom)
295	77	Liechtenstein	Tele 2 Aktiengesellschaft (Tango)
246	1	Lithuania	Omnitel
246	2	Lithuania	UAB “Bite GSM”
246	3	Lithuania	UAB “TELE2″
270	1	Luxembourg	P+T LUXGSM
270	77	Luxembourg	Millicom Tango GSM
270	99	Luxembourg	VOXmobile S.A.
455	1	Macau	C.T.M. TELEMOVEL+
455	3	Macau	Hutchison Telephone
455	0	Macau	SmarTone Mobile Communications
294	2	Macedonia The Former Yugoslav Republic of	MTS (Cosmofone)
294	1	Macedonia The Former Yugoslav Republic of	T-Mobile Macedonia
646	1	Madagascar	Madacom SA
646	2	Madagascar	Orange
646	4	Madagascar	Telma
650	1	Malawi	Telekom Network Ltd (Callpoint 900)
650	10	Malawi	CelTel Limited
502	19	Malaysia	Celcom (TMTOUCH)
502	16	Malaysia	Digi Telecommunications Sdn Bhd
502	17	Malaysia	Maxis (TimeCel)
472	1	Maldives	Dhivehi Raajjeyge Gulhun Private Ltd GSM (C&W Maldives)
472	2	Maldives	Wataniya Telecom Maldives Pvt. Ltd. (WMobile)
610	1	Mali	Malitel-SA
610	2	Mali	Orange Mali SA (Ikatel SA)
278	1	Malta	Vodafone Malta Limited
278	21	Malta	Mobisle Communications Limited
340	1	Martinique	Orange Caraibe Mobiles (France Caraibe - Ameris)
340	20	Martinique	Bouygues Telecom Caraibe (Digicel Antilles Francaises Guyane)
609	1	Mauritania	Mattel
609	10	Mauritania	Mauritel Mobiles
617	1	Mauritius	Cellplus Mobile Comms
617	10	Mauritius	Emtel Ltd
334	20	Mexico	Radiomovil Dipsa SA de CV (TELCEL)
334	3	Mexico	Telefonica Moviles (Pegaso Comunicaciones (MOVISTAR))
259	2	Moldova	Moldcell SA (Orange Moldova S.A.)
259	1	Moldova	Voxtel S.A
212	1	Monaco	Monaco Telecom
428	99	Mongolia	MobiCom (MobCom Co. Ltd)
604	1	Morocco	Itissalat Al-Maghrib S.A
604	0	Morocco	Medi Telecom
643	1	Mozambique	Mosambique Celular S.A.R.L (mCel)
643	4	Mozambique	Vodacom Mozambique
649	1	Namibia	Mobile Telecommunications Limited
429	1	Nepal	Nepal Telecommunications Corporation
429	2	Nepal	SPICE
204	8	Netherlands	KPN Telecom
204	20	Netherlands	Orange (taken over by T-Mobile on 1.10.2007)
204	15	Netherlands	T-Mobile
204	2	Netherlands	Tele2
204	12	Netherlands	Telfort (incl Lebara, Tele2, BT Ignite)
204	4	Netherlands	Vodafone
362	69	Netherlands Antilles	Curacao Telecom N.V.
362	51	Netherlands Antilles	Telcell N.V.
530	2	New Zealand	Telecom NZ
530	4	New Zealand	Telstra
530	1	New Zealand	Vodafone
710	21	Nicaragua	ENITEL (Empresa Nicaraguense de Telecomu
710	73	Nicaragua	Sercom
710	300	Nicaragua	Telefonica Movistar
614	2	Niger	Celtel Niger
614	3	Niger	Telecel
621	20	Nigeria	Econet Wireless Nigeria Ltd (Vmobile)
621	50	Nigeria	Glo Mobile (Globacom)
621	30	Nigeria	MTN Nigeria Communications Limited
242	2	Norway	NetCom GSM
242	5	Norway	Network Norway
242	4	Norway	Tele2 Norge
242	1	Norway	Telenor Mobil
242	3	Norway	Teletopia Mobile
422	2	Oman	General Telecoms
422	3	Oman	Nawras (Omani Qatari)
410	1	Pakistan	Mobilink
410	3	Pakistan	Pak Telecom Mobile Ltd
410	4	Pakistan	Paktel Ltd.
410	6	Pakistan	Telenor Pakistan
410	7	Pakistan	Warid Telecom
425	5	Palestinian Territory	Palestine Telecomm Co Ltd (Jawwal)
714	1	Panama	Cable & Wireless Panama
714	20	Panama	Telefonica Movistar
744	1	Paraguay	Hola Paraguay S.A
744	2	Paraguay	Hutchinson (COPESA)
744	5	Paraguay	Nucleo (Personel)
744	4	Paraguay	Telecel Paraguay
716	7	Peru	Nextel
716	10	Peru	TIM
515	5	Philippines	Digitel
515	2	Philippines	Globe Telecom
515	1	Philippines	Innove Communication (Islacom)
515	88	Philippines	Nextel Com.
515	3	Philippines	Smart Communications Inc.
260	6	Poland	PLAY (Netia Mobile)
260	5	Poland	PTK Centertel (IDEA / Orange)
260	1	Poland	Polkomtel (Sami-Swoi)
260	2	Poland	Polska Telefonia Cyfrowa (PTC / ERA)
268	3	Portugal	Optimus Telecom (Sonaecom)
268	6	Portugal	Telecom Moveis Nac.TMN
268	1	Portugal	Vodafone Telecel
427	1	Qatar	Q-Tel (Qatarnet)
647	0	Reunion	Orange Reunion
647	10	Reunion	Societe Reunionnaise SRR
226	3	Romania	Cosmote (Cosmorom)
226	10	Romania	Orange Romania SA
226	1	Romania	Vodafone (CONNEX GSM)
250	19	Russia	Bashcell (CJSC)
250	99	Russia	Bee Line GSM (KB Impulse / VimpelCom)
250	12	Russia	CJSC BaykalWestCom
250	10	Russia	DonTeleCom
250	17	Russia	Ermak
250	13	Russia	Kuban- GSM Closed JSC
250	1	Russia	MTS - Mobile Telesystems
250	2	Russia	Megafon
250	5	Russia	Mobile Comms System
250	16	Russia	New Telephone Company
250	3	Russia	Nizhegorodskaya Cellular Communications
250	11	Russia	Orensot
250	92	Russia	Primtelefon
250	4	Russia	Sibchallenge
250	7	Russia	ZAO SMARTS (BM Telecom)
635	10	Rwandese Republic	Rwandacell SARL (MTN)
356	110	Saint Kitts and Nevis	C&W West Indies
360	110	Saint Vincent and the Grenadines	C&W West Indies
292	10	San Marino	San Marino Telecom - SMT
901	5	Satellite Networks	Thuraya Satellite
420	3	Saudi Arabia	Etihad Etisalat Company (Mobily)
420	1	Saudi Arabia	Saudi Telecom Company (Al Jawal)
608	2	Senegal	Sentel GSM
608	1	Senegal	Sonatel (Alize)
220	1	Serbia and Montenegro	MOBTEL
220	4	Serbia and Montenegro	Monet D.O.O
220	3	Serbia and Montenegro	Telekom Srbija a.d. (MT:S)
220	4	Serbien & Montenegro	Monet D.O.O
220	2	Serbien & Montenegro	ProMonte GSM
633	1	Seychelles	Cable & Wireless Ltd
633	10	Seychelles	Telecom/Airtel
619	1	Sierra Leone	Celtel
619	4	Sierra Leone	Comium
619	2	Sierra Leone	Millicom
525	3	Singapore	MobileOne Ltd
525	1	Singapore	Singapore Telecom (GSM 900/1800)
525	5	Singapore	StarHub Pte Ltd
231	4	Slovak Republic	Eurotel UMTS
231	1	Slovak Republic	Orange/Globtel GSM a.s
231	2	Slovak Republic	T-Mobile (EuroTel Bratislava a.s)
231	6	Slovak Republic	Telefonica O2
293	41	Slovenia	Mobitel d.d
293	40	Slovenia	SI.Mobil d.d
293	70	Slovenia	Vega/Western Wireless International
637	10	Somali Democratic Republic	NationLink
637	4	Somali Democratic Republic	Somafone
655	7	South Africa	Cell C Ltd
655	10	South Africa	MTN-Mobile Telephone NetworksLtd
655	1	South Africa	Vodacom Group Pty Ltd.
214	1	Spain	Airtel Movil (Vodafone)
214	7	Spain	Movistar (Telefonica)
214	3	Spain	Retevision Movil (Amena)
214	4	Spain	YOIGO (Xfera Moviles SA)
413	3	Sri Lanka	Celltel Lanka Limited (Celltel Infiniti)
413	2	Sri Lanka	Dialog Telekom (MTN)
413	8	Sri Lanka	Hutchinson Telecommunication Lanka Ltd.
413	1	Sri Lanka	Mobitel Ltd.
358	110	St. Lucia	C&W West Indies
634	2	Sudan	Bashair Telecom Co. Ltd. (Areeba)
634	1	Sudan	Sudanese Mobile Telephone Company Ltd (Mobitel)
746	2	Suriname	TELESUR
240	4	Sweden	3G Infrastucture Services
240	7	Sweden	Comviq/Tele2
240	2	Sweden	H3G Access AB
240		Sweden	Intelligent Appl. AB
240		Sweden	Nye Telenor Mobile Communications (Djuice)
240	3	Sweden	Orange Sverige AB (Nordisk Mobiltelefon)
240	10	Sweden	Swefour AB (Spring Mobil AB)
240	6	Sweden	Telenor Sverige AB (EuropolitanVodafone / Nye / Djucie)
240	1	Sweden	Telia Mobile
228	3	Switzerland	Orange
228	2	Switzerland	Sunrise Communications AG (former TDC)
228	1	Switzerland	Swisscom NATEL (Tele2, 3G Mobile)
228	8	Switzerland	Tele2 Telecommunication Services AG
417	2	Syrian Arab Republic	Spacetel Syria (Areeba)
417	1	Syrian Arab Republic	Syriatel Holdings S.A
466	92	Taiwan	Chunghwa Telecom LDM
466	1	Taiwan	Far EasTone Telecommunications GSM 900/1
466	88	Taiwan	KG Telecom
466	93	Taiwan	Mobitai Communications Corp.
466	97	Taiwan	Taiwan Mobile Co. Ltd (Taiwan Cellular Corp. (Pacific GSM))
466	99	Taiwan	TransAsia Telecoms
466	89	Taiwan	VIBO Telecom Inc. (T3G)
436	2	Tajikistan	CJSC Indigo Tajikistan
436	1	Tajikistan	JC Somoncom
436	4	Tajikistan	Josa Babylon-T
640	5	Tanzania	Celtel Tanzania Limited
640	2	Tanzania	MIC Tanzania Ltd (Mobitel)
640	4	Tanzania	Vodacom Tanzania Ltd
640	3	Tanzania	Zanzibar Telecom (Zantel)
520	1	Thailand	Advanced Info Service Plc (AIS)
520	23	Thailand	Digital Phone Co Ltd
520	99	Thailand	TA Orange Company Ltd (True Move)
520	18	Thailand	Total Access Communications Co (DTAC)
615	5	Togolese Republic	Telecel Togo
615	1	Togolese Republic	Togo Telecom (Cellulaire, Togo Cell)
374	130	Trinidad and Tobago	Digicel Ltd
374	12	Trinidad and Tobago	Telecommunications Services of T&T (TSTT
605	3	Tunisia	Orascom Telecom (Tunisiana)
605	2	Tunisia	Tunisie Telecom (Tuntel)
286	4	Turkey	AVEA Iletisim Hizmetleri A.S (AYCELL ARIA)
286	2	Turkey	TELSIM Mobil Telekom
286	1	Turkey	Turk Telekom Turkcell
438	1	Turkmenistan	Barash Communication Technologies Inc.
376	350	Turks and Caicos Islands	C&W West Indies
641	1	Uganda	Celtel
641	10	Uganda	MTN Uganda Ltd
641	11	Uganda	Uganda Telecom Ltd (UTL-Mango)
255	6	Ukraine	Astelit (life:))
255	5	Ukraine	Golden Telecom LLC
255	3	Ukraine	Kyivstar GSM
255	1	Ukraine	Ukrainian Mobile Comms (UMC)
255	2	Ukraine	Ukrainian Radio Systems (WellCOM)
424	1	United Arab Emirates	ETISALAT
424	3	United Arab Emirates	du
234	55	United Kingdom	Guernsey Telecoms GSM
234	94	United Kingdom	Hutchison 3G UK Ltd
234	50	United Kingdom	Jersey Telecom GSM
234	58	United Kingdom	Manx Telecom Pronto GSM
234	11	United Kingdom	O2
234	34	United Kingdom	Orange
234	32	United Kingdom	T-Mobile Limited (one2one)
234		United Kingdom	Virgin Mobile
234	15	United Kingdom	Vodafone
748	10	Uruguay	AM Wireless
748	1	Uruguay	Antel
434	5	Uzbekistan	Coscom
434	4	Uzbekistan	DAEWOO Unitel Company (UzPAK)
434	2	Uzbekistan	JV Uzmacom
434	7	Uzbekistan	Uzdunrobita
541	1	Vanuatu	Telecom Vanuatu Ltd (Smile)
734	2	Venezuela	Corporacion Digitel C.A
734	3	Venezuela	DIGICEL C.A.
734	1	Venezuela	Infonet
452	4	Viet Nam	Vietel Corporation (Viettel Mobile)
452	1	Viet Nam	Vietnam Mobile Tele. Service
452	2	Viet Nam	Vietnam Telecoms Services
421	2	Yemen	Spacetel - Yemen
421	1	Yemen	Yemen Mobile Phone Company - Sabafon
645	1	Zambia	Celtel Zambia
648	4	Zimbabwe	Econet Wireless Limited
648	3	Zimbabwe	Telecel

该表下载。

下面的来自CISCO ,感觉很怪的，说不定以后要参考价值.原文参考http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124cg/hmwg_c/mwgfmcc.htm#wp1010648


国家	运营商	MCC MNC
Albania	AMC	276 01
Andorra	STA-Mobiland	213 03
Argentine Republic		722
Armenia	Armentel	283 01
Australia	OptusTelecom Telstra Vodafone	505 02 505 01 505 03
Austria	Mobilkom Austria max.mobil. Connect Austria	232 01 232 03 232 05
Azerbaidjan	Azercell JV Bakcell	400 01 400 02
Bahrain	Batelco	426 01
Bangladesh	Grameen Phone Ltd TM International Sheba Telecom	470 01 470 19 470
Belgium	Proximus Mobistar KPN Orange	206 01 206 10 206 20
Bosnia	Cronet PTT Bosnia	218 01 218 19
Botswana	Mascom Wireless	652 01
Brunei	DSTCom Jabatan Telekom	528 11 528 01
Bulgaria	MobilTel AD	284 01
Burkina Faso	OnaTel	613
Cambodia	CamGSM Cambodia Samart Cambodia Shinawatra	456 01 456 02 456
Cameroon	PTT Cameroon Cellnet	624 01
Canada	Microcell	302 37
Cape Verde	Cabo Verde Telecom	625 01
Chile	Entel Telefonia	730
China	Guangdong MCC Beijing Wireless China Unicom Zhuhai Comms DGT MPT Jiaxing PTT Tjianjin Toll Liaoning PPTA	460 00 460 460 01 460 460 460 460 460 02
Congo	African Telecoms Congolaise Wireless	629 629
Croatia	HR Cronet Vipnet	219 01 219 10
Cyprus	CYTA	280 01
Czech Rep.	Eurotel Praha Radio Mobil	230 02 230 01
Denmark	Sonofon Tele Danmark Mobil Mobilix Telia	238 02 238 01 238 30 238 20
Egypt	MobiNil Click GSM	602 01 602 02
Estonia	EMT Radiolinja Eesti Q GSM	248 01 248 02 248 03
Ethiopia	ETA	636 01
Faroe Islands	Faroese Telecom	288
Fiji	Vodafone	542 01
Finland	Radiolinja Sonera Alands Mobiltelefon Telia Finnet Lnnen Puhelin Helsingin Puhelin	244 05 244 91 244 05 244 03 244 09 244 09 244 09
France	France Telecom SFR Bouygues Telekom	208 01 208 10 208 20
Fr.Polynesia	Tikiphone	547 20
Fr.W.Indies	Ameris	340 01
Georgia	Superphone Geocell Magticom	282 282 01 282 02
Germany	D1, DeTeMobil D2, Mannesmann E-Plus Mobilfunk Viag Interkom	262 01 262 02 262 03 262 07
Ghana	Franci Walker Ltd ScanCom	620 620 01
Gibraltar	GibTel	266 01
Great Britain	Cellnet Vodafone Jersey Telecom Guernsey Telecom Manx Telecom One2One Orange	234 10 234 15 234 50 234 55 234 58 234 30 234 33
Greece	Panafon STET Cosmote	202 05 202 10 202 01
Greenland	Tele Greenland	290
Guinea	Int’l Wireless Spacetel Sotelgui	611 611 611 02
Hong Kong	HK Hutchison SmarTone Telecom CSL P Plus Comm New World PCS Mandarin Comm Pacific Link Peoples Telephone SMC PCS	454 04 454 06 454 00 454 22 454 10 454 16 454 18 454 12 454 22
Hungary	Pannon GSM Westel 900	216 01 216 30
India	Airtel Essar Maxtouch BPLMobile Command Mobilenet Skycell RPG MAA Modi Telstra Sterling Cellular Mobile Telecom Airtouch BPL USWest Koshika Bharti Telenet Birla Comm Cellular Comms TATA Escotel JT Mobiles Evergrowth Telecom Aircel Digilink Hexacom India Reliance Telecom Fascel Limited	404 10 404 11 404 20 404 21 404 30 404 31 404 40 404 41 404 14 404 11 404 404 404 404 404 404 404 27 404 07 404 12 404 404 404 15 404 404 404
Indonesia	TELKOMSEL PT Satelit Palapa Excelcom PT Indosat	510 10 510 01 510 11 510
Iraq	Iraq Telecom	418
Iran	T.C.I. Celcom Kish Free Zone	432 11 432 432
Ireland	Eircell Digifone Meteor	272 01 272 02 272 03
Israel	Partner Communications	425 01
Italy	Omnitel Telecom Italia Mobile Wind	222 10 222 01 222 88
Ivory Coast	Ivoiris Telecel Comstar Loteny Telecom	612 03 612 612 01 612 05
Japan		440
Jordan	MTS	416 01
Kenya	Kenya Telecom	639
Kuwait	MTCNet	419 02
Kyrgyz Rep	Bitel Ltd	437 01
La Reunion	SRR	647 10
Laos	Lao Shinawatra	457 01
Latvia	LMT BALTCOM GSM	247 01 247 02
Lebanon	Libancell Cellis	415 03 415 01
Lesotho	Vodacom	651 01
Liechtenstein	Natel-D	228 01
Lithuania	Omnitel Bite GSM	246 01 246 02
Luxembourg	P&T LUXGSM Millicom Lux’ S.A	270 01 270 77
Macao	CTM	455 01
Macedonia	PTT Makedonija	294 01
Madagascar	Sacel Madacom SMM	646 03 646 01 646 02
Malawi	TNL	650 01
Malaysia	Celcom Maxis My BSB TM Touch Adam Digi Telecom	502 19 502 12 502 02 502 13 502 17 502 16
Malta	Advanced Telecell	278 278 01
Marocco	O.N.P.T	604 01
Mauritius	Cellplus	617 01
Monaco	France Telecom SFR Office des Telephones	208 01 208 10 208
Montenegro	Pro Monte	220 02
Mozambique	Telecom de Mocambique T.D.M GSM1800	634 01 634
Namibia	MTC	649 01
Netherlands	PTT Netherlands Libertel Telfort Holding NV Ben Dutchtone	204 08 204 04 204 12 204 16 204 20
New Caledonia	Mobilis	546 01
New Zealand	Bell South	530 01
Nigeria	EMIS	621
Norway	NetCom TeleNor Mobil	242 02 242 01
Oman	General Telecoms	422 02
Pakistan	Mobilink	410 01
Papua	Pacific	310 01
Philippines	Globe Telecom Islacom Smart	515 02 515 01 515 03
Poland	Plus GSM ERA GSM IDEA Centertel	260 01 260 02 260 03
Portugal	Telecel TMN Main Road Telecoms Optimus	268 01 268 06 268 268 03
Qatar	Q-Net	427 01
Romania	MobiFon MobilRom	226 01 226 10
Russia	Mobile Tele… Moscow United Telecom Moscow NW GSM, St. Petersburg Dontelekom KB Impuls JSC Siberian Cellular BM Telecom Beeline Extel Far Eastern Cell	250 01 250 250 02 250 10 250 99 250 250 07 250 250 28 250 12
San Marino	Omnitel Telecom Italia Mobile Wind	222 10 222 01 222 88
Saudi Arabia	Al Jawal EAE	420 01 420 07
Senegal	Sonatel	608 01
Seychelles	SEZ SEYCEL Airtel	633 01 633 10
Serbia	Serbian PTT	220 03
Singapore	Singapore Telecom MobileOne Binariang	525 01 525 03 525
Slovak Rep	Eurotel Globtel	231 02 231 01
Slovenia	Mobitel Si.Mobil	293 41 293 40
South Africa	MTN Vodacom	655 10 655 01
Sri Lanka	MTN Networks Pvt Ltd	413 02
Spain	Airtel Telefonica Spain Amena	214 01 214 07 214 03
Sudan	Mobitel	634 01
Swaziland		653
Sweden	Comviq Europolitan Telia Mobile	240 07 240 08 240 01
Switzerland	Swisscom 900 Swisscom 1800 diAx mobile Orange	228 01 228 01 228 02 228
Syria	SYR MOBILE	417 09
Taiwan	LDTA Mobitai TransAsia TWN Tuntex KGTelecom FarEasTone Chunghwa	466 92 466 93 466 99 466 97 466 06 466 88 466 01 466 11
Tanzania	Tritel	640 01
Thailand	TH AIS GSM Total Access Comms WCS Hello	520 01 520 18 520 10 520 23
Tunisia	Tunisian PTT	605 02
Turkey	Telsim Turkcell	286 02 286 01
UAE	UAE ETISALAT-G1 UAE ETISALAT-G2	424 01 424 02
Uganda	Celtel Cellular MTN	641 01 641 10
Ukraine	Mobile comms Golden Telecom Radio Systems Kyivstar JSC	255 01 255 05 255 02 255 03
USA	Bell South Sprint Spectrum Voice Stream Aerial Comms. Omnipoint Powertel Wireless 2000	310 15 310 02 310 26 310 31 310 16 310 27 310 11
Uzbekistan	Daewoo GSM Coscom Buztel	434 04 434 05 434 01
Vatican	Omnitel Telecom Italia Mobile Wind	222 10 222 01 222 88
Venezuela	Infonet Digitel	734 01 734
Vietnam	MTSC DGPT	452 01 452 02
Yugoslavia	Mobile Telekom Promonte Telekom Serbia	220 01 220 02 220 03
Zaire	African Telecom Net	630
Zimbabwe	NET*ONE Telecel Zimbabwe	648 01 648 04

好消息，Blackberry开发文档基础篇发布。

Taigoo — Mon, 28 Jul 2008 09:08:22 +0000

经过前期在3个位置的调查，最终选用PDF作为文档格式。

直接点击下面下载。

BlackBerry 应用程序开发者指南第二卷：高级–第12章管理应用程序

Taigoo — Mon, 28 Apr 2008 22:17:57 +0000

第12章管理应用程序

应用程序管理器

管理代码模块

应用程序管理器

BlackBerry设备VM有一个应用程序管理器,它的功能和对于其他Java程序的操作系统事件调动中心一样.

net.rim.device.api.system.ApplicationManager类使应用程序可以和应用程序管理器交互,并完成下面的操作:

与进程交互,例如获取前台应用程序的ID.
发送一个全局事件给系统.
锁住或解锁BlackBerry设备,或判断BlackBerry设备是否锁住.
立即运行一个程序,或者在一个特定的时间运行应用程序.

为了使用ApplicationManager类的任何方法,你必须获取一个当前应用程序管理器的引用.调用getApplicationManager()获得当前应用程序管理器.

ApplicationManager manager = ApplicationManager.getApplicationManager();

获取应用程序的相关信息

调用静态方法ApplicationManager.getVisibleApplications()获取当前运行的进程信息.例如,你可以编写一个系统管理应用程序来记录BlackBerry设备的状态,以决定用户使用每个应用程序所花费的时间.

对于正在运行的可见应用程序,为获取一组ApplicationDescriptor对象,调用getVisibleApplications().一个ApplicationDescriptor对象包含了应用程序的描述性信息,例如它的名称,图标,主(Home)屏幕的位置,以及资源包(bundle).使用ApplicationDescriptor方法获取这个信息.例如,为获取一个运行应用程序的名称,调用一个应用程序描述(descriptor)上的getName()方法.

ApplicationManager manager = ApplicationManager.getApplicationManager();

ApplicationDescriptor descriptors[] = manager.getVisibleApplications();

// Retrieve the name of a running application.

String appname1 = descriptors[0].getName()

为当前应用程序获取一个ApplicationDescriptor,调用

ApplicationDescriptor.currentApplicationDescriptor().

ApplicationDescriptor descriptor =

ApplicationDescriptor.currentApplicationDescriptor();

String appname = descriptor.getName();

发布一个全局事件

使用ApplicationManager.postGlobalEvent()作为基本机制和其他进程进行通讯.

注:你也可以使用运行时存储发送和接收进程间的消息.为获得更多信息,参看135页的”在应用程序之间共享运行时对象”.

为了发布一个全局事件到指定的应用程序中,调用postGlobalEvent(int, long, int, int, Object, Object).

processID参数指定了进程的ID发送事件.为获取一个进程ID,调用getProcessId(ApplicationDescriptor). guid参数为事件指定一个GUID值.数据和对象为事件指定附加的信息.

为了对所有应用程序发送一个全局事件,使用下面形式之一的postGlobalEvent()方法:

方法	描述
boolean postGlobalEvent(long)	发布一个带有唯一标志符的全局事件.
boolean postGlobalEvent(long, int, int)	发布一个带有附加数据的全局事件.
abstract boolean postGlobalEvent(long, int, int, Object, Object)	发送一个带有附加整数和对象数据的全局事件.

接收一个全局事件

net.rim.device.api.system.GlobalEventListener接口的实现接收全局事件. GlobalEventListener.eventOccurred()的实现定义了当一个全局事件发生时所发生的事情.

调用Application.addGlobalEventListener(GlobalEventListener)注册你的实现.

锁住一个BlackBerry设备

>调用 ApplicationManager.lockSystem(true).

决定一个BlackBerry设备是否锁住

>调用ApplicationManager.isSystemLocked().

解锁一个BlackBerry设备

>调用ApplicationManager.unlockSystem(true).

用不同的参数运行一个应用程序

创建一个新的应用程序描述

.使用已经存在的ApplicationDescriptor作为一个模板.在main()里指定使用的参数.

ApplicationDescriptor template = ApplicationDescriptor.currentApplicationDescriptor();

String[] args = { "admin", "secure" };

ApplicationDescriptor newdescriptor = new ApplicationDescriptor(template, args);

ApplicationDescriptor 构造子有其他2种格式:

签名	描述
ApplicationDescriptor(ApplicationDescriptor, String, String[])	此格式允许你为新的ApplicationDescriptor指定一个名称.
ApplicationDescriptor(ApplicationDescriptor, String, String[], Bitmap, int, String, int)	此格式允许你指定一个名称,初始设置,包括一个应用程序图标,主屏幕的位置,以及资源包,还有应用程序标题的ID.

运行应用程序

使用一个新的ApplicationDescriptor对象运行应用程序.

ApplicationManager appmanager = ApplicationManager.getApplicationManager();

try {

appmanager.runApplication(newdescriptor);

}

catch(ApplicationManagerException) {

// Handle the error.

}

runApplication()方法创建一个新的进程,并且调用一个指定的描述上的导出main()方法,以及使用它的参数.如果可能,新进程会转移到前台来.

在指定的时间运行一个应用程序

>调用scheduleApplication()代替runApplication().

try {

appmanager.scheduleApplication(newdescriptor, 1728000, false);

}

catch(ApplicationManagerException) {

// Handle the error.

}

scheduleApplication(ApplicationDescriptor, int, Boolean) 方法需要下面的参数:

ApplicationDescriptor对象.
启动应用程序的时间,毫秒计.
Boolean值,true表示时间是绝对的(从January 1, 1970 UTC午夜开始计算),false表示时间相对于本地午夜的时间.

注:在指定的时间前如果重启或关闭BlackBerry设备,此应用程序不会执行.

管理代码模块

CodeModuleManager类在net.rim.device.api.system里,它允许你获取相关信息,并且管理BlackBerry设备上的代码模块.

一个代码模块是一个.cod文件,它是BlackBerry IDE里单个工程编译的文件.为了查看安装在BlackBerry设备上的第三方应用程序列表,单击Appication.单击Propoerties菜单项查看关于每一个应用程序的信息.

获取模块信息

CodeModuleManager类提供方法使应用程序可以获取BlackBerry设备上的相关信息,例如名称,类型,描述,版本以及创建日期.

为获取一个模块的句柄,调用getModuleHandle().将代码模块名作为一个参数.

int handle = CodeModuleManager.getModuleHandle("test_module");

调用CodeModuleManager类的方法获取指定的信息.

将模块句柄作为参数传给这些方法.

String name = CodeModuleManager.getModuleName( handle );

String vendor = CodeModuleManager.getModuleVendor( handle );

String description = CodeModuleManager.getModuleDescription( handle );

int version = CodeModuleManager.getModuleVersion( handle );

int size = CodeModuleManager.getModuleCodeSize( handle );

int timestamp = CodeModuleManager.getModuleTimestamp( handle );

获取一组句柄

为获取BlackBerry设备上所有存在的模块句柄,调用getModuleHandles()

int handles[] = CodeModuleManager.getModuleHandles();

String name = CodeModuleManager.getModuleName( handles[0]);

net.rim.device.api.system.CodeModuleManager类提供方法创建,保存,删除代码模块.这些功能允许一个BlackBerry设备上的应用程序可以无线接收.cod文件.

代码模块管理器方法

方法	描述
int handle = CodeModuleManager.getModuleHandleForObject( anObject );	此方法获取一个对象模块的句柄,在此模块里定义一个对象.
boolean library = CodeModuleManager.isLibrary( handle );	此方法决定一个模块是否为类库,如果是返回true,如果是应用程序返回false.
int size = CodeModuleManager.getModuleHandleForObject( anObject);	决定了模块包含的代码的大小(字节).
ApplicationDescriptor descriptors[] = CodeModuleManager.getApplicationDescriptiors( handle );	获得一组代码模块包含的所有描述.

创建一个模块

>调用createNewModule().将模块的大小(字节)作为参数:

int handle = CodeModuleManager.createNewModule( 3000 );

此方法返回模块的句柄,否则,如果不能创建模块,返回0.

当你创建模块时,为了将数据增加到其中,调用下面形式的createNewModule().将整个模块的时长度(字节)作为参数,一个字节数据将加到模块中, length参数指定了从增加的字节数组到模块开始的字节数.

static int createNewModule(int, byte[], int);

将数据写入模块

>调用writeNewModule().将数据的字节数组作为参数提供给本方法.

boolean success = CodeModuleManager.writeNewModule( handle, data, 0, data.length );

saveNewModule(int)返回CodeModuleManager类定义的结果代码之一,例如如果模块保存成功,返回CMM_OK.

从BlackBerry设备数据库删除一个模块

调用deleteModuleEx(int, Boolean).将模块的句柄作为参数删除,一个Boolean值指定是否删除模块和它包含的数据,或仅删除没有相关数据的模块.如果模块正在使用,它将在BlackBerry下次重启时删除.

int handle = CodeModuleManager.getModuleHandle("test_module");

if( handle != 0 ) {

Boolean success = CodeModuleManager.deleteModule( handle, true );

}

Last Updated:2007年2月6日

BlackBerry 应用程序开发者指南第二卷：高级–第13章应用程序间共享运行时对象

Taigoo — Mon, 28 Apr 2008 22:15:32 +0000

第13章应用程序间共享运行时对象

共享运行时对象

共享运行时对象

注: 当应用程序第一次访问运行时存储时,检查一个 NoClassDefFoundError.如果系统管理员通过应用程序控制限制访问运行时存储,将抛出此错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级第1卷:基础.

BlackBerry设备使用一个运行时存储提供一个中心位置,在此位置上应用程序可以共享运行时对象.缺省的,仅由RIM数字签名的应用程序才可以访问运行时存储上的数据.联系RIM获得关于如何控制访问你的数据的信息.

获取运行时存储

>调用RuntimeStore.getRuntimeStore().

RuntimeStore store = RuntimeStore.getRuntimeStore();

为增加或获得运行时对象,调用RuntimeStore上的方法.

注:运行时存储不是持久的,如果BlackBerry重启,运行时存储的数据将丢失.

增加一个运行时对象

>调用RuntimeStore.put(long, String). 将一个唯一long ID和存储的对象作为参数.

RuntimeStore store = RuntimeStore.getRuntimeStore();

// Create an object and a unique number to identify the object.

String msg = "Some shared text";

long ID = 0×60ac754bc0867248L;

// put() throws an IllegalArgumentException if an object with the same ID exists.

try {

store.put( ID, msg );

}

catch(IllegalArgumentException e) {

// Handle exception - an object with the same ID exists.

}

替换一个运行时对象

>调用 replace().

RuntimeStore store = RuntimeStore.getRuntimeStore();

String newmsg = "Some new text";

try {

// Returns the existing object with the specified ID if it exists; null

// otherwise.

Object obj = store.replace( 0×60ac754bc0867248L, newmsg);

}

catch(ControlledAccessException e) {

// Handle exception - insufficient permissions.

}

获取一个注册的运行时对象

>调用RuntimeStore.get(). 将对象ID作为参数.

RuntimeStore store = RuntimeStore.getRuntimeStore();

// get() throws a ControlledAccessException if your application does not have read access to the specified object.

try {

// get() returns the objectm with the specified ID if it exists; null

// otherwise.

Object obj = store.get(0×60ac754bc0867248L);

}

catch(ControlledAccessException e) {

// Handle exception.

}

获取一个未注册的运行时对象

>调用RuntimeStore.waitFor() 等待一个运行时对象注册.

RuntimeStore store = RuntimeStore.getRuntimeStore();

try {

Object obj = store.waitFor(0×60ac754bc0867248L);

}

catch(ControlledAccessException e) {

// Handle exception - insufficient permissions.

}

catch(RuntimeException e) {

// Handle exception - time out.

}

注如果指定ID的对象不存在, waitFor()会阻止一个MAX_WAIT_MILLIS的最大数.如果此时对象还没有注册, waitFor()将会抛出一个RuntimeException异常.

Last Updated:2007年2月6日

BlackBerry 应用程序开发者指南第二卷：高级–第11章管理通知(Notification)

Taigoo — Mon, 28 Apr 2008 22:04:50 +0000

第11章管理通知(Notification)

通知API

增加事件

响应事件

自定义系统的通知

通知API

通知API(net.rim.device.api.notification)让你可以为你的应用程序增加自定义事件,并且当自定义事件发生时,又允许你定义用户接收的通知类型.

注:当你的应用程序第一次访问通知API时,它将检查一个ControlledAccessException.如果系统管理员使用应用程序控制限制访问通知API,一将抛出个运行时异常.为获取更多信息,参看”BlackBerry应用程序开发者指南 第2卷:高级 第一卷:基础”.

通知事件类型	描述
短暂事件	系统通知,例如LED闪烁,振动或铃声.
延续事件	应用程序指定的通知,例如一个UI.

对于短暂事件,只要事件一发生,BlackBerry设备就会使用一个系统通知, 例如LED闪烁,振动或铃声,尽快将消息发送给用户.应用程序不可以请求一指定类型的通知.在手持设备配置(Profile)列表里,用户通过选择一个活动的配置和设置配置选项来控制它们如何接收短暂事件的通知.为了将一个自定义的系统通知加入到短暂事件,请实现Consequence接口.

在延续的事件里,BlackBerry设备根据事件的优先级将它们安排在一个队列里.当事件发生时,事件影响的应用程序可能为用户提供一个自定义的通知,一般是通过显示一个用户界面(UI)元素,例如一个对话框来完成.为了监听延续的事件,实现NotificationsEngineListener接口.BlackBerry设备不会为延续事件提供一个系统级的通知.

增加事件

注册一个新的事件源

创建一个唯一long ID

为每个通知事件定义一个long ID.

public static final long ID_1 = 0xdc5bf2f81374095L;

注:使用BlackBerry IDE将一个String转化为一个long,为你的应用程序创建一个long的标记符:

1.在BlackBerry IDE文本里,输入一个字符串.
2.选择字符串,右击,然后单击Convert “string” to Long.

定义一个源对象

定义一个为事件提供源的对象. toString()的实现返回显示在配置列表里的字符串.

Object event = new Object() {

public String toString() {

return "Notification Demo";

}

将你的应用程序注册一个通知源

为了将你的应用程序作为一个事件源加入到手持设备的配置列表里,调用NotificationsManager.registerSource().在此方法里,指定一个唯一的事件ID,源对象以及通知级别.

通知级别设置了事件的优先级,它决定了延续事件发生的顺序.以最高级到最低级的顺序,级别如下:

NotificationsConstants.CRITICAL
NotificationsConstants.SENSITIVE
NotificationsConstants.IMPORTANT
NotificationsConstants.DEFAULT_LEVEL
NotificationsConstants.CASUAL

注:优先级仅适用于延续事件.只要短暂事件触发,它们就会发生.当触发一个延续事件时,指定一个过期时间.如果事件在最高级事件之前已经过期,用户可能不会接收到此最低级事件的通知.

当BlackBerry设备启动时注册事件源

为了注册一个事件源,创建一个带有libMain()的工程,在BlackBerry设备启动时进行注册.

创建一个类库工程

1.在BlackBerry IDE, 创建一个工程.

2.右击工程,单击Properties.

3.单击 Application标签.

4.在Project type 下拉列里,单击Library.

5.选择Auto-run on startup.

6.单击OK.

7.定义libMain().

public static final long ID_1 = 0xdc5bf2f81374095L;

public static final Object event = new Object() {

public String toString()

{

return "Sample Notification Event #1";

}

};

public static void libMain(String[] args) {

NotificationsManager.registerSource(ID_1, event,

NotificationsConstants.CASUAL);

}

触发一个短暂事件

调用triggerImmediateEvent().短暂事件由标准的系统通知描述,例如铃声,振动,或LED.

NotificationsManager.triggerImmediateEvent(ID_1, 0, this, null);

triggerImmediateEvent方法接受下面的参数:

参数	描述
sourceID	启动事件(当调用registerSource()时指定)的应用程序的标志符.
eventID	应用程序事件标志符.
eventReference	应用程序事件cookie.
context	可选的上下文对象.

在大多数情况下,不要使用短暂事件,因为BlackBerry设备事件通知不会充分说明发生了什么事情.例如,如果BlackBerry设备振动,对于用户来说,它将很难知道到底是在你的应用程序里发生了一个事件,还是一个新消息已经到达了.如果你使用了短暂消息,考虑实现一个自定义的通知,例如一个特殊的铃声,来区分你的应用程序事件和其他BlackBerry设备事件.为获取更多信息,参看122页的”自定义系统通知”.

触发一个延续事件

调用negotiateDeferredEvent().一个延续事件让你的应用程序以一个UI元素,例如一个对话框通知用户

NotificationsManager.negotiateDeferredEvent(ID_1, 0, this, -1,

NotificationsConstants.MANUAL_TRIGGER, null);

negotiateDeferredEvent(long, long, Object, long, int, Object) 方法接受下面的参数:

参数	描述
sourceID	启动事件(当调用registerSource()时指定)的应用程序的标志符.
eventID	应用程序事件标志符.
eventReference	应用程序事件cookie.
timeout	事件过期时间,以毫秒计,当调用方法时的相对时间(忽略过期时间,除非trigger是OUT_OF_HOLSTER_TRIGGER)
trigger	要么是NotificationsConstants.OUT_OF_HOLSTER_TRIGGER,它指定了当BlackBerry设备和计算机断开时的事件,要么是NotificationsConstants.MANUAL_TRIGGER,它指定了应用程序本身触发事件.
context	可选对象,可以存储附加的,任意的参数来控制事件通知的状态或者行为.

如果你调用negotiateDeferredEvent(long, long, Object, long, int, Object),你的应用程序必须实现NotificationEventListener来监听事件并充分响应它.为获取更多信息,参看121页的”响应事件”.

取消一个事件

取消一个短暂事件

调用cancelImmediateEvent(long, long, Object, Object), 然后指定源以及事件ID．

NotificationsManager.cancelImmediateEvent(ID_1, 0, this, null);

取消一个延续事件

调用 cancelDeferredEvent(long, long, Object, int, Object), 然后指定源以及事件ID．

NotificationsManager.cancelDeferredEvent(ID_1, 0, this, NotificationsConstants.MANUAL_TRIGGER, null);

取消所有延续事件

调用cancelAllDeferredEvents(long, int, Object)方法取消所有应用程序启动的是延续事件.

NotificationsManager.cancelAllDeferredEvents(ID_1, NotificationsConstants.MANUAL_TRIGGER, null);

注.如果你调用negotiateDeferredEvent()方法,但没有指定过期事件,你必须调用cancelDeferredEvent()方法取消事件,否则事件永远不过期.

代码实例

例: NotificationDemo.java

/**

* NotificationsDemo.java

package com.rim.samples.docs.notifications;

import net.rim.device.api.notification.*;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import com.rim.samples.docs.baseapp.*;

public class NotificationsDemo extends BaseApp {

public static final long ID_1 = 0xdc5bf2f81374095L;

private long _eventIdGenerator;

private static Object er;

public static final Object event = new Object() {

public String toString() {

return "Sample Notification Event #1";

}

};

public static void main(String[] args) {

NotificationsManager.registerSource(ID_1, event, NotificationsConstants.CASUAL);

NotificationsManager.registerConsequence(ConsequenceDemo.ID,

new ConsequenceDemo());

NotificationsDemo app = new NotificationsDemo();

app.enterEventDispatcher();

}

public NotificationsDemo() {

MainScreen mainScreen = new MainScreen();

mainScreen.setTitle("Notification Demo App");

mainScreen.addKeyListener(this);

mainScreen.addTrackwheelListener(this);

NotificationsManager.registerNotificationsEngineListener(ID_1,

new NotificationsEngineListenerImpl(this));

pushScreen(mainScreen);

}

private MenuItem triggerItem = new MenuItem(null, 0, 100, 10) {

public void run() {

NotificationsManager.triggerImmediateEvent(ID_1, 0, this, null);

}

public String toString() {

return "Trigger event";

}

};

private MenuItem deferItem = new MenuItem(null, 0, 100, 10) {

public void run() {

long timeout = -1; // Ignored unless trigger is OUT_OF_HOLSTER_TRIGGER.

int trigger = NotificationsConstants.MANUAL_TRIGGER;

Object er = new Object();

NotificationsManager.negotiateDeferredEvent(ID_1, ++_eventIdGenerator,

er, timeout, trigger, null);

}

public String toString() {

return "Start deferred event";

}

};

private MenuItem cancelItem = new MenuItem(null, 0, 100, 10) {

public void run() {

int trigger = NotificationsConstants.MANUAL_TRIGGER;

NotificationsManager.cancelDeferredEvent(ID_1, _eventIdGenerator, er,

trigger, null);

}

public String toString() {

return "Cancel deferred event";

}

};

public void makeMenu( Menu menu, int instance ) {

menu.add(triggerItem);

menu.add(deferItem);

menu.add(cancelItem);

super.makeMenu(menu, instance);

}

public void onExit() {

System.exit(0);

}

private static class NotificationsEngineListenerImpl implements

NotificationsEngineListener {

private UiApplication _app;

}

public NotificationsEngineListenerImpl(UiApplication app) {

_app = app;

}

public void deferredEventWasSuperseded(long sourceID, long eventID,

Object eventReference, Object context) {

final long _eventID = eventID;

er = eventReference;

_app.invokeLater(new Runnable() {

public void run() {

NotificationsManager.cancelDeferredEvent(ID_1, _eventID, er,

NotificationsConstants.MANUAL_TRIGGER, null);

}

});

}

public void notificationsEngineStateChanged(int stateInt, long sourceID,

long eventID, Object eventReference, Object context) {

if(stateInt == NotificationsConstants.OUT_OF_HOLSTER_ENGINE_STATE) {

// Perform some action if handheld is removed from holster.

}

if(stateInt == NotificationsConstants.IN_HOLSTER_ENGINE_STATE) {

// Perform some action if handheld is inserted into holster.

}

public void proceedWithDeferredEvent(long sourceID, long eventID,

Object eventReference, Object context) {

final long _eventID = eventID;

}

_app.invokeLater(new Runnable() {

public void run() {

String s = "This event has occurred: " + _eventID;

Dialog d = new Dialog(Dialog.D_OK, s, Dialog.OK,

Bitmap.getPredefinedBitmap(Bitmap.INFORMATION), 0);

};

private MenuItem cancelItem = new MenuItem(null, 0, 100, 10) {

public void run() {

int trigger = NotificationsConstants.MANUAL_TRIGGER;

NotificationsManager.cancelDeferredEvent(ID_1,

_eventIdGenerator, er,trigger, null);

}

public String toString() {

return "Cancel deferred event";

}

};

public void makeMenu( Menu menu, int instance ) {

menu.add(triggerItem);

menu.add(deferItem);

menu.add(cancelItem);

super.makeMenu(menu, instance);

}

public void onExit() {

System.exit(0);

}

private static class NotificationsEngineListenerImpl

implements NotificationsEngineListener {

private UiApplication _app;

public NotificationsEngineListenerImpl(UiApplication app) {

_app = app;

}

public void deferredEventWasSuperseded(long sourceID,

long eventID,Object eventReference, Object context)

{

final long _eventID = eventID;

er = eventReference;

_app.invokeLater(new Runnable() {

public void run() {

NotificationsManager.cancelDeferredEvent(ID_1,

_eventID, er,

NotificationsConstants.MANUAL_TRIGGER, null);

}

});

}

public void notificationsEngineStateChanged(int stateInt, long sourceID,

long eventID, Object eventReference, Object context) {

if(stateInt == NotificationsConstants.OUT_OF_HOLSTER_ENGINE_STATE) {

// Perform some action if handheld is removed from holster.

}

if(stateInt == NotificationsConstants.IN_HOLSTER_ENGINE_STATE) {

// Perform some action if handheld is inserted into holster.

}

public void proceedWithDeferredEvent(long sourceID, long eventID,

Object eventReference, Object context) {

final long _eventID = eventID;

_app.invokeLater(new Runnable() {

public void run() {

String s = "This event has occurred: " + _eventID;

Dialog d = new Dialog(Dialog.D_OK, s, Dialog.OK,

Bitmap.getPredefinedBitmap(Bitmap.INFORMATION), 0);

d.show();

}

});

}

响应事件

NotificationsEngineListener的实现定义了自定义的通知.调用negotiateDeferredEvent()注册你的实现.如果你触发一个短暂事件,你没有必要为每个BlackBerry设备提供的标准系统通知实现监听者.

为延续事件提供一个自定义的UI通知

NotificationsEngineListener接口的实现为延续事件提供了一个自定义的UI通知.为获取关于创建UI的更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级 第一卷基础.

private static class ListenerImpl implements NotificationsEngineListener

{…}

定义挂起事件的行为

deferredEventWasSuperseded()的实现定义了当一个延续事件挂起时发生的事情.当一个事件由另外一个相同的或者优先级更高的事件挂起时,调用此方法.例如,如果事件挂起时,你可以取消此事件.

public void deferredEventWasSuperseded(long sourceID, long eventID,

Object eventReference, Object context) {

final long _eventID = eventID;

er = eventReference;

_app.invokeLater(new Runnable() {

public void run() {

NotificationsManager.cancelDeferredEvent(ID_1, _eventID, er,

NotificationsConstants.MANUAL_TRIGGER, null);

}

});

}

定义套座(holstering)行为

notificationsEngineStateChanged()的实现定义了套座的行为.当BlackBerry设备插入到套座或从套座移出时,调用此方法.例如,当安排了一个延续事件,并且BlackBerry设备和计算机已经相连或断开时,你可以完成一个指定的操作.

public void notificationsEngineStateChanged(int stateInt, long sourceID, long eventID, Object eventReference, Object context) {

if(stateInt == otificationsConstants.OUT_OF_HOLSTER_ENGINE_STATE) {

// Perform action if BlackBerry device is removed from holster.

}

if(stateInt == NotificationsConstants.IN_HOLSTER_ENGINE_STATE) {

// Perform action if BlackBerry device is inserted into holster.

}

定义通知

proceedWithDeferredEvent()的实现定义了当发生事件时如何通知用户,例如显示一个对话框.当监听者处理一个事件(没有其他更高优先级的事件在队列里)时,调用此方法.

public void proceedWithDeferredEvent(long sourceID, long eventID, Object eventReference,Object context) {

final long _eventID = eventID;

_app.invokeLater(new Runnable() {

public void run() {

String s = "This event has occurred: " + _eventID;

Dialog d = new Dialog(Dialog.D_OK, s, Dialog.OK,

Bitmap.getPredefinedBitmap(Bitmap.INFORMATION), 0);

d.show();

_eventHashtable.put(_eventID, d);

}

});

}

注册通知监听者

调用registerNotificationsEngineListener(int, NotificationsEngineListener)在NotificationsManager注册监听者.提供应用程序的事件源ID以及实现NotificationsEngineListener接口的类的实例作为参数.

NotificationsManager.registerNotificationsEngineListener( ID_1, new ListenerImpl(this));

注:每个应用程序只能注册一个NotificationsEngineListener

自定义系统通知

Consequence接口的实现为短暂事件创建了一个系统通知,例如特殊的铃声,或当发生事件,例如创建一个日志记录接收到的通知数时,进行其他的操作.

注:Consequence接口仅使用在需要系统通知的短暂事件上.延续事件需要你的应用程序实现NotificationsEngineListener接口,并且以一个特定的应用程序回应作为响应.

在主屏幕上提供一个应用程序,使用户可以设置通知选项.

响应一个通知事件

Consequence 和SyncConverter接口的实现对通知事件做出响应. Consequence接口定义了一个对通知事件做出的应用程序响应.SyncConverter接口定义了需要的功能将一个对象转化为序列化格式.这需要使BlackBerry设备可以备份和恢复Profile配置.为获得更多信息,参看90页的”BlackBerry持久存储”.

private static class ConsequenceImpl implements Consequence,SyncConverter {…}

定义一个唯一ID

为结果(consequence)定义一个唯一ID.

public static final long ID = 0xbd2350c0dfda2a51L;

定义常量

为应用程序定义DATA和TYPE常量.当convert()调用时,为了标记从SyncConverter进来的数据类型,使用这些常量.对于适合的应用程序的数据来说,它们是任意的标志符.

private static final int TYPE = ‘n’ << 24 | ‘o’ << 16 | ‘t’ << 8 | ‘d’;

private static final byte[] DATA = new byte[] {‘m’, ‘y’, ‘-’, ‘c’,

‘o’, ‘n’, ‘f’, ‘i’, ‘g’, ‘-’, ‘o’, ‘b’, ‘j’, ‘e’, ‘c’, ‘t’};

private static final Configuration CONFIG = new Configuration(DATA);

创建一个铃声

作为事件通知的一部分,创建一个铃声来播放.

private static final short BFlat = 466; // 466.16

private static final short TEMPO = 125;

private static final short d16 = 1 * TEMPO;

private static final short dpause = 10; // 10 millisecond pause

private static final short[] TUNE = new short[] {BFlat, d16, pause, BFlat};

private static final int VOLUME = 80; // Percentage volume.

定义一个通知

startNotification()的实现为本结果定义了通知.下面的代码实例里,LED将会闪烁,并且会播放一个铃声.

public void startNotification(long consequenceID, long sourceID, long eventID, Object configuration, Object context) {

LED.setConfiguration(500, 250, LED.BRIGHTNESS_50);

LED.setState(LED.STATE_BLINKING);

Alert.startAudio(TUNE, VOLUME);

Alert.startBuzzer(TUNE, VOLUME);

}

停止一个通知

stopNotification()的实现停止本结果的通知.

public void stopNotification(long consequenceID, long sourceID,

long eventID, Object configuration, Object context) {

LED.setState(LED.STATE_OFF);

Alert.stopAudio();

Alert.stopBuzzer();

}

设置用户Profile选项

newConfiguration()的实现创建一个新的配置对象来存储用户资料的设置.此对象传到结果的实现中,以决定用户指定的结果类型是否合适事件.下面的代码实例返回早期定义的CONFIG对象

public Object newConfiguration(long consequenceID, long sourceID,

byte profileIndex, int level, Object context) {

return CONFIG;

}

启动BlackBerry设备数据备份

SyncConverter.convert()的实现可以备份BlackBerry设备数据.当把BlackBerry设备上的数据备份到用户计算机上时,调用此方法.下面的实例从DatBuffer读取进入的数据,并且对未经处理的数据应用一个4个字节的类型和长度.

public SyncObject convert(DataBuffer data, int version, int UID) {

try {

int type = data.readInt();

int length = data.readCompressedInt();

if ( type == TYPE ) {

byte[] rawdata = new byte[length];

data.readFully(rawdata);

return new Configuration(rawdata);

}

catch (EOFException e) {

System.err.println(e);

}

return null;

}

启动BlackBerry设备数据恢复

SyncConverter.convert()的实现恢复BlackBerry设备上的数据.当数据从用户计算机上恢复到BlackBerry设备上时,调用此方法.

public boolean convert(SyncObject object, DataBuffer buffer, int version) {

boolean retval = false;

if ( object instanceof Configuration ) {

Configuration c = (Configuration)object;

buffer.writeInt(TYPE);

buffer.writeCompressedInt(c._data.length);

buffer.write(c._data);

retval = true;

}

return retval;

}

定义通知配置

创建一个类描述通知配置信息.此类实现了SyncObject和Persistable.你必须实现SyncObject.getUID()方法,但是如果数据同步不需要,你的实现可以返回0,正如下面的例子.

private static final class Configuration implements SyncObject, Persistable {

public byte[] _data;

public Configuration(byte[] data) {

_data = data;

}

public int getUID() {

return 0;

}

注册一个结果

如果你创建一个自定义的Consequence,调用registerNotificationsObjects(long, Consequence)方法将之在NotificationsManager上注册.

NotificationsManager.registerConsequence(ConsequenceImpl.ID, new ConsequenceImpl());

当BlackBerry设备启动时,为了注册consequence,在一个类库工程里完成这个注册.为获得更多信息,参看116页的”当BlackBerry启动时注册一个事件源”.

代码实例

例: ConsequenceDemo.java

/**

* ConsequenceDemo.java

package com.rim.samples.docs.notifications;

import net.rim.device.api.synchronization.*;

import net.rim.device.api.notification.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import java.io.*;

public class ConsequenceDemo implements Consequence, SyncConverter {

public static final long ID = 0xbd2350c0dfda2a51L;

private static final int TYPE = ‘n’ << 24 | ‘o‘ << 16 | ‘t‘ << 8 | ‘d‘;

private static final byte[] DATA = new byte[] {

‘m’, ‘y’, ‘-’, ‘c’, ‘o‘, ‘n‘, ‘f‘, ‘i’,

‘g’, ‘-‘, ‘o‘, ‘b‘, ‘j‘, ‘e‘, ‘c‘, ‘t‘ };

private static final Configuration CONFIG = new Configuration(DATA);

private static final short BFlat = 466; // The actual value is 466.16.

private static final short TEMPO = 125;

private static final short d16 = 1 * TEMPO;

private static final short pause = 10; // 10 millisecond pause.

private static final short[] TUNE = new short[] {BFlat, d16, pause, BFlat};

private static final int VOLUME = 80; // Percentage volume.

public void startNotification(long consequenceID, long sourceID, long eventID,

Object configuration, Object context) {

LED.setConfiguration(500, 250, LED.BRIGHTNESS_50);

LED.setState(LED.STATE_BLINKING);

Alert.startAudio(TUNE, VOLUME);

Alert.startBuzzer(TUNE, VOLUME);

}

public void stopNotification(long consequenceID, long sourceID, long eventID,

Object configuration, Object context) {

LED.setState(LED.STATE_OFF);

Alert.stopAudio();

Alert.stopBuzzer();

}

public Object newConfiguration(long consequenceID, long sourceID,

byte profileIndex, int level, Object context) {

return CONFIG;

}

public SyncObject convert(DataBuffer data, int version, int UID) {

try {

int type = data.readInt();

int length = data.readCompressedInt();

if ( type == TYPE ) {

byte[] rawdata = new byte[length];

data.readFully(rawdata);

return new Configuration(rawdata);

}

catch (EOFException e) {

System.err.println(e);

}

return null;

}

public boolean convert(SyncObject object, DataBuffer buffer, int version) {

boolean retval = false;

if ( object instanceof Configuration ) {

Configuration c = (Configuration)object;

buffer.writeInt(TYPE);

buffer.writeCompressedInt(c._data.length);

buffer.write(c._data);

retval = true;

}

return retval;

}

/* Inner class to store configuration profile. */

private static final class Configuration implements SyncObject, Persistable {

public byte[] _data;

public Configuration(byte[] data) {

_data = data;

}

public int getUID() {

return 0;

}

Last Updated:2007年2月5日

BlackBerry 应用程序开发者指南第二卷：高级–第10章访问安装和配置信息

Taigoo — Mon, 28 Apr 2008 22:00:56 +0000

第10章访问安装和配置信息

服务定制API

服务定制API(Service Book API)

服务定制API(net.rim.device.api.servicebook)使应用程序可以和BlackBerry基础(infrastructure)进行交互.服务定制由服务记录组成,每个服务定义了一个在BlackBerry设备上有效的服务.

服务记录定义了通讯协议(WAP或IPPP),网关,以及配置信息,例如浏览器设置.

服务定制API功能	描述
管理MDS服务连接	浏览器应用程序API可以使用任何一个带有BrowserConfig 的UID的ServiceBook入口,连接到一个无线网络.例如, Browser类使用服务定制获取一个BrowserSession. Browser.getTransportUid()查询一个服务定制来获取和一个给定服务记录相关联的UID.
管理mail信息	允许应用程序指定一个频道, 它引用合适的服务记录并通过此频道发送一个email.例如,应用程序可以使用BES或一个BlackBerry Internet Service选择发送消息..为获取更多信息,参看12页的”Mail API”.

为了查看BlackBerry设备上的服务定制,单击选项下的Service Book.

ServiceBook类维护一个ServiceRecord对象的集合.每个ServiceRecord对象由一个唯一的ID(UID)和连接ID(CID)标识.

CID	描述
CMIME	CMIME(compressed multi-purpose mail extensions,压缩多意图邮件扩展) CID定义了消息连接
ALP	ALP(address lookup protocol,地址查询协议) CID为无线GAL(Global Address List,全局地址列表)查询定义连接.
IPPP	IPPP(IP Proxy Protocol)使用BlackBerry® MDS Services定义HTTP连接.
BrowserConfig	BrowserConfig(浏览器配置)CID定义BlackBerry和WAP浏览器连接.
Sync	数据同步(Sync) CID为无线数据同步定义连接.
WAP	WAP(wireless application protocol) CID定义了WAP网关连接.
CICAL	CICAL(compressed iCalendar,压缩的iCalendar)为无线日历同步定义连接.

服务记录	描述
Desktop [CMIME]	此服务记录包含了使用桌面发送消息需要的信息.,也包含了完成其他功能需要的消息,例如无线消息调解.
Desktop [ALP]	此服务记录包含了完成无线GAB(Global Address Book)查询所需要的信息.
Desktop [IPPP]	此服务记录包含了通过MDS服务使用并且浏览Internet所要的信息.
Desktop [CICAL]	此服务包含了进行无线日历操作所需要的信息.
Desktop [BrowserConfig]	此服务记录包含了BlackBerry浏览器的配置信息.
Web Client [CMIME]	此服务记录包含了发送消息需要的信息.,也包含了使用BlackBerry Internet Service.进行其他功能(例如无线消息调解)所需要的消息.
WAP Secure Transport [WAP]	此服务记录包含了连接到服务商WAP网关所需要的信息.
WAP Browser [BrowserConfig]	此服务记录包含了WAP浏览器的配置信息.
Desktop [Sync]	此服务记录包含了完成数据同步所需要的信息.

监听服务定制事件

GlobalEventListener接口(在net.rim.device.api.system 包里)的实现使应用程序可以监听服务定制事件. 当接收到一个全局事件时,GlobalEventListener.eventOccurred()的实现指定了进行的操作.

为了注册一个全局事件监听者,调用Application.addGlobalEventListener(GlobalEventListener).

ServiceBook类定义了下面的事件,它们由一个GUID标识.

GUID	描述
GUID_SB_ADDED	当增加一个服务定制时发送的全局事件的GUID.
GUID_SB_BR_END	当服务定制备份或恢复结束时发送的全局事件的GUID.
GUID_SB_BR_START	当服务定制备份或恢复开始时发送的全局事件的GUID.
GUID_SB_CHANGED	当一个服务定制改变时发送的全局事件的GUID.
GUID_SB_OTA_SWITCH	当所有服务记录因为一个移动的BES命令OTA而被插入时发送的全局事件的GUID.
GUID_SB_OTA_UPDATE	当OTA为一个UID更新所有服务记录时发送的全局事件的GUID.
GUID_SB_REMOVED	当删除一个服务定制时发送的全局事件的GUID.

Last Updated:2007年2月5日

BlackBerry 应用程序开发者指南第二卷：高级–第8章存储持久数据

Taigoo — Mon, 28 Apr 2008 21:54:00 +0000

第8章存储持久数据

持久数据选项

管理持久数据

内存管理以及持久对象

管理客户对象

持久数据选项

在BlackBerry设备上，以下面的方式可以存储数据:

使用MIDP记录存储.
使用BlackBerry持久存储模型.

如果你想让你的应用程序可以在多个与Java ME兼容的设备上运行,那么采用MIDP的实现.如果你编写应用程序仅仅为BlackBerry设备,使用BlackBerry持久存储模型,因为它提供了一个更为灵活有效的方式存储数据,

MIDP存储记录

javax.microedition.rms包提供了MIDP记录存储的实现.持久数据存储在RecordStore对象里.一个记录存储最大可以为64KB.

数据的离散单元称为记录.一个记录是一个字节数组,赋给它一个唯一标志数.

创建一个记录存储

调用openRecordStore().指定true来描述当记录存储不存在时应该创建此记录存储.

RecordStore store = RecordStore.openRecordStore("Contacts", true);

注:当从BlackBerry设备删除一个应用程序时,所有此应用程序创建的记录存储都会删除.每个在MIDlet包(suite)的记录存储都有一个唯一名.MIDlet仅可以访问一个在相同包里的由MIDlet创建的记录存储.

增加一个记录

调用addRecord().

int id = store.addRecord(_data.getBytes(), 0, data.length());

获取一个记录

调用getRecord(int, byte[], int).给本方法提供一个记录ID,字节数组,以及一个偏移作为参数.

byte[] data = new byte[store.getRecordSize(id)];

store.getRecord(id, data, 0);

String dataString = new String(data);

获取所有记录

打开存储,然后获取其迭代.

RecordStore store = RecordStore.openRecordStore("Contacts", false);

RecordEnumeration e = store.enumerateRecords(null, null, false);

enumerateRecords(RecordFilter filter, RecordComparator comparator, Boolean keepUpdated) 方法有如下参数:

参数	描述
filter	此参数指定一个RecordFilter对象获取记录存储结果的子集(如果为null,将返回所有记录存储).
comparator	此参数指定一个RecordComparator对象决定返回记录所在的顺序位置(如果为null.将返回无序的记录).
keepUpdated	此参数决定对于记录存储,迭代保持当前的改变.

BlackBerry持久存储

在MIDP中的记录存储(RecordStore)与BlackBerry持久模型(PersistentStore)有2处主要的区别.

特性	描述
数据存储	MIDP记录仅以字节数组存储数据.相比之下,BlackBerry API允许你在持久存储中保存任何对象.这样,查询存储数据就会比记录模型更快一些.为了存储一个自定义的对象类型,自定义类型的类必须要实现Persistable接口.
数据共享	在MIDP中,每个RecordStore属于单个MIDlet包,并且MIDlet也只能访问由相同包的MIDlet创建的记录存储.尽管如此,在BlackBerry持久模型中,数据可以在应用程序之间共享,在创建数据的离散应用程序中共享.代码签名指定只有被认证的应用程序才可以访问这些数据.

注:BlackBerry持久性API在手持设备软件3.6或后期版本可用.对于早期的版本,你必须使用MIDP记录存储.

保留存储空间

BlackBerry的存储空间是有限的.你应该小心设计你的程序,将需要存储持久数据的闪存数量最小化.

在一般的BlackBerry里,对于一个标准的BlackBerry应用程序,不需要的存储空间必须在所有应用程序之间共享,用来存储用户数据,包含日历约会,联系人,以及消息.

如果BlackBerry设备在一个小内存情况下操作,它有可能完成下面的动作释放内存空间:

从BlackBerry上删除以前的消息.
从BlackBerry 设备上删除超过一个星期的日历约会(如果启动了无线日历同步).

如果因低内存而BlackBerry设备删除了消息或者日历约会,那么在桌面消息程不会删除数据.为获的更多信息,参看96页的”内存管理以及持久对象”.

注:用户点击设备选项的Status可以查看当前可用的数据空间.

备份与恢复

在net.rim.device.api.synchronization包中,同步(synchronization)API允许你备份以及恢复BlackBerry设备上的持久数据.为获取更多信息,参看104页的”增加支持备份持久数据”.

安全

缺省的,BlackBerry上由RIM数字签名的应用程序可以访问持久存储上的数据,联系RIM获取关于控制数据访问的信息.

管理工具

在BES 3.5 Microsoft® Exchange SP2或 BES 2.2 M® Lotus® Domino®里,系统管理员可以使用IT策略控制第三方应用程序访问持久存储.

管理员可以设置应用程序控制项ALLOW_USE_PERSISTENT_STORE为TRUE或FALSE.缺省的,第三方应用程序可以使用持久存储(ALLOW_USE_PERSISTENT_STORE为TRUE)

注:这个策略对MIDP记录存储没有影响.

数据完整性

为了维护持久存储数据的完整性,如果在提交时发生一个错误,不会更新局部.

注:因低内存VM完成一个紧要的垃圾回收时,数据完整性会折中.在这样的情况下,当BlackBerry设备提交时,部分完成的事务会提交.在正常垃圾回收下未提交的事务不会提交.

管理持久数据

持久数据类型

如果一个自定义数据类型类实现了Persistable类接口,那么此数据类型可以持久保存.小面原生数据类型也可以持久存储.

java.lang.Boolean
java.lang.Byte
java.lang.Character
java.lang.Integer
java.lang.Long
java.lang.Object
java.lang.Short
java.lang.String
java.util.Vector
java.util.Hashtable

注:当你持久化一个对象时,此对象引用的任何对象也可以持久化.

创建一个持久化数据库

每个应用程序一般可以创建单个PersistentObject.此对象是应用程序的持久化数据以及索引的根数据库.应用程序将保存数据到此PersistentObject中.

注:使用一个静态的构造子,这样PersistentObject只创建一次,即此类的一个对象第一次创建时.每次一个进程开始时,它包含的静态块再一次运行.

一个唯一的long键标志了每个PersistentObject.此键一般为一个全权包名的哈希

注:当一个应用程序从BlackBerry删除时,所有此应用程序创建的持久化对象也将删除.

创建一个唯一的long键

1. 在BlackBerry IDE里,输入一个字符串,例如com.rim.samples.docs.userinfo.

2. 选择此字符串.

3. 右击,然后单击Convert ‘com.rim.samples.docs.userinfo’ to long. long值将会出现.
注:在你的代码加入注释表明用来生成long键的字符串..

static PersistentObject store;

static {

store = PersistentStore.getPersistentObject( 0xa1a569278238dad2L );

}

持久存储数据

为了将数据保存到持久存储里,调用PersistentObject上的setContents().此方法用新的值替代已存在的值.调用commit()保存到持久存储里,
注:如果在提交的过程中发生一个错误,已经完成的更新不会提交.在PersistentObject里的数据从最后一次提交中获取值,以保持数据的完整性.

String[] userinfo = {username, password};

synchronized(store) {

store.setContents(userinfo);

store.commit();

}

如果你有许多对象需要提交到存储里,你可以以一个批事务的形式提交它们.为了实现此,调用PersistentStore.getSynchObject()方法获取持久存储监视器紧锁对象.然后同步对象,如果必要,调用commit()方法.当你释放监视对象的同步时,你的所有事务一次性被提交.如果批处理有任何提交失败,整个批提交也失败.当你同步监视器对象时,如果你调用forceCommit(),这个对象立即提交,并且它不再时批事务中的一部分了.

获取持久数据

调用 PersistentObject 上的getContents() 方法.

将 PersistentObject.getContents()返回的对象显式的转化为你需要的类型.

synchronized(store) {

String[] currentinfo = (String[])store.getContents();

if(currentinfo == null) {

Dialog.alert(_resources.getString(APP_ERROR));

}

else {

currentusernamefield.setText(currentinfo[0]);

currentpasswordfield.setText(currentinfo[1]);

}

注:当一个应用程序第一次访问数据据,它应该验证任何索引的顺序,如果出现一个问题,重新创建索引.应用程序应该能够识别并更正任何毁坏的或者丢失的数据的问题.为获得更对信息,参看91页的”数据完整性”.

删除一个数据库

为了删除一个数据库,调用PersistentStore.destroyPersistentObject().提供一个PersistentObject的唯一键作为参数,
注: PersistentObject作为应用程序的根数据库使用.你删除它,你将删除所有此应用程序存储的持久化数据如果定义了一个PersistentStore.cod文件删除了,所有由此.cod文件创建的持久化对象也将删除.

为了删除单独的数据,把它们简单的当成普通数据看待,并删除这些数据的引用.垃圾数据会自动回收。

代码实例

本代码实例描述了如何为用户创建一个应用程序来查看它们当前的用户名和密码,输入一个新的用户名和密码,然后保存变化.

例: UserInfo.java

/**

* UserInfo.java

package com.rim.samples.docs.userinfo;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import java.util.*;

import net.rim.device.api.i18n.*;

import com.rim.samples.docs.baseapp.*;

import com.rim.samples.docs.resource.*;

public class UserInfo extends BaseApp

implements UserInfoResource,KeyListener, TrackwheelListener {

private static PersistentObject store;

private static ResourceBundle _resources;

private AutoTextEditField usernamefield;

private PasswordEditField passwordfield;

private AutoTextEditField currentusernamefield;

private AutoTextEditField currentpasswordfield;

static {

_resources = ResourceBundle.getBundle(

UserInfoResource.BUNDLE_ID, UserInfoResource.BUNDLE_NAME);

store = PersistentStore.getPersistentObject(0xa1a569278238dad2L);

}

private MenuItem saveItem = new MenuItem( _resources.getString(MENUITEM_SAVE), 110, 10) {

public void run() {

String username = usernamefield.getText();

String password = passwordfield.getText();

String[] userinfo = {username, password};

synchronized(store) {

store.setContents(userinfo);

store.commit();

}

Dialog.inform(_resources.getString(APP_SUCCESS));

usernamefield.setText(null);

passwordfield.setText(null);

}

};

private MenuItem getItem = new MenuItem( _resources.getString(MENUITEM_GET), 110, 11 ) {

public void run() {

synchronized(store) {

String[] currentinfo = (String[])store.getContents();

if(currentinfo == null) {

Dialog.alert(_resources.getString(APP_ERROR));

}

else {

currentusernamefield.setText(currentinfo[0]);

currentpasswordfield.setText(currentinfo[1]);

}

};

public static void main(String[] args) {

UserInfo app = new UserInfo();

app.enterEventDispatcher();

}

public UserInfo() {

MainScreen mainScreen = new MainScreen();

mainScreen.setTitle(new LabelField(

_resources.getString(APPLICATION_TITLE)));

usernamefield = new AutoTextEditField(

_resources.getString(FIELD_NAME), "");

passwordfield = new PasswordEditField(

_resources.getString(FIELD_PASSWORD),"");

currentusernamefield = new AutoTextEditField(

_resources.getString(FIELD_CURRENTNAME), "");

currentpasswordfield = new AutoTextEditField(

_resources.getString(FIELD_CURRENTPASSWORD),"");

SeparatorField separator = new SeparatorField();

mainScreen.add(usernamefield);

mainScreen.add(passwordfield);

mainScreen.add(separator);

mainScreen.add(currentusernamefield);

mainScreen.add(currentpasswordfield);

mainScreen.addKeyListener(this);

mainScreen.addTrackwheelListener(this);

pushScreen(mainScreen);

}

public void makeMenu( Menu menu, int instance ) {

menu.add(saveItem);

menu.add(getItem);

super.makeMenu(menu, 0);

}

public void onExit() {

Dialog.alert(_resources.getString(APP_EXIT));

}

内存管理和持久化对象

在BlackBerry设备上有固定数量的持久化对象句柄以及对象句柄.

闪存	持久化对象句柄	对象句柄
8 MB	12,000	24,000
16 MB	27,000	56,000
32 MB	65,000	132,000

BlackBerry设备上的每个持久化对象都会要求一个持久化对象句柄以及一个对象句柄.例如,一个记录包含了10个String字段,那么它将要求11个对象句柄-一个为记录,一个为每个String.如果记录是持久化的,它将需要额外的11个持久化对象句柄.

使用下面的技术限制应用程序需要的持久化对象句柄数:

如果可能,使用原始类型代替对象.一个原始类型,例如一个int或者一个char,它们不需要一个对象句柄.
使用对象分组API (net.rim.device.api.system.ObjectGroup)将对象分组.一个分组的对象仅需要一个对象句柄.

注:分组的对象是可读的.在做出改变之前调用ObjectGroup.expandGroup()撤销对象的分组.在完成改变之后,调用ObjectGroup.createGroup()将对象分组.必要时仅撤销对象的分组,当撤销对象分组时有性能将受到损耗,因为系统创建了分组对象的一个拷贝,并且将句柄分配给每个组里的对象.

为获取更多信息,参看”BlackBerry JDE最佳内存实践”白皮书.

管理自定义对象

创建一个数据库

创建一个Vector对象存储多个对象.创建一个PersistentObject作为应用程序的根数据库.

private static Vector _data;

PersistentObject store;

static {

store = PersistentStore.getPersistentObject( 0xdec6a67096f833cL );

//key is hash of test.samples.restaurants

_data = (Vector)store.getContents();

synchronized (store) {

if (_data == null) {

_data = new Vector();

store.setContents(_data);

store.commit();

}

持久存储数据

可以持久化实现了Persistable接口的对象.

下面的代码实例作为inner类实现Persistable接口.它定义了一个带有4个Object的数组来存储餐厅名,地址,电话号码,以及特色.并且定义了方法来获取和设置Object元素值.

注:一个类为了其对象,必须显式的实现Persistable接口来也就存储. 甚至其子类也适用这个需求.例如类A实现了Persistable接口,并且A有一个子类B,B的对象不能持久存储,除非B也实现Persistable接口.

private static final class RestaurantInfo implements Persistable {

private String[] _elements;

public static final int NAME = 0;

public static final int ADDRESS = 1;

public static final int PHONE = 2;

public static final int SPECIALTY = 3;

public RestaurantInfo() {

_elements = new String[4];

for ( int i = 0; i < _elements.length; ++i) {

_elements[i] = new String("");

}

public String getElement(int id) {

return _elements[id];

}

public void setElement(int id, String value) {

_elements[id] = value;

}

创建扩展的对象

下面的方法允许你加入字段到对象中:

在一个int中,存储Boolean值做为bit.保留多余的位供将来使用.
直接存储String,但是使用一个键/值对的Vector或Hashtable,这样附加的(或很少使用的)的字段也可以增加.
如果你由一个表的索引,将他们存储在一个Vector或数组里,这样你可以增加未来的索引了.

保存一个对象

定义一个对象

下面的代码实例创建一个RestaurantInfo对象,并且使用它的设置方法来定义他的组件.

RestaurantInfo info = new RestaurantInfo();

info.setElement(RestaurantInfo.NAME, namefield.getText());

info.setElement(RestaurantInfo.ADDRESS,addressfield.getText());

info.setElement(RestaurantInfo.PHONE, phonefield.getText());

info.setElement(RestaurantInfo.SPECIALTY, specialtyfield.getText());

将一个对象加到一个Vector

调用addElement().

_data.addElement(info);

保存一个更新的对象

调用PersistentObject的setContents(),然后调用commit()方法保存一个更新的对象

synchronized(store) {

store.setContents(_data);

store.commit();

}

注: 当你做出改变时,同步一个持久对象,这样其他的线程在同一时间就不能做出改变.

获取一个对象

为了获取最近保存的对象,调用_data.lastElement().

public void run() {

synchronized(store) {

_data = (Vector)store.getContents();

if (!_data.isEmpty()) { RestaurantInfo info = (RestaurantInfo)_data.lastElement();

namefield.setText(info.getElement(RestaurantInfo.NAME));

addressfield.setText(info.getElement(RestaurantInfo.ADDRESS));

phonefield.setText(info.getElement(RestaurantInfo.PHONE));

specialtyfield.setText(info.getElement(

RestaurantInfo.SPECIALTY));

}

代码实例

本实例描述了如何创建一个应用程序,它允许用户存储一个关于喜爱的餐厅信息.

本实例也允许用户保存多个餐厅的信息,并且可以查看最新保存的餐厅信息.

例: Restaurants.java

/* Restaurants.java

package com.rim.samples.docs.restaurants;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import java.util.*;

import net.rim.device.api.i18n.*;

import net.rim.blackberry.api.invoke.*;

import net.rim.blackberry.api.browser.*;

import com.rim.samples.docs.baseapp.*;

import com.rim.samples.docs.resource.*;

public class Restaurants extends BaseApp

implements RestaurantResource,KeyListener, TrackwheelListener {

private AutoTextEditField namefield;

private AutoTextEditField addressfield;

private EditField phonefield;

private EditField websitefield;

private EditField specialtyfield;

private static Vector _data;

private static PersistentObject store;

private static ResourceBundle _resources;

private MenuItem saveItem = new MenuItem(_resources.getString(MENUITEM_SAVE), 110, 10) {

public void run() {

RestaurantInfo info = new RestaurantInfo();

info.setElement(RestaurantInfo.NAME, namefield.getText());

info.setElement(RestaurantInfo.ADDRESS, addressfield.getText());

info.setElement(RestaurantInfo.PHONE, phonefield.getText());

info.setElement(RestaurantInfo.WEBSITE, phonefield.getText());

info.setElement(RestaurantInfo.SPECIALTY,

specialtyfield.getText());

_data.addElement(info);

synchronized(store) {

store.setContents(_data);

store.commit();

}

Dialog.inform(_resources.getString(APP_SUCCESS));

namefield.setText(null);

addressfield.setText(null);

phonefield.setText("");

websitefield.setText("");

specialtyfield.setText("");

}

};

private MenuItem getItem = new MenuItem(_resources.getString(MENUITEM_GET), 110, 11) {

public void run() {

synchronized(store) {

_data = (Vector)store.getContents();

if (!_data.isEmpty()) {

RestaurantInfo info = (RestaurantInfo)_data.lastElement();

namefield.setText(info.getElement(RestaurantInfo.NAME));

addressfield.setText(info.getElement(RestaurantInfo.ADDRESS));

phonefield.setText(info.getElement(RestaurantInfo.PHONE));

websitefield.setText(info.getElement(RestaurantInfo.WEBSITE));

specialtyfield.setText(info.getElement(RestaurantInfo.SPECIALTY));

}

};

private MenuItem phoneItem = new MenuItem(_resources.getString(MENUITEM_PHONE), 110, 12) {

public void run() {

synchronized(store) {

String phoneNumber = phonefield.getText();

if ( phoneNumber.length() == 0) {

Dialog.alert(_resources.getString(ALERT_NO_PHONENUMBER));

}

else {

PhoneArguments call =

new PhoneArguments(PhoneArguments.ARG_CALL, phoneNumber);

Invoke.invokeApplication(Invoke.APP_TYPE_PHONE, call);

}

};

private MenuItem browserItem =

new MenuItem(_resources.getString(MENUITEM_BROWSER), 110, 12) {

public void run() {

synchronized(store) {

String websiteUrl = websitefield.getText();

if (websiteUrl.length() == 0) {

Dialog.alert(_resources.getString(ALERT_NO_WEBSITE));

}

else {

BrowserSession visit = Browser.getDefaultSession();

visit.displayPage(websiteUrl);

}

};

static {

_resources = ResourceBundle.getBundle(

RestaurantResource.BUNDLE_ID,

RestaurantResource.BUNDLE_NAME);

store = PersistentStore.getPersistentObject(0xdec6a67096f833cL);

// Key is hash of test.samples.restaurants.

synchronized (store) {

_data = (Vector)store.getContents();

if (_data == null) {

_data = new Vector();

store.setContents( _data );

store.commit();

}

public static void main(String[] args) {

Restaurants app = new Restaurants();

app.enterEventDispatcher();

}

private static final class RestaurantInfo implements Persistable {

// Data.

private String[] _elements;

// Fields.

public static final int NAME = 0;

public static final int ADDRESS = 1;

public static final int PHONE = 2;

public static final int WEBSITE = 3;

public static final int SPECIALTY = 4;

public RestaurantInfo() {

_elements = new String[4];

for ( int i = 0; i < _elements.length; ++i) {

_elements[i] = new String("");

}

public String getElement(int id) {

return _elements[id];

}

public void setElement(int id, String value) {

_elements[id] = value;

}

public Restaurants() {

MainScreen mainScreen = new MainScreen();

mainScreen.setTitle(new LabelField(

_resources.getString(APPLICATION_TITLE)));

namefield = new AutoTextEditField(

_resources.getString(FIELD_NAME), "");

addressfield = new AutoTextEditField(

_resources.getString(FIELD_ADDRESS), "");

phonefield = new EditField(

_resources.getString(FIELD_PHONE), "", Integer.MAX_VALUE,

BasicEditField.FILTER_PHONE);

websitefield = new EditField(

_resources.getString(FIELD_WEBSITE), "",

Integer.MAX_VALUE,BasicEditField.FILTER_URL);

specialtyfield = new EditField(

_resources.getString(FIELD_SPECIALTY), "",

Integer.MAX_VALUE, BasicEditField.FILTER_DEFAULT);

mainScreen.add(namefield);

mainScreen.add(addressfield);

mainScreen.add(phonefield);

mainScreen.add(websitefield);

mainScreen.add(specialtyfield);

mainScreen.addKeyListener(this);

mainScreen.addTrackwheelListener(this);

pushScreen(mainScreen);

}

public void makeMenu( Menu menu, int instance ) {

menu.add(saveItem);

menu.add(getItem);

menu.add(phoneItem);

menu.add(browserItem);

super.makeMenu(menu, instance);

}

public void onExit() {

Dialog.alert(_resources.getString(APP_EXIT));

}

Last Updated:2007年2月1日

BlackBerry 应用程序开发者指南第二卷：高级–第7章与BlackBerry应用程序通信

Taigoo — Mon, 28 Apr 2008 21:49:49 +0000

第7章与BlackBerry应用程序通信

启动BlackBerry应用程序

加入一个菜单项到BlackBerry应用程序中

代码实例

启动BlackBerry应用程序

调用API(net.rim.blackberry.api.invoke)允许应用程序启动标注你的BlackBerry应用程序.
注: 当应用程序调用电话时,检查一个ControlledAccessException.如果系统管理员通过应用程序控制限制访问电话应用程序,将抛出一个运行时错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级第1卷:基础.

调用API新功能

从BlackBerry JDE 4.1起,有下面的功能:

可以改变AddressBookArguments (net.rim.blackberry.api.invoke.AddressBookArguments)来打开一个使用PIMContact的联系人.
可以改变CalendarArguments (net.rim.blackberry.api.invoke.CalendarArguments)查看存在的PIM事件.你不可以创建一个来自PIM对象的新事件.
可以改变MessageArguments (net.rim.blackberry.api.invoke.MessageArguments)创建一个包含主题和内容的消息
在Task应用程序无变化的情况下,不可以更新TaskArguments (net.rim.blackberry.api.invoke.TaskArguments).

为启动一个应用程序,调用带有合适常量和ApplicationArguments 子类的对象的Invoke.invokeApplication(int, ApplicationArguments)方法.

注:使用Invoke.invokeApplication(int, ApplicationArguments)将导致一个处理上下文的转化.当BlackBerry程序启动时,你的应用程序将失去控制.在启动的应用程序对话中止时,内容可能不会返回给你的应用程序.

应用程序	常量	类
Address book(地址本)	APP_TYPE_ADDRESSBOOK	AddressBookArguments
Calendar(日历)	APP_TYPE_CALENDAR	CalendarArguments
Memo pad(便笺)	APP_TYPE_MEMOPAD	MemoArguments
Messages(消息)	APP_TYPE_MESSAGES	MessageArguments
Phone(电话)	APP_TYPE_PHONE	PhoneArguments
Tasks(任务)	APP_TYPE_TASKS	TaskArguments

技巧:从浏览器应用程序API(net.rim.blackberry.api.browser)中调用BlackBerry浏览器.参看51页的”在浏览器中显示内容”获得更多信息.电话API (net.rim.blackberry.api.phone)提供访问电话应用程序的高级特性的能力. 参看77页的”电话API”获得更多信息

注: 当应用程序调用电话时,检查一个ControlledAccessException.如果系统管理员通过应用程序控制限制访问电话应用程序,将抛出一个运行时错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级第1卷:基础.

下面的Restaurants.java实例的摘录创建了一个菜单调用电话程序打电话给餐厅.

private MenuItem phoneItem = new MenuItem(_resources.getString(MENUITEM_PHONE), 110, 12) {

public void run() {

synchronized(store) {

String phoneNumber = phonefield.getText();

if ( phoneNumber.length == 0 ) {

Dialog.alert(_resources.getString(ALERT_NO_PHONENUMBER));

}

else {

PhoneArguments call = new PhoneArguments(PhoneArguments.ARG_CALL,

phoneNumber);

Invoke.invokeApplication(Invoke.APP_TYPE_PHONE, call);

}

};

加入一个菜单项到Blackberry应用程序中

应用程序菜单项API在net.rim.blackberry.api.menuitem包中.它使你可以增加一个菜单项到BlackBerry应用程序中.

例如,为了将一个客户关系管理程序集成到BlackBerry地址本程序中,加入一个View Sales Order菜单项.当用户单击View Sales Order菜单项时,应用程序将打开此联系人的销售订单列表.

ApplicationMenuItemRepository类让你可以加入或删除应用程序菜单项.它提供一些常量来定义一个菜单项显示的应用程序上下文.例如, 当一个消息窗口打开时,ApplicationMenuItemRepository.MENUITEM_MESSAGE_LIST常量指定了显示的菜单项.

ApplicationMenuItem抽象类定义了一个在应用程序菜单里显示的菜单项.

创建一个菜单项

扩展 ApplicationMenuItem 抽象类.

public class SampleMenuItem extends ApplicationMenuItem

{

…

}

指定菜单项在菜单的位置

你可以选择性的覆盖构造子.在下面的代码实例中,构造子调用了ApplicationMenuItem(),它带有一个菜单项在菜单里的相对位置.(一个较大的数字意味着菜单项在菜单的较低位置).

SampleMenuItem() {

super(20);

}

指定菜单项的文本

toString()的实现指定了菜单项在菜单中显示的文本.

public String toString() {

return "Open the Contacts Demo application";

}

指定菜单项的行为

run()的实现指定了某个菜单项的行为.

public Object run(Object context) {

Contact c = (Contact)context; // An error if this does not work.

}

if ( c ! null ) {

new ContactsDemo().enterEventDispatcher();

}

else

{

throw new IllegalStateException( "Context is null, expected a Contact instance");

}

Dialog.alert("Viewing a message in the messaging view");

return null;

}

注册应用程序菜单项

获取应用程序菜单项库(repository)

调用 ApplicationMenuItemRepository.getInstance().

ApplicationMenuItemRepository repository =

ApplicationMenuItemRepository.getInstance();

定义一个唯一值

使用包名的哈希值作为应用程序菜单项库的唯一ID.

long ID = 0×7cab1e23b72a0033L;

// Hash of com.rim.samples.docs.menuitem.

创建应用程序菜单项

调用构造函数.

TestApplicationMenuItem tami = new TestApplicationMenuItem();

加入一个菜单项到菜单库

调用addMenuItem().

repository.addMenuItem(ApplicationMenuItemRepository.MENUITEM_ADDRESSCARD_VIEW, tami);

代码实例

当用户在地址本里查看一个联系人时,下面的代码将创建一个菜单项.当用户点击此菜单项, 将显示Contacts Demo程序.

例: DemoAppMenuItem.java

/**

* DemoApplicationMenuItem.java

package com.rim.samples.docs.menuitem;

import net.rim.device.api.system.*;

import net.rim.device.api.ui.component.Dialog.*;

import net.rim.blackberry.api.menuitem.*;

import javax.microedition.pim.*;

import net.rim.device.api.pdap.*;

import com.rim.samples.docs.contactsdemo.*;

public final class DemoAppMenuItem extends Application {

private static long ID = 0×7cab1e23b72a0033L;

//com.rim.samples.docs.menuitem

public static void main(String[] args) {

DemoAppMenuItem app = new DemoAppMenuItem();

app.enterEventDispatcher();

}

DemoAppMenuItem() {

ApplicationMenuItemRepository amir =

ApplicationMenuItemRepository.getInstance();

amir.addMenuItem(ApplicationMenuItemRepository.MENUITEM_ADDRESSCARD_VIEW,

new SampleMenuItem());

}

private static class SampleMenuItem extends ApplicationMenuItem {

SampleMenuItem() {

super(20);

}

public String toString() {

return "Open the Contacts Demo";

}

public Object run(Object context) {

BlackBerryContact c = (BlackBerryContact)context; //an error if this doesn’t work

if ( c != null ) {

new ContactsDemo().enterEventDispatcher();

}

else {

throw new IllegalStateException( "Context is null, expected a Contact instance");

}

net.rim.device.api.ui.component.Dialog.alert("Viewing an email message in the email view");

return null;

}

Last Updated:2007年2月1日

BlackBerry 应用程序开发者指南第二卷：高级–第6章访问电话应用程序

Taigoo — Mon, 28 Apr 2008 21:47:38 +0000

第6章访问电话应用程序

电话API

监听电话事件

访问和管理电话记录

电话API

电话API((net.rim.blackberry.api.phone)可以访问电话应用程序的高级特性,例如允许应用程序将DTMF(双声多频)的音调(tone)到活动的通话中.
注:为了简单调用电话应用程序和拨打一个电话,使用调用API(net.rim.blackberry.api.invoke),为获得更多信息,参看83业的”启动应用程序”. 当应用程序第一次访问电话API时,检查一个 NoClassDefFoundError.如果系统管理员通过应用程序控制限制访问HTTP过滤器API,将抛出此错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级第1卷:基础.

接收一个电话

调用Phone.getActiveCall()接收一个活动的电话.根据电话ID获取一个电话, 调用 Phone.getCall(int).

PhoneCall call = Phone.getActiveCall();

获取电话信息

PhoneCall类提供方法使应用程序获取电话的信息.例如,下面的代码检验电话的通话时间,电话的状态,以及在显示来电显示消息之前它是否正在出去.

int threshold = 120; // Alert user if outgoing calls last longer than threshold.

int elapsedTime = call.getElapsedTime();

// Use getStatusString() to retrieve status as an string.

int status = call.getStatus();

if ((status == PhoneCall.STATUS_CONNECTED ||

status == PhoneCall.STATUS_CONNECTING) && call.isOutGoing()

&& elapsedTime > threshold) {

// Use getCallId() to retrieve the caller ID as as an integer.

String phoneNumber = call.getDisplayPhoneNumber();

Status.show("Your call to " + phoneNumber + " has lasted more than " +

(String)threshold + ".");

}

将DTMF音调增加到发送队列中

一个DTMF音调由在同一时间里播放的高低频率组成.

键	低音	高音
1	697	1209
2	697	1336
3	697	1477
4	770	1209
5	770	1336
6	770	1477
7	852	1209
8	852	1336
9	852	1477
0	941	1209
*	941	1336
#	941	1477

将单个DTMF音调加入到发送队列中

注:如果没有其他音调加入时,BlackBerry设备播放DTMF音,同时覆写对话.

调用sendDTMFTone().

将多个DTMF音调加入到发送队列中

调用sendDTMFTones().

为当前电话获取发送队列

调用getDTMFTones().

监听电话事件

PhoneListener接口的实现使应用程序可以监听电话的事件.

调用Phone.addPhoneListener()方法向系统注册你的实现.

为了注销一个电话监听者,调用removePhoneListener().

为了完成一个指定的事件,实现下面的方法.

方法	描述
callAdded(int)	当一个电话加入到一个会议电话时调用.
callAnswered(int)	当用户接听电话时调用(需用户驱动).
callConferenceCallEstablished(int)	当建立好一个电话会议时调用.
callConnected(int)	当网络指定一个连接事件时调用(网络驱动).
callDirectConnectConnected(int)	当一个直线电话(Direct-connect call)连接时调用
callDirectConnectDisconnected(int)	当一个直线电话断开时调用.
callDisconnected(int)	当断开一个电话时调用.
callEndedByUser(int)	当用户中止通话时调用.
callFailed(int, int)	当电话失败时调用.
callHeld(int)	当出去的电话锁住时调用.
callIncoming(int)	当一个新电话进来时调用.
callInitiated(int)	当BlackBerry设备初始化一个出去的电话时调用.
callRemoved(int)	当一个电话从会议电话里断开时调用.
callResumed(int)	当一个锁住的电话重启时调用.
callWaiting(int)	当一个电话正在等待时调用.
conferenceCallDisconnected(int)	.当会议电话中止时调用.(所有的成员都断开).

访问和管理电话日志

电话记录API(net.rim.blackberry.api.phone.phonelogs)允许应用程序访问电话应用程序记录文件.电话呼叫记录包含每个单独电话的记录,它们分组到一个电话日志里.
注: 应用程序第一次访问电话日API时,检查一个 NoClassDefFoundError.如果系统管理员通过应用程序控制限制访问电话日志,将抛出此错误. 为获得更多信息,参看BlackBerry应用程序开发者指南 第2卷:高级第1卷:基础.

获取一个电话日志

PhoneLogs类代表一个电话历史记录.它提供方法允许你打开,增加,删除,或交换呼叫记录.

>调用honeLogs.getInstance().

PhoneLogs _logs = PhoneLogs.getInstance

获取文件夹的电话呼叫数

电话日志分成2个文件夹: FOLDER_NORMAL_CALLS 和 FOLDER_MISSED_CALLS.

>调用 numberOfCalls(int).

int numberOfCalls = _logs.numberOfCalls(FOLDER_NORMAL_CALLS);

获取一个呼叫记录

你可以实例化2种类型的呼叫记录: PhoneCallLog对象,它仅可以有一个参与者,以及ConferencePhoneCallLog对象,它有2个或多个参与者.这2个对象可以使你获取或改变呼叫记录信息,例如参与者或呼叫日期.

>调用 PhoneLogs.callAt(int index, long folderID).

PhoneCallLog phoneLog = (PhoneCallLog)_logs.callAt(0);

获取一个电话参与者

PhoneCallLogID类根据电话号码标志电话里的参与者.

>调用 PhoneCallLog.getParticipant(int)或 ConferencePhoneCallLog.getParticipantAt().

PhoneCallLogID participant = phoneCallLog.getParticipant();

PhoneCallLogID participant = ConferencePhoneCallLog.getParticipant();

获取电话号码类型

PhoneCallLogID类为日志标志了电话的类型.例如,记录在地址本里的Home(家庭),Mobile(移动),Work(工作)或Fax(传真).

>调用PhoneCallLogID.getType().

String phoneType = PhoneCallLogID.getType();

创建一个呼叫记录或会议电话记录

注: PhoneCallLogID构造函数删除了电话号码里的短横以及其他非数字的字符

创建一个PhoneCallLog或ConferencePhoneCallLog对象的实例

为电话的构造函数提供日期,持续时间,参与者,以及留言参数

Date date = new Date("1000"); // date of call

int duration = 60; // duration of call

PhoneCallLogID caller1 = new PhoneCallLogID("555-1234"); // first participant

PhoneCallLogID caller2 = new PhoneCallLogID("555-1235"); // second participant

String notes = "New call."; // notes

ConferencePhoneCallLog conferenceCall =

new ConferencePhoneCallLog(date, duration, PhoneLogs.FOLDER_NORMAL_CALLS,

caller1, caller2, notes);

将电话加入到电话日志的下一个可用的索引上

>调用PhoneLogs.addCall(CallLog call).

_logs.addCall(conferenceCall);

用新呼叫记录代替给定索引的呼叫记录

>调用 PhoneLogs.swapCall(CallLog call,int index,long folderID).

_logs.swapCall(conferenceCall, 0, FOLDER_NORMAL_CALLS);

注: swapCall()方法删除给定索引的呼叫记录..

删除一个呼叫记录

>调用 PhoneLogs.deleteCall().

_logs.deleteCall(0);

代码实例

下面的代码实例计算某个给定的参与者拨打电话的时间.

例: PhoneLogsDemo.java

/**

* PhoneLogsDemo.java

package com.rim.samples.docs.phonelogs;

import net.rim.blackberry.api.phone.phonelogs.*;

import java.lang.*;

import com.rim.samples.docs.baseapp.*;

import net.rim.device.api.system.Application;

public class PhoneLogsDemo extends Application {

private PhoneLogs _logs;

private int _timeSpokenTo;

static public void main(String[] args) {

PhoneLogsDemo app = new PhoneLogsDemo();

app.enterEventDispatcher();

}

private PhoneLogsDemo() {

_logs = PhoneLogs.getInstance();

PhoneLogsDemo phoneLogsDemo = new PhoneLogsDemo();

PhoneCallLogID participant = new PhoneCallLogID("5551234");

_timeSpokenTo = phoneLogsDemo.findTimeSpokenTo(participant,

PhoneLogs.FOLDER_NORMAL_CALLS);

}

// Returns the number of seconds spent on the phone with a participant.

public int findTimeSpokenTo(PhoneCallLogID participant,

long folder) {

int numberOfCalls = this._logs.numberOfCalls(folder);

int timeSpokenTo = 0;

PhoneCallLog phoneCallLog;

ConferencePhoneCallLog conferencePhoneCallLog;

for (int i = 0; i < numberOfCalls; i++) {

Object o = _logs.callAt(i, folder);

if (o instanceof PhoneCallLog) {

phoneCallLog = (PhoneCallLog)_logs.callAt(i, folder);

if ( phoneCallLog.getParticipant() == participant)

timeSpokenTo += phoneCallLog.getDuration();

}

else {

conferencePhoneCallLog = (ConferencePhoneCallLog)_logs.callAt(i, folder);

int participants = conferencePhoneCallLog.numberOfParticipants();

for (int j = 0; j < participants; j++)

if (conferencePhoneCallLog.getParticipantAt(j) == participant) {

timeSpokenTo += conferencePhoneCallLog.getDuration();

j = participants;

}

return timeSpokenTo;

}

Last Updated:2007年1月31日

BlackBerry 应用程序开发者指南第二卷：高级–第3章集成PIM功能

Taigoo — Mon, 28 Apr 2008 04:20:42 +0000

第3章集成PIM功能

PIM API

使用地址本

使用任务

使用日历

PIM API

Java个人信息管理(Personal Information Manager,PIM) API(javax.microedition.pim)以及BlackBerry PDAP(Personal Digital Assistant Profile) API(net.rim.blackberry.api.pdap)允许你访问BlackBerry设备上的日历,任务,以及地址本.
注:在4.0版本里,net.rom.blackberry.api.pim包是不赞成使用的. 现在这个包里的类在javax.microedition.pim and net.rim.blackberry.api.pdap里可以得到.

PIM类是一个抽象类,它提供了访问BlackBerry设备上的PIM数据的方法.

获取一个PIM对象

调用PIM.getInstance().

注:当你的应用程序第一次访问PIM API时,它将检查一个ControlledAccessException.如果系统管理员使用应用程序控制限制访问PIM API,一个运行时异常将会抛出.为获取更多信息,参看”BlackBerry应用程序开发者指南 第2卷:高级 第一卷:基础”.

PIM列表

PIM列的接口代表了所有联系人,事件以及任务列的常用功能.一个列包含0个或多个项,它们是PIMItem的子类.使用PIM列组织相关项,并且获取一些或所有列表的项.
注:在BlackBerry设备里,每个ContactList,ToDoList或EventList实例都会涉及到BlackBerry设备上的本地数据库.第三方应用程序不能创建自定义的列表.

PIM项

PIMItem接口代表了一个列项常用的功能.Contact,Event,以及ToDo接口扩展了PIMItem.一个PIM项代表了单个入口的数据集合,例如一个约会或者一个联系人.

当你在一个指定的PIM列表上创建一个PIM项时,自从它存在开始,此项仍保留了和列表的关联.你也可以使用标准的格式,例如iCal和vCard,导入或导出PIM项里的数据.

字段

一个PIM项在字段里存储数据.每个PIMItem接口-Contact,Event,或ToDo-为每个支持的字段定义了唯一的ID.例如,Contact接口定义字段来存储一个internet消息地址(EMAIL),姓名(FORMATTED_NAME),以及电话号码(TEL).

在你试图设置或获取字段值之前,调用PIMList.isSupportedField(int)来确认是否支持方法.

一个字段可能有一个与之关联的具有描述性的标签显示给用户.为获取这个字段的标签,调用PIMList.getFieldLabel(int).

每个字段都有一个数据类型ID,例如INT,BINARY,DATE,BOOLEAN,或STRING.为了得到一个字段的数据类行,调用PIMList.getFieldDataType(int).

数据类型决定了你将使用哪一个方法得到或设置字段数据.例如:

如果字段的数据类型为STRING,为了加入一个值,调用PIMItem.addString(String).
为了改变已经存在的值,调用PIM.setString(String).
为了获取一个字段值,调用PIMItem.getString().

监听者

当列表里的一个项发生变化时,你的PIMListListener接口实现会收到这个通知. PIMListListener接口提供了下面的方法:

方法	描述
itemAdded(PIMItem)	当加入一个项到列表时调用.
item.Removed(PIMItem)	当从列表里删除时调用.
itemUpdated(PIMItem,PIMItem)	当一个项发生变化时调用.

ContactList cl = (ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);

((BlackBerryPIMList)cl).addListener(

new PIMListListener() {

public void itemAdded(PIMItem item) {

System.out.println(" ITEM ADDED: " +

((Contact)item).getString(Contact.UID, 0));

}

public void itemUpdated(PIMItem oldItem, PIMItem newItem) {

System.out.println(" ITEM UPDATED: " +

((Contact)oldItem).getString(Contact.UID, 0) + " to " +

((Contact)newItem).getString(Contact.UID, 0));

}

public void itemRemoved(PIMItem item) {

System.out.println(" ITEM REMOVED: " +

((Contact)item).getString(Contact.UID, 0));

}

});

注:监听者仍然保持和BlackBerry设备数据库的关联,甚至是在相应的PIMList对象已经删除之后.为了删除一个监听者,调用BlackBerryPIMList.removeListener().

远程地址查询

支持远程地址查询的应用程序应该实例化BlackBerryContactList接口.此节口扩展了ContactList接口,并且提供了下面额外的方法:

方法	描述
choose(Contact, int, boolean)	启动地址本以至用户可以选择一个地址.
void lookup(Contact, RemoteLookupListener)	初始化一个远程查询.
void lookup(String, RemoteLookupListener)	初始化一个远程查询.

RemoteLookupListener接口提供了一单个方法,items(),此方法返回一个远程地址查询结果的迭代.

使用地址簿

使用一个ContactList的实例增加或查看BlackBerry设备地址簿的联系人信息.创建Contact对象存储单独的联系人信息,此信息包含姓名,电话号码,Email,以及街道地址.

BlackBerry特定的地址字段

BlackBerryContact接口扩展了Contact,为了访问BlackBerry联系人特定的字段, 它定义了下面的常数:

常量	描述
BlackBerryContact.PIN	访问PIN字段.
BlackBerryContact.USER1 到 USER4	访问USER1到USER4字段.

为了定义USER1到USER4字段的标签,调用BlackBerryPIMList.setFieldLabel().

此改变立即生效.你不必要提交改变.
注:改变一个标签将影响所有BlackBerry设备上的联系人.

打开一个联系人列表

在你增加联系人之前,你必须创建一个联系人列表.调用PIM.openPIMList().将列表的类型作为参数提供给open(PIM.CONTACT_LIST),并且提供访问模式(READ_WRITE,READ_ONLY,或WRITE_ONLY)打开列表.

如果你正在为BlackBerry设备专门编写一个应用程序,将你的联系人列表转化为BlackBerryContactList,因为此接口提供了一个附加的方法来支持远程地址查询.为了让一个应用程序可以跨多个兼容的Java ME BlackBerry设备,使用PDAP实现.

ContactList contactList = null;

try {

contactList = (ContactList)PIM.getInstance().openPIMList(

PIM.CONTACT_LIST, PIM.READ_WRITE);

}

catch (PimException e) {

return;

}

注:联系人不会加到数据库中,直到你提交它.为获得更多信息,参看30页的”保存一个联系人”.

创建一个联系人

调用联系人列表的createContact().

Contact contact = contactList.createContact();

增加联系人信息

Contact类定义了保存数据的字段,例如Contact.Name,Contact.ADDR,以及Contact.TEL.每个字段都有一个特定的数据类型,你可以调用PIMList.getFieldDataType(int)来获取它们.由于依赖字段的数据类型,通过调用下列方法创建一个新值: addString(), addStringArray(), addDate(), addInt(), addBoolean(), 或addBinary().

在你设置和获取一个字段之前,为了验证列表项是否支持字段,调用:

ContactList.isSupportedField(int)

通过使用属性来区分其值,某些字段可以存储多个值.例如,TEL字段支持ATTR_HOME,ATTR_WORK,ATTRMOBILE和ATTR_FAX属性存储工作,家庭,移动以及传真号码.

为了判断一个字段最多支持几个值,调用PIMList.maxValues(int field).

此方法返回支持的值的个数,返回-1意味着可以增加任意个数的值.为了验证一个字段是否支持特定的属性,调用isSupportedAttribute(int, int).

// Create string array for name.

try {

ContactList contactList = (ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);

}

catch (PIMException e)

{

}

Contact contact = contactList.createContact();

String[] name = new String[5]; // 5 name elements

try {

name[Contact.NAME_PREFIX] = "Mr.";

name[Contact.NAME_FAMILY] = "McPherson";

name[Contact.NAME_GIVEN] = "Scott";

}

catch (IllegalArgumentException iae) {

// handle exception

}

// Add name.

if(contactList.isSupportedField(Contact.NAME)) {

contact.addStringArray(Contact.NAME, Contact.ATTR_NONE, name);

}

// Create string array for address.

String[] address = new String[7]; // 7 address elements

try {

address[Contact.ADDR_COUNTRY] = "United States";

address[Contact.ADDR_LOCALITY] = "Los Angeles";

address[Contact.ADDR_POSTALCODE] = "632300";

address[Contact.ADDR_REGION] = "California";

address[Contact.ADDR_STREET] = "323 Main Street";

}

catch (IllegalArgumentException iae) {

// Handle exception.

}

// Add address.

contact.addStringArray(Contact.ADDR, Contact.ATTR_NONE, address);

// Add home telephone number.

if (contactList.isSupportedField(Contact.TEL) &&

contactList.isSupportedAttribute(Contact.TEL, Contact.ATTR_HOME))

{

contact.addString(Contact.TEL, Contact.ATTR_HOME, "555-1234");

}

// Add work telephone number.

if (contactList.isSupportedField(Contact.TEL)) {

contact.addString(Contact.TEL, Contact.ATTR_HOME, "555-5555");

}

// Add work internet messaging address.

if (contactList.isSupportedField(Contact.EMAIL)) {

contact.addString(Contact.EMAIL,

Contact.ATTR_WORK,

"aisha.wahl@blackberry.com");

}

修改联系人信息

对于仅支持一个值的字段,调用合适的set方法用一个新值替代一个已存在的值.

注:如果你调用一个增加方法,例如addString(),对于已经存在一个值的字段来说,将抛出一个FieldFullException异常.使用相应的set方法,例如setString(),修改一个已经存在的值.

对于包含了一个字符数组的姓名和地址字段,获取此数组,然后将它加入之前,修改一个或多个数组上的索引.

if (contact.countValues(Contact.NAME) > 0) {

String[] newname = contact.getStringArray(Contact.NAME, 0);

}

// Change the prefix to Dr. and add the suffix, Jr.

newname[Contact.NAME_PREFIX] = "Dr.";

newname[Contact.NAME_SUFFIX] = "Jr.";

contact.setStringArray(Contact.NAME, 0, Contact.ATTR_NONE, newname);

对于支持多个值的字段,在将另外一个值加入之前,先验证其没有超过值的最大个数。

if (contact.countValues(Contact.EMAIL) < contactList.maxValues(Contact.EMAIL))

{

contact.addString(Contact.EMAIL,Contact.ATTR_NONE, aisha.wahl@blackberry.com");

}

保存一个联系人信息

调用commit().在提交修改之前,为判断任何联系人字段自从最后保存以来是否已经发生变化,调用isModified().

if(contact.isModified()) {

contact.commit();

}

获取联系人信息

调用PIMList.Items()

注:当你调用PIMList.Items()获取一个列表项的迭代时,列表项的顺序没有定义.如果必要,你的应用程序必须将它们排序.

对于一个特定的联系人,调用PIMItem.getFields()获取一个拥有数据的字段ID的数组.调用PIMItem.getString()获取字段值.

ContactList contactList = (ContactList)PIM.getInstance().openPIMList(

PIM.CONTACT_LIST, PIM.READ_WRITE);

Enumeration enum = contactList.items();

while (enum.hasMoreElements()) {

Contact c = (Contact)enum.nextElement();

int[] fieldIds = c.getFields();

int id;

for(int index = 0; index < fieldIds.length; ++index) {

id = fieldIds[index];

if(c.getPIMList().getFieldDataType(id) == Contact.STRING)

{

for(int j=0; j < c.countValues(id); ++j) {

String value = c.getString(id, j);

System.out.println(c.getPIMList().getFieldLabel(id) + "=" + value);

}

将一个联系人转化为序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如vCard.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.Contact_LIST).为了将一个项写到一个支持的序列化格式里,调用toSerialFormat().

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

ContactList contactList = (ContactList)PIM.getInstance().openPIMList(

PIM.CONTACT_LIST, PIM.READ_ONLY);

String[] dataFormats = PIM.getInstance().supportedSerialFormats(

PIM.CONTACT_LIST);

ByteArrayOutputStream byteStream = new ByteArrayOutputStream();

Enumeration e = contactList.items();

while (e.hasMoreElements()) {

Contact c = (Contact)e.nextElement();

PIM.getInstance().toSerialFormat(c, byteStream, "UTF8", dataFormats[0]);

}

导入一个联系人

为了返回一组PIM项,调用fromSerialFormat().使用PIM项为了创建一个新的联系人,调用ContactList.importContact()

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括

"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

// Import contact from vCard.

ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());

PIMItem[] pi = PIM.getInstance().fromSerialFormat(istream, "UTF8");

ContactList contactList = (ContactList)PIM.getInstance()

.openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);

Contact contact2 = contactList.importContact((Contact)pi[0]);

contact2.commit();

删除一个联系人

在联系人列表上调用removeContact()方法.

contactList.removeContact(contact);

关闭一个联系人列表

调用close().

try {

contactList.close();

}

catch(PIMException e) {

Dialog.alert(e.toString());

}

代码实例

下面的实例描述了如何显示一个屏幕来允许用户增加一个新的联系人到地址本中.在你保存一个联系人之后,打开地址本确认该联系人是否已经保存.

例: ContactsDemo.java

/**

* ContactsDemo.java

package com.rim.samples.docs.contactsdemo;

import java.io.*;

import java.util.*;

import javax.microedition.pim.*;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.i18n.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import com.rim.samples.docs.baseapp.*;

import net.rim.blackberry.api.pdap.*;

public final class ContactsDemo extends BaseApp {

private ContactScreen _contactScreen;

public static void main(String[] args) {

new ContactsDemo().enterEventDispatcher();

}

public ContactsDemo() {

_contactScreen = new ContactScreen();

pushScreen(_contactScreen);

}

protected void onExit() {

}

// Inner class. Creates a Screen to add a contact.

public static final class ContactScreen extends MainScreen {

private EditField _first, _last, _email, _phone, _pin;

private SaveMenuItem _saveMenuItem;

private class SaveMenuItem extends MenuItem {

private SaveMenuItem() {

super(null, 0, 100000, 5);

}

public String toString() {

return "Save";

}

public void run() {

onSave();

}

public ContactScreen() {

_saveMenuItem = new SaveMenuItem();

setTitle(new LabelField("Contacts Demo",

LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH));

_first = new EditField("First Name: ", "");

add(_first);

_last = new EditField("Last Name: ", "");

add(_last);

_email = new EditField("Email Address: ", "",

BasicEditField.DEFAULT_MAXCHARS, BasicEditField.FILTER_EMAIL);

add(_email);

_phone = new EditField("Work Phone: ", "",

BasicEditField.DEFAULT_MAXCHARS, BasicEditField.FILTER_PHONE);

add(_phone);

_pin = new EditField("PIN:", "", 8, BasicEditField.FILTER_HEXADECIMAL);

add(_pin);

}

protected boolean onSave() {

String firstName = _first.getText();

String lastName = _last.getText();

String email = _email.getText();

String phone = _phone.getText();

String pin = _pin.getText();

// Verify that a first or last name and email has been entered.

if ((firstName.equals("") && lastName.equals("")) || email.equals("")) {

Dialog.inform("You must enter a name and an email address!");

return false;

}

else {

try {

ContactList contactList = (ContactList)PIM.getInstance().

openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);

Contact contact = contactList.createContact();

String[] name = new String[contactList.stringArraySize(Contact.NAME)];

// Add values to PIM item.

if (!firstName.equals("")) {

name[Contact.NAME_GIVEN] = firstName;

}

if (!lastName.equals("")) {

name[Contact.NAME_FAMILY] = lastName;

}

contact.addStringArray(Contact.NAME, Contact.ATTR_NONE, name);

contact.addString(Contact.EMAIL, Contact.ATTR_HOME, email);

contact.addString(Contact.TEL, Contact.ATTR_WORK, phone);

if (contactList.isSupportedField(BlackBerryContact.PIN)) {

contact.addString(BlackBerryContact.PIN, Contact.ATTR_NONE, pin);

}

// Save data to address book.

contact.commit();

// Reset UI fields.

_first.setText("");

_last.setText("");

_email.setText("");

_phone.setText("");

_pin.setText("");

return true;

}

catch (PIMException e) {

return false;

}

protected void makeMenu(Menu menu, int instance) {

menu.add(_saveMenuItem);

super.makeMenu(menu, instance);

}

使用任务

使用一个ToDoList类的实例来存储任务或计划项的列表. 为每个任务创建一个或多个ToDo对象来存储数据,例如主题(summary),优先级,持续的时间以及状态.

打开一个任务列表

调用PIM.openPIMList(),将列表的类型作为open (PIM.TODO_LIST)的参数

,并且指定访问的模式(READ_WRITE, READ_ONLY,或WRITE_ONLY)打开列表.

ToDoList todoList = null;

try {

todoList = (ToDoList)PIM.getInstance().openPIMList(PIM.TODO_LIST, PIM.READ_WRITE);

}

catch (PimException e) {

//an error occurred

return;

}

创建一个任务

调用任务列表上的createToDo().

ToDo task = todoList.createToDo();

toSerialFormat().

注:新增加的任务不会存到数据库,直到你提交它.为获得更多信息,参看35页的”保存一个任务”.

增加任务信息

ToDo类定义字段来存储数据,例如SUMMARY,PRIORITY以及DUE.每个字段都有一个特定的数据类型,你可以使用PIMList.getFieldDataType(int)调用它们.因为取决于字段的数据类型,调用以下方法设置数据:

addString(), addDate(), addInt(), addBoolean(), 或 addBinary().

为获得更多关于字段的信息,参看25页的”PIM API”.

在你设置或获取一个字段之前, 调用isSupportedField(int)来验证此项是否支持字段.

if (todoList.isSupportedField(ToDo.SUMMARY)) {

task.addString(ToDo.SUMMARY, ToDo.ATTR_NONE, "Create project plan");

}

if (todoList.isSupportedField(ToDo.DUE)) {

Date date = new Date();

task.addDate(ToDo.DUE, ToDo.ATTR_NONE, (date + 17280000));

}

if (todoList.isSupportedField(ToDo.NOTE)) {

task.addString(ToDo.NOTE, ToDo.ATTR_NONE, "Required for meeting");

}

if (todoList.isSupportedField(ToDo.PRIORITY)) {

task.addInt(Todo.PRIORITY, ToDo.ATTR_NONE, 2);

}

设置任务状态

使用PIM扩展字段ToDo.EXTENDED_FIELD_MIN_VALUE + 9.

常量	值
STATUS_NOT_STARTED	1
STATUS_IN_PROGRESS	2
STATUS_COMPLETED	3
STATUS_WAITING	4
STATUS_DEFERRED	5

task.addInt(ToDo.EXTENDED_FIELD_MIN_VALUE + 9, ToDo.ATTR_NONE, 2);

修改任务信息

为了用一个新值替换一个存在的值,调用合适的set方法,例如setString().为了判断一个字段已经设置其值,调用countValues().

注:如果你调用一个增加方法,例如addString(),当一个值存在时,将抛出一个FieldFullException异常.使用相应的set方法,如setString()改变一个存在的值.

if (task.countValues(ToDo.SUMMARY) > 0) {

task.setString(ToDo.SUMMARY, 0, ToDo.ATTR_NONE, "Review notes");

}

保存一个任务

调用commit()方法.在你保存之前,为了决定自从上一次保存任务之后任何字段是否发生变化,调用isModified().

if(task.isModified())

{

task.commit();

}

获取任务信息

获取一个迭代

调用任务列表上的PIMList.items().

ToDoList todoList = (ToDoList)PIM.getInstance().openToDoList(

PIM.TODO_LIST, PIM.READ_ONLY);

Enumeration enum = todoList.items();

获取一个任务的字段ID以及值

对于某个特定的ToDo项,为获取一组包含其数据的字段ID，调用PIMItem.getFields().

为获取字段值,调用PIMItem.getString().

while (enum.hasMoreElements()) {

ToDo task = (ToDo)enum.nextElement();

}

int[] fieldIds = task.getFields();

int id;

for(int index = 0; index < fieldIds.length; ++index) {

id = fieldIds[index];

if(task.getPIMList().getFieldDataType(id) == STRING) {

for(int j=0; j < task.countValues(id); ++j) {

String value = task.getString(id, j);

System.out.println(task.getFieldLable(id) + "=" + value);

}

将一个任务转化为序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如vCard.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.TODO_LIST).

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

ToDoList todoList = (ToDoList)PIM.getInstance().openPIMList(

PIM.TODO_LIST, PIM.READ_ONLY);

ByteArrayOutputStream byteStream = new ByteArrayOutputStream();

String[] dataFormats = PIM.getInstance().supportedSerialFormats(PIM.TODO_LIST);

Enumeration e = todoList.items();

while (e.hasMoreElements()) {

ToDo task = (ToDo)e.nextElement();

PIM.getInstance().toSerialFormat(task, byteStream, "UTF8", dataFormats[0]);

}

导入一个任务

为返回一组PIMItem对象,调用fromSerialFormat().

使用PIM项创建一个新的任务,调用ToDoList.importToDo().

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

String[] dataFormats = PIM.toDoSerialFormats();

// Write task to serial format.

ByteArrayOutputStream os = new ByteArrayOutputStream();

PIM.getInstance().toSerialFormat(task, os, "UTF8", dataFormats[0]);

// Import task from serial format.

ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());

PIMItem[] pi = PIM.getInstance().fromSerialFormat(is, "UTF8");

ToDoList todoList = (ToDoList)PIM.getInstance().openPIMList(

PIM.TODO_LIST, PIM.READ_WRITE);

ToDo task2 = todoList.importToDo((ToDo)pi[0]);

提示: importToDo()方法保存一个任务,因此你不必要调用commit()方法.

删除一个任务

调用任务列表上的removeToDo().

todoList.removeToDo(task);

关闭一个任务列表

调用todoList.close().务必捕捉应用的异常:

try {

todoList.close();

}

catch (PimException e) {

// Handle exception.

}

代码实例

例: TaskDemo.java

/**

* TaskDemo.java

package com.rim.samples.docs.taskdemo;

import java.io.*;

import java.util.*;

import javax.microedition.pim.*;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.i18n.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import com.rim.samples.docs.baseapp.*;

public final class TaskDemo extends BaseApp {

private TaskScreen _taskScreen;

public static void main(String[] args) {

new TaskDemo().enterEventDispatcher();

}

private TaskDemo() {

_taskScreen = new TaskScreen();

pushScreen(_taskScreen);

}

protected void onExit() {

}

public final static class TaskScreen extends MainScreen {

// Members.

private EditField _summary, _note;

private DateField _due;

private ObjectChoiceField _priority, _status;

private SaveMenuItem _saveMenuItem;

private class SaveMenuItem extends MenuItem {

private SaveMenuItem() {

super(null, 0, 100000, 5);

}

public String toString() {

return "Save";

}

public void run() {

onSave();

}

public TaskScreen() {

_saveMenuItem = new SaveMenuItem();

setTitle(new LabelField("Tasks Demo",

LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH));

_summary = new EditField("Task Summary: ", "");

add(_summary);

// In TODO.Priority, 0 to 9 is highest to lowest priority.

String[] choices = {"High", "Normal", "Low"};

_priority = new ObjectChoiceField("Priority: ", choices, 1);

add(_priority);

String[] status = { "Not Started", "In Progress", "Completed",

"Waiting on someone else", "Deferred" };

_status = new ObjectChoiceField("Status: ", status, 0);

add(_status);

_due = new DateField("Due: ", System.currentTimeMillis() + 3600000,

DateField.DATE_TIME);

add(_due);

_note = new EditField("Extra Notes: ", "");

add(_note);

}

protected boolean onSave() {

try {

ToDoList todoList = (ToDoList)PIM.getInstance().

openPIMList(PIM.TODO_LIST, PIM.WRITE_ONLY);

ToDo task = todoList.createToDo();

task.addDate(ToDo.DUE, ToDo.ATTR_NONE, _due.getDate());

task.addString(ToDo.SUMMARY, ToDo.ATTR_NONE, _summary.getText());

task.addString(ToDo.NOTE, ToDo.ATTR_NONE, _note.getText());

task.addInt(ToDo.PRIORITY, ToDo.ATTR_NONE,

_priority.getSelectedIndex());

// ToDo.EXTENDED_FIELD_MIN_VALUE + 9 represents status.

// Add 1 to selected index so that values are correct.

// See the RIM Implementation Notes in the API docmentation for ToDo.

task.addInt(ToDo.EXTENDED_FIELD_MIN_VALUE + 9, ToDo.ATTR_NONE,

_status.getSelectedIndex() + 1);

// Save task to handheld tasks.

task.commit();

_summary.setText("");

_note.setText("");

_due.setDate(null);

_priority.setSelectedIndex(1); // Reset to “Normal” priority.

_status.setSelectedIndex(0); // Reset to “Not Started” status.

return true;

}

catch (PIMException e) {

return false;

}

protected void makeMenu(Menu menu, int instance) {

menu.add(_saveMenuItem);

super.makeMenu(menu, instance);

}

使用日历

使用一个EventList接口的实例访问日历.为一个约会创建一个或多个对象存储信息.对于每个事件.你可以存储类似主题,地点,开始和结束事件,以及提醒通知的数据.

打开一个事件列表

在可以增加事件之前你必须创建一个EventList.调用PIM.openPIMList().

调用PIM.openPIMList(),将列表的类型作为open (PIM.EVENT_LIST)的参数

,并且指定访问的模式(READ_WRITE, READ_ONLY,或WRITE_ONLY)打开列表.

EventList eventList = null;

try {

eventList = (EventList)PIM.getInstance().openPIMList(

PIM.EVENT_LIST, PIM.READ_WRITE);

}

catch (PimException e) {

// Handle exception.

}

创建一个约会

调用一个事件列表上的createEvent().

Event event = eventList.createEvent();

注:约会不会加到数据库中,直到你提交它.为获得更多信息,参看41页的”保存一个约会”.

增加约会信息

Event类定义了存储数据的字段,例如SUMMARY, LOCATION, START, END, 以及 ALARM.每个字段都有一个指定的类型,你可以调用PIMList.getFieldDataType(int)获得数据类型.

因为取决于字段的数据类型,调用以下方法设置数据:

addString(), addDate(), addInt(), addBoolean(), 或 addBinary().

在你设置或获取一个字段之前, 调用isSupportedField(int)来验证此项是否支持字段.

if (event.isSupportedField(Event.SUMMARY)) {

event.addString(Event.SUMMARY, Event.ATTR_NONE, "Meet with customer");

}

if (event.isSupportedField(Event.LOCATION)) {

event.addString(Event.LOCATION, Event.ATTR_NONE, "Conference Center");

}

Date start = new Date(System.currentTimeMillis() + 8640000);

if (event.isSupportedField(Event.START)) {

event.addDate(Event.START, Event.ATTR_NONE, start);

}

if (event.isSupportedField(Event.END)) {

event.addDate(Event.END, Event.ATTR_NONE, start + 72000000);

}

if (event.isSupportedField(Event.ALARM)) {

if (event.countValues(Event.ALARM) > 0) {

event.removeValue(Event.ALARM,0);

event.setInt(Event.ALARM, 0, Event.ATTR_NONE, 396000);

}

创建一个重复发生(recurring)的约会

为了定义一个重复发生的约会,使用一个RepeatRule对象.RepeatRule类为你可以设置的属性和值定义了字段,例如COUNT, FREQUENCY,和 INTERVAL.

为了获取一组支持的字段,调用RepeatRule.getFields().

定义重复模式

调用新的RepeatRule对象上的setInt(int, int) 或setDate(int, int, int, long).

RepeatRule recurring = new RepeatRule();

recurring.setInt(RepeatRule.FREQUENCY, RepeatRule.MONTHLY);

recurring.setInt(RepeatRule.DAY_IN_MONTH, 14);

指派约会一个重复模式

调用一个事件上的setRepeat(RepeatRule).

EventList eventList = (EventList)PIM.getInstance().openPIMList(

PIM.EVENT_LIST, PIM.READ_WRITE);

Event event = eventList.createEvent();

event.setRepeat(recurring);

修改约会信息

为使用一个新值代替已经存在的值,调用合适的set方法,例如setString().

为判断一个字段是否已经设置了一个值,调用countValues().
注:当一个值已经存在时,如果你调用一个增加方法,抛出一个FieldFullException.使用相应的set方法,例如setString(),来修改一个已经存在的值.

if (event.countValues(Event.LOCATION) > 0) {

event.setString(Event.LOCATION, 0, Event.ATTR_NONE, "Board Room");

}

保存一个约会

提示: importEvent()方法保存一个约会,因此你没有必要调用commit().

调用commit()方法.在你保存之前,为了决定自从上一次保存任务之后任何字段是否发生变化,调用isModified().

if(event.isModified()) {

event.commit();

}

获取约会信息

获取一个约会的迭代

调用PIMList.items().

EventList eventList = (EventList)PIM.getInstance().openPIMList(

PIM.EVENT_LIST, PIM.READ_ONLY);

Enumeration e = eventList.items();

获取字段的ID和值

对于某个特定的ToDo项,为获取一组包含其数据的字段ID.调用PIMItem.getFields().

获取字段值,调用PIMItem.getString().

while (e.hasMoreElements()) {

Event event = (Event)e.nextElement();

int[] fieldIds = event.getFields();

int id;

for(int index = 0; index < fieldIds.length; ++index) {

id = fieldIds[index];

if(e.getPIMList().getFieldDataType(id) == STRING) {

for(int j=0; j < event.countValues(id); ++j) {

String value = event.getString(id, j);

System.out.println(event.getFieldLable(id) + "=" + value);

}

将约会转化为一个序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如iCal.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.EVENT_LIST).

将一个项写为序列化格式

调用toSerialFormat().

EventList eventList = (EventList)PIM.getInstance().openPIMList(

PIM.EVENT_LIST, PIM.READ_ONLY );

ByteArrayOutputStream bytestream = new ByteArrayOutputStream();

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

Enumeration e = eventList.items();

while (e.hasMoreElements()) {

Event event = (Event)e.nextElement();

PIM.getInstance().toSerialFormat(event, byteStream, "UTF8", dataFormats[0]);

}

导入一个约会

为了返回一组PIMItem对象,调用fromSerialFormat(java.io.InputStream is, java.lang.String enc).

为了新增一个约会,调用EventList.importEvent().

注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.

// Convert an existing appointment into a iCal and then import the iCal as a new

// appointment.

String[] dataFormats = PIM.eventSerialFormats();

// Write appointment to iCal.

ByteArrayOutputStream os = new ByteArrayOutputStream();

PIM.getInstance().toSerialFormat(event, os, "UTF8", dataFormats[0]);

// Import appointment from iCal.

ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());

PIMItem[] pi = PIM.getInstance().fromSerialFormat(is, "UTF8");

EventList eventList = (EventList)PIM.getInstance().openPIMList(

PIM.EVENT_LIST, PIM.READ_WRITE);

Event event2 = eventList.importEvent((Event)pi[0]);

关闭一个事件列表

调用 close().

try {

eventList.close();

}

catch (PimException e) {

// Handle exception.

}

代码实例

下面的实例显示了一个屏幕,它允许用户在日历中创建一个新的,重复的约会.你可以将此例和ContactsDemo.java结合起来允许用户邀请参与者到这个会议中.为获取更多信息,参看31页的”ContactsDemo.java”.

例:EventDemo.java

/**

* EventDemo.java

package com.rim.samples.docs.eventdemo;

import java.io.*;

import java.util.*;

import javax.microedition.pim.*;

import net.rim.device.api.ui.*;

import net.rim.device.api.ui.component.*;

import net.rim.device.api.ui.container.*;

import net.rim.device.api.i18n.*;

import net.rim.device.api.system.*;

import net.rim.device.api.util.*;

import com.rim.samples.docs.baseapp.*;

public final class EventDemo extends BaseApp {

private EventScreen _eventScreen;

public static void main(String[] args) {

new EventDemo().enterEventDispatcher();

}

private EventDemo() {

_eventScreen = new EventScreen();

pushScreen(_eventScreen);

}

protected void onExit() {

}

public final static class EventScreen extends MainScreen {

private EditField _subject, _location;

private SaveMenuItem _saveMenuItem;

private DateField _startTime, _endTime;

private ObjectChoiceField _repeat;

private Event event;

private class SaveMenuItem extends MenuItem {

public SaveMenuItem() {

super(null, 0, 100000, 5);

}

public String toString() {

return "Save";

}

public void run() {

onSave();

}

public EventScreen() {

_saveMenuItem = new SaveMenuItem();

setTitle(new LabelField("Event Demo", LabelField.ELLIPSIS |

LabelField.USE_ALL_WIDTH) );

_subject = new EditField("Subject: ", "");

add(_subject);

_location = new EditField("Location: ","");

add(_location);

_startTime = new DateField("Start: ", System.currentTimeMillis() +

3600000, DateField.DATE_TIME);

_endTime = new DateField("End: ", System.currentTimeMillis() +

7200000, DateField.DATE_TIME);

add(new SeparatorField());

add(_startTime);

add(_endTime);

add(new SeparatorField());

String[] choices = {"None", "Daily", "Weekly", "Monthly", "Yearly"};

_repeat = new ObjectChoiceField(“Recurrence: “, choices, 0);

add(_repeat);

}

protected boolean onSave() {

try {

EventList eventList = (EventList)PIM.getInstance().

openPIMList(PIM.EVENT_LIST, PIM.WRITE_ONLY);

event = eventList.createEvent();

event.addString(Event.SUMMARY, PIMItem.ATTR_NONE,

_subject.getText());

event.addString(Event.LOCATION, PIMItem.ATTR_NONE,

_location.getText());

event.addDate(Event.END, PIMItem.ATTR_NONE, _endTime.getDate());

event.addDate(Event.START, PIMItem.ATTR_NONE,startTime.getDate());

if(_repeat.getSelectedIndex() != 0) {

event.setRepeat(setRule());

}

// Save the appointment to the Calendar.

event.commit();

//reset fields on screen

_subject.setText("");

_location.setText("");

_endTime.setDate(null);

_startTime.setDate(null);

_repeat.setSelectedIndex(0);

return true;

}

catch (PIMException e) {

System.err.println(e);

}

return false;

}

private RepeatRule setRule() {

RepeatRule rule = new RepeatRule();

int index = _repeat.getSelectedIndex();

if (index == 0) {

rule.setInt(RepeatRule.FREQUENCY, RepeatRule.DAILY);

}

if (index == 1) {

rule.setInt(RepeatRule.FREQUENCY, RepeatRule.WEEKLY);

}

if (index == 2) {

rule.setInt(RepeatRule.FREQUENCY, RepeatRule.MONTHLY);

}

if (index == 3) {

rule.setInt(RepeatRule.FREQUENCY, RepeatRule.YEARLY);

}

return rule;

}

protected void makeMenu(Menu menu, int instance) {

menu.add(_saveMenuItem);

menu.addSeparator();

super.makeMenu(menu, instance);

}

Updated History:

Last Updated:2007年1月24日
Last Updated:2006年4月28日

专注于blackberry » 文档

MNC和MCC

好消息，Blackberry开发文档基础篇发布。

BlackBerry 应用程序开发者指南 第二卷：高级–第12章 管理应用程序

第12章 管理应用程序

锁住一个BlackBerry设备

决定一个BlackBerry设备是否锁住

解锁一个BlackBerry设备

从BlackBerry设备数据库删除一个模块

BlackBerry 应用程序开发者指南 第二卷：高级–第13章 应用程序间共享运行时对象

第13章 应用程序间共享运行时对象

BlackBerry 应用程序开发者指南 第二卷：高级–第11章 管理通知(Notification)

第11章 管理通知(Notification)

通知API

为延续事件提供一个自定义的UI通知

定义一个唯一ID

设置用户Profile选项

启动BlackBerry设备数据备份

启动BlackBerry设备数据恢复

BlackBerry 应用程序开发者指南 第二卷：高级–第10章 访问安装和配置信息

第10章 访问安装和配置信息

服务定制API(Service Book API)

BlackBerry 应用程序开发者指南 第二卷：高级–第8章 存储持久数据

第8章 存储持久数据

MIDP存储记录

BlackBerry持久存储

创建一个唯一的long键

BlackBerry 应用程序开发者指南 第二卷：高级–第7章 与BlackBerry应用程序通信

第7章 与BlackBerry应用程序通信

启动BlackBerry应用程序

调用API新功能

加入一个菜单项到Blackberry应用程序中

BlackBerry 应用程序开发者指南 第二卷：高级–第6章 访问电话应用程序

第6章 访问电话应用程序

电话API

将DTMF音调增加到发送队列中

BlackBerry 应用程序开发者指南 第二卷：高级–第3章 集成PIM功能

第3章 集成PIM功能

PIM列表

PIM项

BlackBerry特定的地址字段

创建一个重复发生(recurring)的约会

BlackBerry 应用程序开发者指南第二卷：高级–第12章管理应用程序

第12章管理应用程序

BlackBerry 应用程序开发者指南第二卷：高级–第13章应用程序间共享运行时对象

第13章应用程序间共享运行时对象

BlackBerry 应用程序开发者指南第二卷：高级–第11章管理通知(Notification)

第11章管理通知(Notification)

BlackBerry 应用程序开发者指南第二卷：高级–第10章访问安装和配置信息

第10章访问安装和配置信息

BlackBerry 应用程序开发者指南第二卷：高级–第8章存储持久数据

第8章存储持久数据

BlackBerry 应用程序开发者指南第二卷：高级–第7章与BlackBerry应用程序通信

第7章与BlackBerry应用程序通信

BlackBerry 应用程序开发者指南第二卷：高级–第6章访问电话应用程序

第6章访问电话应用程序

BlackBerry 应用程序开发者指南第二卷：高级–第3章集成PIM功能

第3章集成PIM功能