Bondi logo

The Bondi Application Configuration Module: bondi.appconfig - Version 1.0

28 May 2009

Authors

© 2009 OMTP Ltd. All rights reserved. OMTP and OMTP BONDI are registered trademarks of OMTP Ltd.

Abstract

To configure applications from the Web context

Table of Contents

Summary of Methods

InterfaceMethod
AppConfigManagerDOMString get(DOMString key)
void set(DOMString key, DOMString value)

1. Introduction

This module exposes facilities that relate to application settings and preferences, including:

- static settings defined by the author of the web application.

- settings read and/or modified programmatically by the web application when it runs.

Code example
        // Request the appconfig feature.
        bondi.requestFeature(successCB, errorCB, "appconfig");

        function successCB() {
                // Get some application settings.
                var smtpServer = bondi.appconfig.get('smtp.server');
                var smtpPort   = bondi.appconfig.get('smtp.port');
                configureSMTP(smtpServer,smtpPort);
        }

        function errorCB(err) {
                alert("Failed to acquire BONDI appconfig API: " + err.message);
        }

1.1. Features

This is the list of URIs used to declare this API's features, for use in bondi.requestFeature. For each URL, the list of functions provided is provided.

http://bondi.omtp.org/api/appconfig.get

appconfig settings retrieval operations.

Device capabilities: appconfig.get

http://bondi.omtp.org/api/appconfig.set

appconfig set value operations

Device capabilities: appconfig.set

1.2. Device capabilities

appconfig.set

Sets application configuration setting

Security parameters:

  • key: configuration setting key
appconfig.get

Gets application configuration setting

Security parameters:

  • key: configuration setting key

2. Interfaces

2.1. AppConfigManager

Interface to set/retrieve appconfig settings. 

        interface AppConfigManager {
                DOMString get(in DOMString key)
                        raises(SecurityError);

                void set(in DOMString key, in DOMString value)
                        raises(SecurityError);
        };

Methods

get

Retrieves the setting value for the given key.

Signature
DOMString get(DOMString key);
Parameters
  • key: the key of the setting to retrieve
Return value
the value of the given key, or undefined if key not found.
Exceptions
  • SecurityError: PERMISSION_DENIED_ERROR when access is denied by the security policy.
API features
http://bondi.omtp.org/api/appconfig.get
Code example
        // Get some application settings.
        var smtpServer = bondi.appconfig.get('smtp.server');
        var smtpPort   = bondi.appconfig.get('smtp.port');
        configureSMTP(smtpServer,smtpPort);
set

Set the value for the given key.

Signature
void set(DOMString key, DOMString value);
Parameters
  • key: key of the setting to set
  • value: the value to set
Exceptions
  • SecurityError: PERMISSION_DENIED_ERROR when access is denied by the security policy.
API features
http://bondi.omtp.org/api/appconfig.set
Code example
        // Change the application setting.
        bondi.appconfig.set('smtp.port','25');