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