| 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 |