OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 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/service_provider.mojom"; | 8 import "mojo/public/interfaces/application/service_provider.mojom"; |
9 | 9 |
10 interface ApplicationConnector { | 10 interface ApplicationConnector { |
11 // Establishes a connection with another application (located at | 11 // Establishes a connection with another application (located at |
12 // |application_url|) through which the calling application and the other | 12 // |application_url|) through which the calling application and the other |
13 // application may request services from one another. | 13 // application may request services from one another. |
14 // | 14 // |
15 // If the calling application would like to request services from the other | |
16 // application, it should pass a valid interface request in the |services| | |
17 // parameter (i.e. one containing a valid message pipe endpoint). If the other | |
18 // application does not wish to offer services, it may either not bind an | |
19 // implementation to the interface request, or else bind an implementation | |
20 // that will reject some or all service requests. | |
21 // | |
22 // If the calling application would like to offer services to the other | |
23 // application, it should pass a bound interface through the | |
24 // |exposed_services| parameter. The other application may then request | |
25 // services through that interface. | |
26 // | |
27 // At least one of |services| or |exposed_services| should be valid/bound in | |
28 // the call. | |
29 // | |
30 // If the |application_url| does not contain a domain, but is of the form | 15 // If the |application_url| does not contain a domain, but is of the form |
31 // "mojo:{service}", it is up to the Mojo shell to select an appropriate | 16 // "mojo:{service}", it is up to the Mojo shell to select an appropriate |
32 // application for the service. Currently, the shell does this based on the | 17 // application for the service. Currently, the shell does this based on the |
33 // value of its --origin flag. | 18 // value of its --origin flag. |
34 // | 19 ConnectToApplication(string application_url, ServiceProvider& services); |
35 // WARNING: |exposed_services| is deprecated and non-functional, and will be | |
36 // removed. Note that this also means that |services| will become required. | |
37 // https://github.com/domokit/mojo/issues/762 | |
38 ConnectToApplication(string application_url, | |
39 ServiceProvider&? services, | |
40 ServiceProvider? exposed_services); | |
41 | 20 |
42 // Creates a duplicate of this |ApplicationConnector|. | 21 // Creates a duplicate of this |ApplicationConnector|. |
43 Duplicate(ApplicationConnector& application_connector_request); | 22 Duplicate(ApplicationConnector& application_connector_request); |
44 }; | 23 }; |
OLD | NEW |