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/public/interfaces/application/application.mojom"; | |
8 import "mojo/public/interfaces/application/service_provider.mojom"; | 7 import "mojo/public/interfaces/application/service_provider.mojom"; |
9 | 8 |
10 // An interface through which a Mojo application may communicate with the Mojo | 9 // An interface through which a Mojo application may communicate with the Mojo |
11 // system and request connections to other applications. | 10 // system and request connections to other applications. |
12 [Client=Application] | |
13 interface Shell { | 11 interface Shell { |
14 // Establishes a connection with another application (identified by | 12 // Establishes a connection with another application (identified by |
15 // |application_url|) through which the calling application and the other | 13 // |application_url|) through which the calling application and the other |
16 // application may request services from one another. | 14 // application may request services from one another. |
17 // | 15 // |
18 // If the calling application would like to request services from the other | 16 // If the calling application would like to request services from the other |
19 // application, it should pass a valid interface request in the |services| | 17 // application, it should pass a valid interface request in the |services| |
20 // parameter (i.e. one containing a valid message pipe endpoint). If the other | 18 // parameter (i.e. one containing a valid message pipe endpoint). If the other |
21 // application does not wish to offer services, it may either not bind an | 19 // application does not wish to offer services, it may either not bind an |
22 // implementation to the interface request, or else bind an implementation | 20 // implementation to the interface request, or else bind an implementation |
23 // that will reject some or all service requests. | 21 // that will reject some or all service requests. |
24 // | 22 // |
25 // If the calling application would like to offer services to the other | 23 // If the calling application would like to offer services to the other |
26 // application, it should pass a bound interface through the | 24 // application, it should pass a bound interface through the |
27 // |exposed_services| parameter. The other application may then request | 25 // |exposed_services| parameter. The other application may then request |
28 // services through that interface. | 26 // services through that interface. |
29 // | 27 // |
30 // At least one of |services| or |exposed_services| should be valid/bound in | 28 // At least one of |services| or |exposed_services| should be valid/bound in |
31 // the call. | 29 // the call. |
32 // | 30 // |
33 // If the |application_url| does not contain a domain, but is of the form | 31 // If the |application_url| does not contain a domain, but is of the form |
34 // "mojo:{service}", it is up to the Mojo shell to select an appropriate | 32 // "mojo:{service}", it is up to the Mojo shell to select an appropriate |
35 // application for the service. Currently, the shell does this based on the | 33 // application for the service. Currently, the shell does this based on the |
36 // value of its --origin flag. | 34 // value of its --origin flag. |
37 ConnectToApplication(string application_url, | 35 ConnectToApplication(string application_url, |
38 ServiceProvider&? services, | 36 ServiceProvider&? services, |
39 ServiceProvider? exposed_services); | 37 ServiceProvider? exposed_services); |
40 }; | 38 }; |
OLD | NEW |