Merge lp:~jonas-drange/ubuntu-system-settings/no-empty-contexts-1433278-rtm into lp:ubuntu-system-settings/rtm-14.09

[Jonas G. Drange]

[cellular/apn] no creation of custom contexts on editor exit

What changed:
I moved creation of a new, custom internet context to when the user presses "Activate".

Why did I add apn.js:
I want to move the tons of JavaScript code out of the QML and into a nice, documented collection of helper code.

How to test this:
1. $ /usr/share/ofono/scripts/remove-contexts # removes your contexts. Backup your gprs* files if you want to keep them.

Note: If you have not tweaked APNs, ofono should automatically restore your APNs after you remove them completely (and reboot/restart ofono).

2. Open up the APN editor and press "Custom Internet APN"
3. Immediately press Cancel or even "<"
4. Confirm no new contexts were created.

* /var/lib/ofono/<IMSI>/gprs

[Ken VanDine (ken-vandine)]

Clean backport, thanks

review: Approve

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:1006
http://jenkins.qa.ubuntu.com/job/ubuntu-system-settings-rtm-14.09-ci/73/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-deb-autopilot-14.09-touch/52
    SUCCESS: http://jenkins.qa.ubuntu.com/job/ubuntu-system-settings-rtm-14.09-14.09-armhf-ci/74
        deb: http://jenkins.qa.ubuntu.com/job/ubuntu-system-settings-rtm-14.09-14.09-armhf-ci/74/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-deb-autopilot-runner-14.09-mako/53
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-14.09-armhf/52
        deb: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-builder-14.09-armhf/52/artifact/work/output/*zip*/output.zip
    SUCCESS: http://s-jenkins.ubuntu-ci:8080/job/touch-flash-device/19252

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-system-settings-rtm-14.09-ci/73/rebuild

review: Approve (continuous-integration)

[lp:~jonas-drange/ubuntu-system-settings/no-empty-contexts-1433278-rtm]

1007. By Jonas G. Drange on 2015-03-30

merge prerequisite

=== modified file 'plugins/cellular/CMakeLists.txt'
--- plugins/cellular/CMakeLists.txt	2015-02-05 19:11:36 +0000
+++ plugins/cellular/CMakeLists.txt	2015-03-30 13:23:54 +0000
@@ -4,6 +4,7 @@
 install(FILES settings-cellular.svg DESTINATION ${PLUGIN_MANIFEST_DIR}/icons)
 
 set(QML_SOURCES
+    apn.js
     carriers.js
     CustomApnEditor.qml
     PageChooseApn.qml

=== modified file 'plugins/cellular/CustomApnEditor.qml'
--- plugins/cellular/CustomApnEditor.qml	2015-02-16 13:45:07 +0000
+++ plugins/cellular/CustomApnEditor.qml	2015-03-30 13:23:54 +0000
@@ -23,6 +23,7 @@
 import SystemSettings 1.0
 import Ubuntu.Components 1.1
 import Ubuntu.Components.ListItems 1.0 as ListItem
+import "apn.js" as APN
 
 ItemPage {
     objectName: "customapnPage"
@@ -37,6 +38,9 @@
     /// work around LP(#1361919)
     property var activateCb;
 
+    // Sim qml object
+    property var sim
+
     QtObject {
         id: d
         property var typeText : type === "internet" ? i18n.tr("Internet") : i18n.tr("MMS")
@@ -83,6 +87,12 @@
             ctx = contexts["internet"]
         }
 
+        // We do not have any context yet, we will create one, but not now.
+        // We create it once the user presses 'Activate'.
+        if (!ctx) {
+            return;
+        }
+
         apnName.text = ctx.accessPointName;
         userName.text = ctx.username;
         pword.text = ctx.password;
@@ -277,6 +287,8 @@
 
                     onClicked: {
                         var ctx;
+                        var values;
+
                         if (d.isMms)
                             ctx = contexts["mms"];
                         else
@@ -300,23 +312,71 @@
                             pageStack.pop();
                             return;
                         }
-                        ctx.accessPointName = apnName.text;
-                        ctx.username = userName.text;
-                        ctx.password = pword.text;
+
+                        values = {
+                            'accessPointName': apnName.text,
+                            'username': userName.text,
+                            'password': pword.text
+                        };
+
                         if (d.isMms) {
-                            ctx.messageCenter = mmsc.text;
+                            values['messageCenter'] = mmsc.text;
                             var proxyValue = "";
                             if (proxy.text !== "") {
                                 proxyValue = proxy.text;
                                 if (port.text !== "")
                                     proxyValue = proxyValue + ":" + port.text;
                             }
-                            ctx.messageProxy = proxyValue
-                        }
-                        /// @todo map protocol values
-
-                        activateCb(ctx.type, ctx.contextPath);
-                        pageStack.pop();
+                            values['messageProxy'] = proxyValue;
+                        }
+
+                        // If we are editing an existing context, update
+                        // its values, activate and exit.
+                        if (ctx) {
+                            APN.updateContext(ctx, values);
+                            activateCb(ctx.type, ctx.contextPath);
+                            pageStack.pop();
+                        } else {
+                            // If we do not have a context, create one and defer
+                            // editing it to when it has been created—and we
+                            // will also wait until Ofono has given it a name.
+                            // This is all very async, so we will use connect()
+                            // and dynamic QML.
+
+                            function addedCustomContext (path) {
+                                // This is a handler for when we add a context
+                                // in the custom apn editor.
+                                // We create a temporary QML object for the
+                                // context like this, until we get the APN
+                                // editor refactored.
+                                // TODO(jgdx): create some kind of libqofono
+                                // objects framework in apn.js
+                                var newCtx = Qt.createQmlObject(
+                                    'import MeeGo.QOfono 0.2;'+
+                                    'OfonoContextConnection {'+
+                                    'contextPath: "'+path+'" }',
+                                    root, "apn.js");
+
+                                // Ofono sets a default name (Internet or MMS).
+                                // We are going to change it to our default name.
+                                newCtx.nameChanged.connect(function (name) {
+                                    if (name === "Internet") {
+                                        newCtx.name = APN.CUSTOM_INTERNET_CONTEXT_NAME();
+                                        APN.updateContext(newCtx, values);
+                                    } else if (name === "MMS") {
+                                        newCtx.name = APN.CUSTOM_MMS_CONTEXT_NAME();
+                                        APN.updateContext(newCtx, values);
+                                    } else {
+                                        newCtx.destroy(100);
+                                        activateCb(newCtx.type, newCtx.contextPath);
+                                        pageStack.pop();
+                                    }
+                                });
+                            }
+
+                            sim.connMan.addContext(root.type);
+                            sim.connMan.contextAdded.connect(addedCustomContext);
+                        }
                     }
                 }
             } // item for buttons

