OLD | NEW |
| (Empty) |
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 | |
3 // found in the LICENSE file. | |
4 | |
5 module shell.mojom; | |
6 | |
7 import "services/shell/public/interfaces/capabilities.mojom"; | |
8 import "services/shell/public/interfaces/connector.mojom"; | |
9 import "services/shell/public/interfaces/interface_provider.mojom"; | |
10 | |
11 // Implemented by something "known to" the Mojo Shell (e.g. an application or | |
12 // service), for which an instance is tracked. It allows the implementor to | |
13 // receive lifecycle events and service inbound connection attempts. | |
14 interface Service { | |
15 // Called by the shell once an instance for this application has been created. | |
16 // This method will be called exactly once before any other method is called. | |
17 // | |
18 // Parameters: | |
19 // | |
20 // identity | |
21 // The identity of this instance in the shell. Includes: | |
22 // * The resolved name used in the connection request that resulted in this | |
23 // instance being initialized. | |
24 // * The user associated with this instance in the shell. This will never | |
25 // be kInheritUserID. | |
26 // * The instance group this instance belongs to. | |
27 // | |
28 // Response parameters: | |
29 // | |
30 // connector_request | |
31 // An optional Connector request for the shell to bind, allowing the | |
32 // initialized client to connect to others. | |
33 // | |
34 OnStart(Identity identity) => (Connector&? connector_request); | |
35 | |
36 // Called when another application attempts to open a connection to this | |
37 // application. An application implements this method to complete the exchange | |
38 // of interface implementations with the remote application. See also | |
39 // documentation in shell.mojom for Connect(). The application originating | |
40 // the request is referred to as the "source" and the one receiving the | |
41 // "target". | |
42 // | |
43 // Parameters: | |
44 // | |
45 // source | |
46 // The identity of the instance originating the connection. | |
47 // | |
48 // interfaces | |
49 // A request for an InterfaceProvider by which the source application may | |
50 // seek to bind interface implementations exported by the target. | |
51 // | |
52 // allowed_capabilities | |
53 // A whitelist of interface names and capability classes that should be | |
54 // made available to the source, according to the security policy described | |
55 // by the source and target's manifests. Attempts to bind interfaces not in | |
56 // this whitelist must not be fulfilled. | |
57 // | |
58 OnConnect(Identity source, | |
59 InterfaceProvider&? interfaces, | |
60 Interfaces required_interfaces, | |
61 Classes required_classes); | |
62 }; | |
OLD | NEW |