| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 module mojo; | 5 module mojo; |
| 6 | 6 |
| 7 import "mojo/shell/public/interfaces/service_provider.mojom"; | 7 import "mojo/shell/public/interfaces/service_provider.mojom"; |
| 8 import "mojo/shell/public/interfaces/shell.mojom"; | 8 import "mojo/shell/public/interfaces/shell.mojom"; |
| 9 | 9 |
| 10 // This is the primary interface implemented by every Mojo application. It | 10 // This is the primary interface implemented by every Mojo application. It |
| 11 // allows the application to receive its startup arguments from the shell, and | 11 // allows the application to receive its startup arguments from the shell, and |
| 12 // to be notified of events that occur during its execution. | 12 // to be notified of events that occur during its execution. |
| 13 // | 13 // |
| 14 // TODO(aa): It would be good to reorder the parameters once we have interface | 14 // TODO(aa): It would be good to reorder the parameters once we have interface |
| 15 // versioning. | 15 // versioning. |
| 16 interface Application { | 16 interface Application { |
| 17 // Initializes the application with the specified arguments. This method is | 17 // Initializes the application with the specified arguments. This method is |
| 18 // guaranteed to be called before any other method is called, and will only be | 18 // guaranteed to be called before any other method is called, and will only be |
| 19 // called once. | 19 // called once. |
| 20 // | 20 // |
| 21 // The |url| parameter is the identity of the application as far as the shell | 21 // The |url| parameter is the identity of the application as far as the shell |
| 22 // is concerned. This will be the URL the application was found at, after all | 22 // is concerned. This will be the URL the application was found at, after all |
| 23 // mappings, resolution, and redirects. And it will not include the | 23 // mappings, resolution, and redirects. And it will not include the |
| 24 // querystring, since the querystring is not part of an application's | 24 // querystring, since the querystring is not part of an application's |
| 25 // identity. | 25 // identity. |
| 26 Initialize(Shell shell, string url); | 26 // |
| 27 // The |id| parameter is the identifier of the instance in the |
| 28 // ApplicationManager. It can be passed to other shell interfaces that request |
| 29 // an instance identifier. |
| 30 Initialize(Shell shell, string url, uint32 id); |
| 27 | 31 |
| 28 // Called when another application (identified by |requestor_url|) attempts to | 32 // Called when another application (identified by |requestor_url|) attempts to |
| 29 // open a connection to this application. | 33 // open a connection to this application. |
| 30 // | 34 // |
| 31 // If the other application wants to request services from this application, | 35 // If the other application wants to request services from this application, |
| 32 // it will have passed a valid interface request through the |services| | 36 // it will have passed a valid interface request through the |services| |
| 33 // parameter (i.e. one containing a valid message pipe endpoint). This | 37 // parameter (i.e. one containing a valid message pipe endpoint). This |
| 34 // application may then bind an implementation of |ServiceProvider| to that | 38 // application may then bind an implementation of |ServiceProvider| to that |
| 35 // request in order to make services available to the other application. | 39 // request in order to make services available to the other application. |
| 36 // | 40 // |
| (...skipping 14 matching lines...) Expand all Loading... |
| 51 // application. When this parameter is empty, this application should expose | 55 // application. When this parameter is empty, this application should expose |
| 52 // no services to the connecting application. When this parameter contains | 56 // no services to the connecting application. When this parameter contains |
| 53 // only the single string value "*" the application may expose all of its | 57 // only the single string value "*" the application may expose all of its |
| 54 // services to the connecting application. | 58 // services to the connecting application. |
| 55 // | 59 // |
| 56 // |resolved_url| is the URL that was requested to create this connection, | 60 // |resolved_url| is the URL that was requested to create this connection, |
| 57 // after all mappings, resolutions, and redirects. This will include any | 61 // after all mappings, resolutions, and redirects. This will include any |
| 58 // querystring that was part of the request. | 62 // querystring that was part of the request. |
| 59 // | 63 // |
| 60 AcceptConnection(string requestor_url, | 64 AcceptConnection(string requestor_url, |
| 65 uint32 requestor_id, |
| 61 ServiceProvider&? services, | 66 ServiceProvider&? services, |
| 62 ServiceProvider? exposed_services, | 67 ServiceProvider? exposed_services, |
| 63 array<string> allowed_interfaces, | 68 array<string> allowed_interfaces, |
| 64 string resolved_url); | 69 string resolved_url); |
| 65 | 70 |
| 66 // Called by the shell in response to calling Shell's QuitApplication. The | 71 // Called by the shell in response to calling Shell's QuitApplication. The |
| 67 // application should run the callback with true if shutdown can proceed. | 72 // application should run the callback with true if shutdown can proceed. |
| 68 // See Shell::QuitApplication for details about shutdown workflow. | 73 // See Shell::QuitApplication for details about shutdown workflow. |
| 69 OnQuitRequested() => (bool can_quit); | 74 OnQuitRequested() => (bool can_quit); |
| 70 }; | 75 }; |
| OLD | NEW |