=== modified file 'plugins/cellular/PageChooseApn.qml'
--- plugins/cellular/PageChooseApn.qml	2015-03-30 13:23:54 +0000
+++ plugins/cellular/PageChooseApn.qml	2015-03-30 13:23:54 +0000
@@ -150,10 +150,7 @@
                 });
             }
 
-            if (customInternet.length === 0) {
-                sim.connMan.addContext("internet");
-                sim.connMan.contextAdded.connect(addedCustomContext);
-            } else {
+            if (customInternet.length !== 0) {
                 d.__haveCustomContexts = true;
             }
 
@@ -239,7 +236,8 @@
                                type: type,
                                contexts: {"internet": mCustomContextInternet,
                                           "mms":      mCustomContextMms},
-                               activateCb: activateHelper
+                               activateCb: activateHelper,
+                               sim: sim
                            });
         }
 
@@ -424,29 +422,7 @@
                 objectName: "customApnEdit"
                 text: i18n.tr("Custom Internet APN…")
                 width: parent.width - units.gu(4)
-                onClicked: {
-
-                    function contextAdded (path) {
-                        d.updateContexts();
-
-                        if (d.mContexts[path]) {
-                            d.mCustomContextInternet = d.mContexts[path];
-                        }
-                        d.openApnEditor("internet")
-                        d.contextsChanged.disconnect(contextAdded);
-                    }
-
-                    if (d.__haveCustomContexts) {
-                        d.openApnEditor("internet")
-                    } else {
-                        d.checkAndCreateCustomContexts();
-                        d.__haveCustomContexts = true;
-
-                        // We defer opening the editor until we have
-                        // added the custom context to mContexts
-                        sim.connMan.contextAdded.connect(contextAdded);
-                    }
-                }
+                onClicked: d.openApnEditor("internet")
             }
 
             ListItem.ItemSelector {

=== added file 'plugins/cellular/apn.js'
--- plugins/cellular/apn.js	1970-01-01 00:00:00 +0000
+++ plugins/cellular/apn.js	2015-03-30 13:23:54 +0000
@@ -0,0 +1,61 @@
+var _CUSTOM_INTERNET_CONTEXT_NAME = '___ubuntu_custom_apn_internet';
+var _CUSTOM_MMS_CONTEXT_NAME = '___ubuntu_custom_apn_mms';
+
+/*
+Updates a context with new values.
+
+@param {QOfonoConnectionContext} context
+@param {Object} values dict with new values
+*/
+function updateContext (context, values) {
+    var messageProxy;
+    console.warn('updateContext', values.accessPointName, values.messageCenter,
+        values.messageProxy, values.port, values.useraccessPointName,
+        values.password, values.type);
+    if (typeof values.accessPointName !== 'undefined') {
+        context.accessPointName = values.accessPointName;
+    }
+    if (typeof values.messageCenter !== 'undefined') {
+        context.messageCenter = values.messageCenter;
+    }
+    if (typeof values.messageProxy !== 'undefined') {
+        messageProxy = values.messageProxy;
+        if (messageProxy !== '') {
+             messageProxy = messageProxy + ':' + values.port;
+        }
+        context.messageProxy = messageProxy;
+    }
+    if (typeof values.username !== 'undefined') {
+        context.username = values.username;
+    }
+    if (typeof values.password !== 'undefined') {
+        context.password = values.password;
+    }
+    if (typeof values.type !== 'undefined') {
+        context.type = values.type;
+    }
+
+    if (context.type === 'internet') {
+        context.name = CUSTOM_INTERNET_CONTEXT_NAME();
+    } else if (context.type === 'mms') {
+        context.name = CUSTOM_MMS_CONTEXT_NAME();
+    }
+}
+
+/*
+Exposes the custom internet context name to the world.
+
+@return {String} custom internet context name
+*/
+function CUSTOM_INTERNET_CONTEXT_NAME () {
+    return _CUSTOM_INTERNET_CONTEXT_NAME;
+}
+
+/*
+Exposes the custom mms context name to the world.
+
+@return {String} custom mms context name
+*/
+function CUSTOM_MMS_CONTEXT_NAME () {
+    return _CUSTOM_MMS_CONTEXT_NAME;
+}