1 /*

     2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Defination of class CCalendarInterface

    15 *

    16 */

    17 

    18 // Namepace: com.nokia.device.service

    19 

    20 var __device_landmarks_service_entry = {

    21     "name": null,

    22     "version": null,

    23     "proto": __device_landmarks,

    24     "descriptor": __device_landmarks_descriptor,

    25     "providers": [{

    26         "descriptor": __sp_landmarks_descriptor,

    27         "instance": __sp_landmarks_instance

    28     }]

    29 };

    30 

    31 // Private location prototype: called from service factory

    32 function __device_landmarks(provider){

    33     //Private properties

    34     this.provider = provider;

    35     //Read-only properties

    36     this.interfaceName = provider.descriptor.interfaceName;

    37     this.version = provider.descriptor.version;

    38     //Core methods

    39     this.startEditor = __device_landmarks_startEditor;

    40     //Extended methods

    41     this.getCategories = __device_landmarks_getCategories;

    42     this.getLandmarks = __device_landmarks_getLandmarks;

    43     this.addCategory = __device_landmarks_add_category;

    44     this.updateCategory = __device_landmarks_update_category;

    45     this.updateLandmark = __device_landmarks_update_landmark;

    46     this.addLandmark = __device_landmarks_add_landmark;

    47     this.deleteCategory = __device_landmarks_delete_category;

    48     this.deleteLandmark = __device_landmarks_delete_landmark;

    49     this.importLandmarks = __device_landmarks_import_landmarks;

    50     this.exportLandmarks = __device_landmarks_export_landmarks;

    51     this.organizeLandmarks = __device_landmarks_organize_landmarks;

    52     ;

    53     this.cancel = __device_landmarks_cancel;

    54 }

    55 

    56 function __device_landmarks_descriptor(provider){

    57     this.interfaceName = provider.interfaceName;

    58     this.version = provider.version;

    59 }

    60 

    61 function __device_landmarks_startEditor(callback, entry){

    62     this.provider.startEditor(callback, entry);

    63 }

    64 

    65 function __device_landmarks_getCategories(callback, name, errorcb){

    66     return this.provider.getCategories(callback, name, errorcb);

    67 }

    68 

    69 

    70 function __device_landmarks_getLandmarks(callback, match, errcb){

    71     return this.provider.getLandmarks(callback, match, errcb);

    72 }

    73 

    74 function __device_landmarks_add_category(callback, categoryItem, ErrorCallback){

    75     return this.provider.addCategory(callback, categoryItem, ErrorCallback);

    76 }

    77 

    78 

    79 function __device_landmarks_add_landmark(callback, landmarkItem, ErrorCallback){

    80     return this.provider.addLandmark(callback, landmarkItem, ErrorCallback);

    81 }

    82 

    83 function __device_landmarks_delete_category(callback, categoryId, ErrorCallback){

    84     return this.provider.deleteCategory(callback, categoryId, ErrorCallback);

    85 }

    86 

    87 function __device_landmarks_delete_landmark(callback, landmarkId, ErrorCallback){

    88     return this.provider.deleteLandmark(callback, landmarkId, ErrorCallback);

    89 }

    90 

    91 function __device_landmarks_update_landmark(callback, landmarkItem, ErrorCallback){

    92     return this.provider.updateLandmark(callback, landmarkItem, ErrorCallback);

    93 }

    94 

    95 function __device_landmarks_update_category(callback, categoryItem, ErrorCallback){

    96     return this.provider.updateCategory(callback, categoryItem, ErrorCallback);

    97 }

    98 

    99 function __device_landmarks_import_landmarks(callback, sourceFileUri, mimetype, ErrorCallback){

   100     return this.provider.importLandmarks(callback, sourceFileUri, mimetype, ErrorCallback);

   101 }

   102 

   103 function __device_landmarks_export_landmarks(callback, landmarkIdList, destFileUri, mimetype, ErrorCallback){

   104     return this.provider.exportLandmarks(callback, landmarkIdList, destFileUri, mimetype, ErrorCallback);

   105 }

   106 

   107 function __device_landmarks_organize_landmarks(callback, landmarkIdList, categoryId, associate, ErrorCallback){

   108     return this.provider.organizeLandmarks(callback, landmarkIdList, categoryId, associate, ErrorCallback);

   109 }

   110 

   111 function __device_landmarks_cancel(transactionId){

   112     return this.provider.cancel(transactionId);

   113 }

   114 

   115 

   116 

   117 

   118 /*

   119  Copyright � 2009 Nokia. All rights reserved.

   120  Code licensed under the BSD License:

   121  Software License Agreement (BSD License) Copyright � 2009 Nokia.

   122  All rights reserved.

   123  Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

   124  Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

   125  Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

   126  Neither the name of Nokia Corporation. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Nokia Corporation.

   127  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

   128  version: 1.0

   129  */

   130 //utillity function for converting error code from PS to CJSE codes

   131 //this gets used in communicating errors via error callback

   132 var err_missing_argument = 1003;

   133 var err_bad_argument = 1002;

   134 var err_ServiceNotSupported = 1004;

   135 var err_InvalidService_Argument = 1000;

   136 function convertFromPS2JS(PSCode){

   137     var JSCodeValue = new DeviceAPIError(0, "dummy");

   138     var JsErrCode;

   139     switch (PSCode) {

   140         case 1016:

   141             JsErrCode = JSCodeValue.TIMEOUT_ERR;

   142             break;

   143         case 1012:

   144             JsErrCode = JSCodeValue.DATA_NOT_FOUND_ERR;

   145             break;

   146         case 1010:

   147             JsErrCode = JSCodeValue.DATA_ALREADY_EXISTS_ERR;

   148             break;

   149         case 1009:

   150             JsErrCode = JSCodeValue.SERVICE_BUSY_ERR;

   151             break;

   152         case 1005:

   153             JsErrCode = JSCodeValue.SERVICE_IN_USE_ERR;

   154             break;

   155         default:

   156             JsErrCode = 1001;

   157     }

   158     return JsErrCode;

   159 }

   160 

   161 // S60 sp-based landmarks provider

   162 

   163 function __sp_landmarks_descriptor(){

   164     //Read-only properties

   165     this.interfaceName = "landmarks";

   166     if (window.__Service_Interface_Ver) 

   167         this.version = __Service_Interface_Ver;

   168     else 

   169         this.version = 1.0;

   170     //Class-static properties 

   171 }

   172 

   173 function __sp_landmarks_instance(){

   174     //Descriptor

   175     this.descriptor = new __sp_landmarks_descriptor();

   176     //Core methods

   177     this.startEditor = __sp_landmarks_startEditor;

   178     //Extended methods

   179     this.getCategories = __sp_landmarks_category_getList;

   180     this.getCategoriesCb = __sp_landmarks_category_getList_cb;

   181     

   182     this.addCategory = __sp_landmarks_category_add;

   183     this.addCategoryCb = __sp_landmarks_category_add_cb;

   184     

   185     this.updateCategory = __sp_landmarks_category_update;

   186     this.updateCategoryCb = __sp_landmarks_category_update_cb;

   187     

   188     this.deleteCategory = __sp_landmarks_category_delete;

   189     this.deleteCategoryCb = __sp_landmarks_category_delete_cb;

   190     

   191     this.getLandmarks = __sp_landmarks_getList;

   192     this.getLandmarksCb = __sp_landmarks_getList_cb;

   193     

   194     this.addLandmark = __sp_landmarks_add;

   195     this.addLandmarkCb = __sp_landmarks_add_cb;

   196     

   197     this.updateLandmark = __sp_landmarks_update;

   198     this.updateLandmarkCb = __sp_landmarks_update_cb;

   199     

   200     this.deleteLandmark = __sp_landmarks_delete;

   201     this.deleteLandmarkCb = __sp_landmarks_delete_cb;

   202     

   203     this.importLandmarks = __sp_landmarks_import;

   204     this.importLandmarksCb = __sp_landmarks_import_cb;

   205     

   206     this.exportLandmarks = __sp_landmarks_export;

   207     this.exportLandmarksCb = __sp_landmarks_export_cb;

   208     

   209     this.organizeLandmarks = __sp_landmarks_organize;

   210     this.organizeLandmarksCb = __sp_landmarks_organize_cb;

   211     

   212     this.temporarySCb = null;

   213     this.temporaryECb = null;

   214     

   215     this.cancel = __sp_landmarks_cancel;

   216     //Private data 

   217     try {

   218         this.so = device.getServiceObject("Service.Landmarks", "IDataSource");

   219     } 

   220     catch (e) {

   221         __device_handle_exception(e, "Landmarks service not available");

   222     }

   223 }

   224 

   225 // TBD: We MUST get rid of this when underlying sp supports category names directly

   226 // For one thing this is not localized!

   227 

   228 var __SP_CATEGORY_MIN_LOCAL_ID = 16;

   229 

   230 var __sp_category_list = [{

   231     id: 1,

   232     globalId: 3000,

   233     name: "Accommodation"

   234 }, {

   235     id: 2,

   236     globalId: 6000,

   237     name: "Businesses"

   238 }, {

   239     id: 3,

   240     globalId: 9000,

   241     name: "Telecommunications"

   242 }, {

   243     id: 4,

   244     globalId: 12000,

   245     name: "Education"

   246 }, {

   247     id: 5,

   248     globalId: 15000,

   249     name: "Entertainment"

   250 }, {

   251     id: 6,

   252     globalId: 18000,

   253     name: "Food and drink"

   254 }, {

   255     id: 7,

   256     globalId: 21000,

   257     name: "Geographical locations"

   258 }, {

   259     id: 8,

   260     globalId: 24000,

   261     name: "Outdoor activities"

   262 }, {

   263     id: 9,

   264     globalId: 27000,

   265     name: "People"

   266 }, {

   267     id: 10,

   268     globalId: 30000,

   269     name: "Public services"

   270 }, {

   271     id: 11,

   272     globalId: 33000,

   273     name: "Places of worship"

   274 }, {

   275     id: 12,

   276     globalId: 36000,

   277     name: "Shopping"

   278 }, {

   279     id: 13,

   280     globalId: 39000,

   281     name: "Sightseeing"

   282 }, {

   283     id: 14,

   284     globalId: 42000,

   285     name: "Sports"

   286 }, {

   287     id: 15,

   288     globalId: 45000,

   289     name: "Transport"

   290 }];

   291 

   292 /* ------ Wrap sp iterators ------- */

   293 

   294 function __sp_landmarks_category_iterator(js_iterator){

   295     this.iter = js_iterator;

   296     this.next = __sp_landmarks_category_iterator_get_next;

   297     this.hasNext = __sp_landmarks_category_iterator_has_next;

   298     

   299     //indicate whether iterator has been populated atleast once

   300     this.hasElement = false;

   301     //refers to the current category item

   302     this.catItem = null;

   303     this.close = __sp_landmarks_category_close;

   304 }

   305 

   306 function __sp_landmarks_category_close(){

   307     this.iter.close();

   308 }

   309 

   310 function __sp_landmarks_category_iterator_has_next(){

   311     if (this.hasElement) {

   312         if (this.catItem !== null) {

   313             return true;

   314         }

   315         else {

   316             return false;

   317         }

   318         

   319     }

   320     else {

   321         this.catItem = this.iter.getNext();

   322         this.hasElement = true;

   323         if (typeof this.catItem == "undefined") {

   324             this.catItem = null;

   325             return false;

   326         }

   327         else {

   328             return true;

   329         }

   330     }

   331 }

   332 

   333 function __sp_landmarks_category_iterator_get_next(){

   334     if (this.hasElement) {

   335         var tempitem = new Object();

   336         tempitem = this.catItem;

   337         //update

   338         this.catItem = this.iter.getNext();

   339         if (typeof(this.catItem) == "undefined") {

   340             this.catItem = null;

   341         }

   342         return new __sp_device_category_obj(tempitem);

   343     }

   344     else {

   345         this.catItem = this.iter.getNext();

   346         if (typeof this.catItem == "undefined") {

   347             this.hasElement = true;

   348             this.catItem = null;

   349             return null;

   350             

   351         }

   352         else {

   353             this.hasElement = true;

   354             var tempObject = new Object();

   355             tempObject = this.lmItem;

   356             //update 

   357             

   358             this.catItem = this.iter.getNext();

   359             if (typeof(this.catItem) == "undefined") {

   360                 this.catItem = null;

   361             }

   362             return new __sp_device_category_obj(tempObject);

   363         }

   364     }

   365 }

   366 

   367 //landmark iterator

   368 function __sp_landmarks_iterator(js_iterator){

   369     this.iter = js_iterator;

   370     this.next = __sp_landmarks_iterator_get_next;

   371     this.hasNext = __sp_landmarks_iterator_has_next;

   372     

   373     //indicate whether iterator has been populated atleast once

   374     this.hasElement = false;

   375     //refers to the current landmark item

   376     this.lmItem = null;

   377     this.close = __sp_landmarks_landmarkitem_close;

   378 }

   379 

   380 function __sp_landmarks_landmarkitem_close(){

   381     this.iter.close();

   382 }

   383 

   384 // Parameter objects

   385 //converts from LIW position to JS wrapper positionfield object

   386 function __sp_device_landmark_location_obj(sp_location){

   387     this.longitude = (sp_location.Longitude == undefined) ? null : sp_location.Longitude;

   388     this.latitude = (sp_location.Latitude == undefined) ? null : sp_location.Latitude;

   389     if (sp_location.Altitude) 

   390         this.altitude = sp_location.Altitude;

   391     if (sp_location.HAccuracy) 

   392         this.hAccuracy = sp_location.HAccuracy;

   393     if (sp_location.VAccuracy) 

   394         this.vAccuracy = sp_location.VAccuracy;

   395 }

   396 

   397 //this is being used for converting position field in criteria for getLandmarks.

   398 function __sp_landmark_position_obj(location){

   399     if ((location.longitude !== undefined) &&

   400     (location.longitude !== null) &&

   401     (location.longitude !== "")) {

   402         this.Longitude = location.longitude;

   403     }

   404     if ((location.latitude !== undefined) &&

   405     (location.latitude !== null) &&

   406     (location.latitude !== "")) {

   407         this.Latitude = location.latitude;

   408     }

   409     

   410     

   411     /*if(location.altitude) 

   412     

   413      this.Altitude = location.altitude;

   414     

   415      if(location.hAccuracy)

   416     

   417      this.HAccuracy = location.hAccuracy;

   418     

   419      if(location.vAccuracy)

   420     

   421      this.VAccuracy = location.vAccuracy;*/

   422     

   423 }

   424 

   425 //use this to convert from positon filed of landmarkitem to convert it to position field 

   426 //in LIW of landmark item

   427 function __sp_landmark_position_obj_fromJS_2LIW(location){

   428 	var error = new DeviceAPIError(0, "dummy");

   429 	if (typeof(location) != "object"){

   430 		throw new DeviceAPIError(error.INVALID_ARG_ERR, 'position must be of type object');	

   431 	}

   432 	var loFound = false;

   433 	var laFound = false;

   434 	if ((location.longitude !== undefined)

   435 	     && (location.longitude !== null)

   436 		 && (location.longitude !== "")){

   437 		this.Longitude = location.longitude;

   438 		loFound = true;	 

   439 	}

   440 	if ((location.latitude !== undefined)

   441 	     && (location.latitude !== null)

   442 		 && (location.latitude !== "")){

   443 		this.Latitude = location.latitude;

   444 		laFound = true;	 

   445 	}

   446     if (!(loFound && laFound)) {

   447 		throw new DeviceAPIError(error.MISSING_ARG_ERR, 'missing position field');

   448 	}

   449     if (location.altitude) 

   450         this.Altitude = location.altitude;

   451     if (location.hAccuracy) 

   452         this.HAccuracy = location.hAccuracy;

   453     if (location.vAccuracy) 

   454         this.VAccuracy = location.vAccuracy;

   455 }

   456 

   457 function __sp_landmark_bounded_area_obj(area){

   458 

   459     var error = new DeviceAPIError(0, "dummy");

   460     var c1Found = false;

   461     var c2Found = false;

   462     if ((area.coordinate1 !== undefined) &&

   463     (area.coordinate1 !== null) &&

   464     (area.coordinate1 !== "")) {

   465         if (typeof(area.coordinate1) != "object") {

   466             throw new DeviceAPIError(error.INVALID_ARG_ERR, 'coordinate1 must be an object');

   467         }

   468         else {

   469             var latFound = false;

   470             var longFound = false;

   471             if ((area.coordinate1.latitude !== undefined) &&

   472             (area.coordinate1.latitude !== null) &&

   473             (area.coordinate1.latitude !== "")) {

   474                 this.NorthLatitude = area.coordinate1.latitude;

   475                 latFound = true;

   476             }

   477             

   478             

   479             if ((area.coordinate1.longitude !== undefined) &&

   480             (area.coordinate1.longitude !== null) &&

   481             (area.coordinate1.longitude !== "")) {

   482                 this.EastLongitude = area.coordinate1.longitude;

   483                 longFound = true;

   484             }

   485             if (!(latFound && longFound)) {

   486                 throw new DeviceAPIError(error.MISSING_ARG_ERR, 'missing position field');

   487             }

   488             c1Found = true;

   489             

   490         }

   491         

   492         

   493     }

   494     if ((area.coordinate2 !== undefined) &&

   495     (area.coordinate2 !== null) &&

   496     (area.coordinate2 !== "")) {

   497         if (typeof(area.coordinate2) != "object") {

   498             throw new DeviceAPIError(error.INVALID_ARG_ERR, 'coordinate2 must be an object');

   499         }

   500         else {

   501             var latFound = false;

   502             var longFound = false;

   503             if ((area.coordinate2.latitude !== undefined) &&

   504             (area.coordinate2.latitude !== null) &&

   505             (area.coordinate2.latitude !== "")) {

   506                 this.SouthLatitude = area.coordinate2.latitude;

   507                 latFound = true;

   508             }

   509             

   510             

   511             if ((area.coordinate2.longitude !== undefined) &&

   512             (area.coordinate2.longitude !== null) &&

   513             (area.coordinate2.longitude !== "")) {

   514                 this.WestLongitude = area.coordinate2.longitude;

   515                 longFound = true;

   516             }

   517             if (!(latFound && longFound)) {

   518                 throw new DeviceAPIError(error.MISSING_ARG_ERR, 'missing position field');

   519             }

   520             c2Found = true;

   521             

   522         }

   523         

   524         

   525     }

   526     if (!(c1Found && c2Found)) {

   527         throw new DeviceAPIError(error.MISSING_ARG_ERR, 'missing position field');

   528     }

   529     

   530 }

   531 

   532 

   533 //converts from LIW address to JS wrapper AddressDetails

   534 

   535 function __sp_device_landmark_address_obj(sp_address){

   536     if (sp_address.Street) 

   537         this.street = sp_address.Street;

   538     if (sp_address.City) 

   539         this.city = sp_address.City;

   540     if (sp_address.state) 

   541         this.state = sp_address.state;

   542     if (sp_address.AreaCode) 

   543         this.postalCode = sp_address.AreaCode;

   544     if (sp_address.Country) 

   545         this.country = sp_address.Country;

   546     if (sp_address.BuildingName) 

   547         this.building = sp_address.BuildingName;

   548     if (sp_address.Telephone) 

   549         this.phone = sp_address.Telephone;

   550 }

   551 

   552 // sp problem: no way to specify state/province?

   553 

   554 function __sp_landmark_address_obj(address){

   555 	var error = new DeviceAPIError(0, "dummy");

   556 	if (typeof(address) != "object"){

   557 		throw new DeviceAPIError(error.MISSING_ARG_ERR, 'address must be of type object');	

   558 	}

   559 	

   560     if (address.street !== undefined){

   561 		if (address.street === null){

   562 			this.Street = "";	

   563 		}

   564 		else {

   565 			this.Street = address.street;	

   566 		}

   567 			

   568 	} 

   569 	if (address.city !== undefined){

   570 		if (address.city === null){

   571 			this.City = "";	

   572 		}

   573 		else {

   574 			this.City = address.city;	

   575 		}

   576 			

   577 	} 

   578 	if (address.state !== undefined){

   579 		if (address.state === null){

   580 			this.state = "";	

   581 		}

   582 		else {

   583 			this.state = address.state;	

   584 		}

   585 			

   586 	} 

   587 	if (address.postalCode !== undefined){

   588 		if (address.postalCode === null){

   589 			this.AreaCode = "";	

   590 		}

   591 		else {

   592 			this.AreaCode = address.postalCode;	

   593 		}

   594 			

   595 	} 

   596 	if (address.country !== undefined){

   597 		if (address.country === null){

   598 			this.Country = "";	

   599 		}

   600 		else {

   601 			this.Country = address.country;	

   602 		}

   603 			

   604 	} 

   605 	if (address.building !== undefined){

   606 		if (address.building === null){

   607 			this.BuildingName = "";	

   608 		}

   609 		else {

   610 			this.BuildingName = address.building;	

   611 		}

   612 			

   613 	} 

   614 	if (address.phone !== undefined){

   615 		if (address.phone === null){

   616 			this.Telephone = "";	

   617 		}

   618 		else {

   619 			this.Telephone = address.phone;	

   620 		}

   621 			

   622 	} 

   623     

   624 }

   625 

   626 function __sp_add_category_ids_for_names(names){

   627     var errObj = new DeviceAPIError(0, "dummy");

   628     var retval = new Array();

   629     

   630     for (var i in names) {

   631         if ((names[i] !== undefined) &&

   632         (names[i] !== "") &&

   633         (names[i] !== null)) {

   634             if (typeof(names[i]) != "string") {

   635                 throw new DeviceAPIError(errObj.INVALID_ARG_ERR, 'category should be of type string');

   636             }

   637             else {

   638                 retval.push(names[i].toString());

   639             }

   640             

   641             

   642         }

   643         

   644     }

   645     return retval;

   646 }

   647 

   648 function __sp_get_category_ids_for_names(names){

   649     var errObj = new DeviceAPIError(0, "dummy");

   650     var retval = new Array();

   651     var isCatGlobal = 0;// to check if the category passed is a global category

   652     for (var i in names) {

   653         if (typeof(names[i]) != "string") {

   654             throw new DeviceAPIError(errObj.INVALID_ARG_ERR, 'category should be of type string');

   655         }

   656         for (var ii in __sp_category_list) {

   657             //__device_debug(names[i] + " ==? " + __sp_category_list[ii].name);

   658             

   659             if (__sp_category_list[ii].name.toLowerCase() == names[i].toLowerCase()) {

   660                 retval.push(__sp_category_list[ii].id.toString());

   661                 isCatGlobal = 1;

   662             }

   663         }

   664         if (isCatGlobal == 0) {

   665             return null;

   666         }

   667         isCatGlobal = 0;// set the flag to 0

   668     }

   669     return retval;

   670 }

   671 

   672 //converts from LIW to JS wrapper paramater

   673 function __sp_device_landmark_obj(sp_landmark){

   674     this.landmarkId = sp_landmark.id;

   675     if (sp_landmark.LandmarkName) {

   676         this.name = sp_landmark.LandmarkName;

   677     }

   678     if (sp_landmark.LandmarkDesc) {

   679         this.description = sp_landmark.LandmarkDesc;

   680     }

   681     if (sp_landmark.CoverageRadius) {

   682         this.coverageRadius = sp_landmark.CoverageRadius;

   683     }

   684     if (sp_landmark.LandmarkPosition) {

   685         this.position = new __sp_device_landmark_location_obj(sp_landmark.LandmarkPosition);

   686     }

   687     if (sp_landmark.CategoryInfo) {

   688         this.categoryIds = sp_landmark.CategoryInfo;

   689     }

   690     

   691     if (sp_landmark.LandmarkFields) {

   692         this.address = new __sp_device_landmark_address_obj(sp_landmark.LandmarkFields);

   693     }

   694 }

   695 

   696 function __sp_landmarks_addLocality(add){

   697     var errLoc = new DeviceAPIError(0, "dummy");

   698     if (typeof(add) != "object") {

   699         throw new DeviceAPIError(errLoc.INVALID_ARG_ERR, 'address should be of type object');

   700     }

   701     if ((add.street !== undefined) &&

   702     (add.street !== null) &&

   703     (add.street !== "")) {

   704     

   705         this.Street = add.street;

   706         

   707     }

   708     if ((add.city !== undefined) &&

   709     (add.city !== null) &&

   710     (add.city !== "")) {

   711     

   712         this.City = add.city;

   713         

   714     }

   715     if ((add.state !== undefined) &&

   716     (add.state !== null) &&

   717     (add.state !== "")) {

   718     

   719         this.state = add.state;

   720         

   721     }

   722     if ((add.postalCode !== undefined) &&

   723     (add.postalCode !== null) &&

   724     (add.postalCode !== "")) {

   725     

   726         this.AreaCode = add.postalCode;

   727         

   728     }

   729     if ((add.country !== undefined) &&

   730     (add.country !== null) &&

   731     (add.country !== "")) {

   732     

   733         this.Country = add.country;

   734         

   735     }

   736     if ((add.building !== undefined) &&

   737     (add.building !== null) &&

   738     (add.building !== "")) {

   739     

   740         this.BuildingName = add.building;

   741         

   742     }

   743     if ((add.phone !== undefined) &&

   744     (add.phone !== null) &&

   745     (add.phone !== "")) {

   746     

   747         this.Telephone = add.phone;

   748         

   749     }

   750 }

   751 

   752 function __sp_landmarks_addPosition(pos){

   753     var errPos = new DeviceAPIError(0, "dummy");

   754     if (typeof(pos) != "object") {

   755         throw new DeviceAPIError(errPos.INVALID_ARG_ERR, 'position should be of type object');

   756     }

   757     

   758     if ((pos.longitude !== undefined) &&

   759     (pos.longitude !== null) &&

   760     (pos.longitude !== "")) {

   761     

   762         this.Longitude = pos.longitude;

   763         //alert("longitude found");

   764     

   765     }

   766     if ((pos.latitude !== undefined) &&

   767     (pos.latitude !== null) &&

   768     (pos.latitude !== "")) {

   769     

   770         this.Latitude = pos.latitude;

   771         //alert("latitude found");

   772     

   773     }

   774     if ((pos.altitude !== undefined) &&

   775     (pos.altitude !== null) &&

   776     (pos.altitude !== "")) {

   777     

   778         this.Altitude = pos.altitude;

   779         

   780     }

   781     if ((pos.hAccuracy !== undefined) &&

   782     (pos.hAccuracy !== null) &&

   783     (pos.hAccuracy !== "")) {

   784     

   785         this.HAccuracy = pos.hAccuracy;

   786         

   787     }

   788     if ((pos.vAccuracy !== undefined) &&

   789     (pos.vAccuracy !== null) &&

   790     (pos.vAccuracy !== "")) {

   791     

   792         this.VAccuracy = pos.vAccuracy;

   793         

   794     }

   795 }

   796 

   797 function __sp_landmarks_addLmObject(lm){

   798     var posSet = false;

   799     var errObj = new DeviceAPIError(0, "dummy");

   800     if ((lm.name !== undefined) &&

   801     (lm.name !== null) &&

   802     (lm.name !== "")) {

   803     

   804         this.LandmarkName = lm.name;

   805         

   806     }

   807     if ((lm.description !== undefined) &&

   808     (lm.description !== null) &&

   809     (lm.description !== "")) {

   810     

   811         this.LandmarkDesc = lm.description;

   812         

   813     }

   814     if ((lm.position !== undefined) &&

   815     (lm.position !== null) &&

   816     (lm.position !== "")) {

   817         //alert("adding position");

   818         this.LandmarkPosition = new __sp_landmarks_addPosition(lm.position);

   819         posSet = true;

   820         //alert("pos="+this.position); 

   821     

   822     }

   823     if ((lm.coverageRadius !== undefined) &&

   824     (lm.coverageRadius !== null) &&

   825     (lm.coverageRadius !== "")) {

   826     

   827         if (posSet) {

   828             this.CoverageRadius = lm.coverageRadius;

   829         }

   830         else {

   831             throw new DeviceAPIError(errObj.MISSING_ARG_ERR, 'missing position');

   832         }

   833         

   834         

   835     }

   836     

   837     if ((lm.categoryIds !== undefined) &&

   838     (lm.categoryIds !== null) &&

   839     (lm.categoryIds !== "")) {

   840         if (typeof(lm.categoryIds) != 'object') {

   841             throw new DeviceAPIError(errObj.INVALID_ARG_ERR, 'categoryids should be of type object');

   842         }

   843         

   844         this.CategoryInfo = __sp_add_category_ids_for_names(lm.categoryIds);

   845         if (!this.CategoryInfo) {

   846             throw new DeviceAPIError(errObj.MISSING_ARG_ERR, 'invalid category');

   847             

   848         }

   849         

   850     }

   851     if ((lm.address !== undefined) &&

   852     (lm.address !== null) &&

   853     (lm.address !== "")) {

   854     

   855         this.LandmarkFields = new __sp_landmarks_addLocality(lm.address);

   856         

   857     }

   858     //dummy object

   859     this.dummyField = "dummyfield";

   860     

   861 }

   862 

   863 //this converts from JS landmarkitem to LIW landmark item

   864 //being used by updateLandmark API

   865 function __sp_landmark_obj(landmark, str){

   866 	var error = new DeviceAPIError(0, "dummy");

   867     if (landmark.name !== undefined){

   868 		if (landmark.name === null){

   869 			this.LandmarkName = "";	

   870 		}

   871 		else {

   872 			this.LandmarkName = landmark.name;	

   873 		}

   874 		

   875 	} 

   876         

   877     if ((landmark.landmarkId === undefined)

   878 	     || (landmark.landmarkId === null)

   879 		 || (landmark.landmarkId === "")) 

   880 		 throw new DeviceAPIError(error.MISSING_ARG_ERR, 'for updating; id must be supplied');

   881 	else 

   882         this.id = landmark.landmarkId;

   883     if (landmark.description !== undefined){

   884 		if (landmark.description === null){

   885 			this.LandmarkDesc = "";	

   886 		}

   887 		else {

   888 			this.LandmarkDesc = landmark.description;	

   889 		}

   890 		

   891 	} 

   892         

   893     if (landmark.position) 

   894         this.LandmarkPosition = new __sp_landmark_position_obj_fromJS_2LIW(landmark.position);

   895     if (landmark.coverageRadius) 

   896         this.CoverageRadius = landmark.coverageRadius;

   897     if (landmark.categories) {

   898         this.CategoryInfo = __sp_get_category_ids_for_names(landmark.categories);

   899         if (!this.CategoryInfo) {

   900             throw new DeviceError("Landmarks: " + str + "Category is invalid", err_bad_argument);

   901         }

   902     }

   903     if (landmark.address) 

   904         this.LandmarkFields = new __sp_landmark_address_obj(landmark.address);

   905     

   906 	this.temp = "dummy";

   907 }

   908 

   909 function __sp_landmarks_iterator_has_next(){

   910     if (this.hasElement) {

   911         if (this.lmItem !== null) {

   912             return true;

   913         }

   914         else {

   915             return false;

   916         }

   917         

   918     }

   919     else {

   920         this.lmItem = this.iter.getNext();

   921         this.hasElement = true;

   922         if (typeof this.lmItem == "undefined") {

   923             this.lmItem = null;

   924             return false;

   925         }

   926         else {

   927             return true;

   928         }

   929     }

   930 }

   931 

   932 function __sp_landmarks_iterator_get_next(){

   933     if (this.hasElement) {

   934         var tempitem = new Object();

   935         tempitem = this.lmItem;

   936         //update

   937         this.lmItem = this.iter.getNext();

   938         if (typeof(this.lmItem) == "undefined") {

   939             this.lmItem = null;

   940         }

   941         return new __sp_device_landmark_obj(tempitem);

   942     }

   943     else {

   944         this.lmItem = this.iter.getNext();

   945         if (typeof this.lmItem == "undefined") {

   946             this.hasElement = true;

   947             this.lmItem = null;

   948             return null;

   949             

   950         }

   951         else {

   952             this.hasElement = true;

   953             var tempObject = new Object();

   954             tempObject = this.lmItem;

   955             //update 

   956             

   957             this.lmItem = this.iter.getNext();

   958             if (typeof(this.lmItem) == "undefined") {

   959                 this.lmItem = null;

   960             }

   961             return new __sp_device_landmark_obj(tempObject);

   962         }

   963     }

   964     

   965 }

   966 

   967 function __sp_category_obj(category){

   968     if (category.name) 

   969         this.CategoryName = category.name;

   970     if (category.categoryId) 

   971         this.id = category.categoryId;

   972 }

   973 

   974 function __sp_device_category_obj(sp_category){

   975     this.categoryId = sp_category.id;

   976     this.name = sp_category.CategoryName;

   977 }

   978 

   979 /* --------- Public methods ---------- */

   980 

   981 

   982 var LANDMARKS_APP_ID = 0x101F85A2;

   983 

   984 // Apps should take care that this is not reinvoked

   985 // while the editor is already running. 

   986 

   987 function __sp_landmarks_startEditor(__success_cb, landmark_item, _error_cb){

   988     // internal variable used in this library implementation

   989     // This will made local variable when seperate module js files gets integrated in this file.

   990     error = new DeviceAPIError(0, "dummy");

   991     if ((__success_cb === undefined) ||

   992     (__success_cb === null) ||

   993     (__success_cb === "")) 

   994         throw new DeviceAPIError(error.MISSING_ARG_ERR, 'StartEditor:Missing Success Callback');

   995     

   996     if ((typeof __success_cb) != "function") 

   997         throw new DeviceAPIError(error.INVALID_ARG_ERR, 'StartEditor:Success Callback must be of type function');

   998     

   999     if (landmark_item !== undefined) {

  1000         if ((landmark_item !== null) &&

  1001         (landmark_item !== "")) {

  1002         

  1003             throw new DeviceAPIError(error.NOT_SUPPORTED_ERR, 'startEditor:landmark item is not supported');

  1004             

  1005         }

  1006     }

  1007     

  1008     if ((_error_cb !== undefined) &&

  1009     (_error_cb !== null) &&

  1010     (_error_cb !== "")) {

  1011         if ((typeof _error_cb) != "function") 

  1012             throw new DeviceAPIError(error.INVALID_ARG_ERR, 'StartEditor:error callback must be of type function');

  1013     }

  1014     

  1015     var LANDMARKS_APP_ID = 0x101F85A2;

  1016     

  1017     

  1018     var __s60_start_and_wait_cb;

  1019     

  1020     function __s60_on_app_exit(){

  1021         window.xwidget.onshow = null;

  1022         if (__s60_start_and_wait_cb) {

  1023             __s60_start_and_wait_cb();

  1024         }

  1025     }

  1026     

  1027     var finished = function(arg1, arg2, arg3){

  1028         __success_cb(arg1, arg2, arg3);

  1029     };

  1030     __s60_start_and_wait(LANDMARKS_APP_ID, '', finished);

  1031     

  1032 }

  1033 

  1034 //oriiginal signature category_cb, name

  1035 

  1036 function __sp_landmarks_category_getList_cb(arg1, arg2, arg3){

  1037     var CbObj;

  1038     var category_cb;

  1039     var ErrorCallback;

  1040     if (this.temporarySCb) {

  1041         category_cb = this.temporarySCb;

  1042         ErrorCallback = this.temporaryECb;

  1043         this.temporarySCb = null;

  1044         this.temporaryECb = null;

  1045     }

  1046     else {

  1047         CbObj = glob_obj.getFromArray(arg1);

  1048         if (CbObj) {

  1049             category_cb = CbObj.success_cb;

  1050             ErrorCallback = CbObj.error_cb;

  1051         }

  1052         

  1053         else {

  1054             alert("Landmarks: __sp_landmarks_category_getList_cb: Callback not found ");

  1055             return;

  1056         }

  1057     }

  1058     

  1059     

  1060     var iter = null;

  1061     //if there is an error invoke user supplied error callback

  1062     if (arg3.ErrorCode || (arg2 == 4)) { //indicates an error

  1063         var scbErrCode = convertFromPS2JS(arg3.ErrorCode);

  1064         var erroObject = new DeviceAPIError(scbErrCode, arg3.ErrorMessage);

  1065         if (ErrorCallback) {

  1066             ErrorCallback(erroObject);

  1067         }

  1068     }

  1069     else {

  1070         if (arg3.ReturnValue) {

  1071             iter = new __sp_landmarks_category_iterator(arg3.ReturnValue);

  1072             category_cb(iter);

  1073         }

  1074     }

  1075     glob_obj.removeFromArray(arg1);

  1076 }

  1077 

  1078 function __sp_landmarks_category_getList(category_cb, name, ErrorCallback){

  1079     try {

  1080         //alert("calling getlist");

  1081         var error = new DeviceAPIError(0, "dummy");

  1082         //succes callback must be defined and should be of the type function

  1083         if ((category_cb === undefined) ||

  1084         (category_cb === "") ||

  1085         (category_cb === null)) {

  1086             throw new DeviceAPIError(error.MISSING_ARG_ERR, 'callback is missing');

  1087         }

  1088         if (typeof(category_cb) != "function") {

  1089             throw new DeviceAPIError(error.INVALID_ARG_ERR, 'invalid callback argument');

  1090         }

  1091         //check if errorcallback has been supplied and valid

  1092         var errcbFound = false;

  1093         if ((ErrorCallback !== undefined) &&

  1094         (ErrorCallback !== null) &&

  1095         (ErrorCallback !== "")) {

  1096             if (typeof(ErrorCallback) != "function") {

  1097                 throw new DeviceAPIError(error.INVALID_ARG_ERR, 'invalid error callback argument');

  1098             }

  1099             else {

  1100                 errcbFound = true;

  1101             }

  1102         }

  1103         //to check from here

  1104         var criteria = new Object();

  1105         modifyObjectBaseProp(criteria);

  1106         criteria.Type = "Category";

  1107         //if name has been supplied it must be of type string

  1108         if ((name !== undefined) &&

  1109         (name !== null) &&

  1110         (name !== "")) {

  1111         

  1112             if (typeof(name) != "string") {

  1113                 throw new DeviceAPIError(error.INVALID_ARG_ERR, 'name must be a string');

  1114             }

  1115             

  1116         }

  1117         

  1118         if (name) {

  1119             criteria.Filter = new Object();

  1120             modifyObjectBaseProp(criteria.Filter);

  1121             criteria.Filter.CategoryName = name;

  1122             criteria.Filter.PreviousMatchesOnly = false;

  1123         }

  1124         

  1125         this.temporarySCb = category_cb;

  1126         this.temporaryECb = ErrorCallback;

  1127         

  1128         var rval = this.so.IDataSource.GetList(criteria, this.getCategoriesCb);

  1129         

  1130         if (rval.TransactionID) {

  1131             glob_obj.addToGlobalArray(rval.TransactionID, category_cb, ErrorCallback);

  1132         }

  1133         

  1134         if (rval.ErrorCode != 0) {