OLD | NEW |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | 1 // Copyright 2016 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 #ifndef SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ | 5 #ifndef SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ |
6 #define SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ | 6 #define SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 namespace shell { | 10 namespace shell { |
11 | 11 |
12 extern const char kNameType_Mojo[]; | 12 extern const char kNameType_Service[]; |
13 extern const char kNameType_Exe[]; | 13 extern const char kNameType_Exe[]; |
14 | 14 |
15 // Mojo services are identified by structured "names", of the form: | 15 // Services are identified by structured "names", of the form: |
16 // | 16 // |
17 // type:path. | 17 // type:path. |
18 // | 18 // |
19 // The type field tells the shell how to load the service. Two types are | 19 // The type field tells the shell how to load the service. Two types are |
20 // recognized: | 20 // recognized: |
21 // | 21 // |
22 // mojo | 22 // service |
23 // Represents a service packaged as a .library, launched from the NativeRunner | 23 // A synthetic service name, which may be packaged as part of another service |
24 // launch path. .library files are assumed to live alongside the executable | 24 // (via ServiceFactory) or as a standalone .library. .library files live |
25 // hosting the service manager at a path matching <path>/<path>.library. | 25 // within a directory hierarchy alongside the service manager executable. |
26 // .library files have a ServiceMain() entrypoint that receives a handle to a | |
27 // ServiceRequest that must be bound to enable further communication with the | |
28 // Service Manager. | |
29 // | 26 // |
30 // exe | 27 // exe |
31 // Represents a native executable on the host platform, expected to live | 28 // Represents a native executable on the host platform, expected to live |
32 // alongside the shell executable. Executables launched via this mechanism are | 29 // alongside the service manager executable. Executables launched via this |
33 // passed a handle to the shell on the command line and are expected to bind | 30 // mechanism are passed a handle to the service manager on the command line |
34 // a ServiceRequest enabling further communication with the Service Manager. | 31 // and are expected to bind a ServiceRequest enabling further communication |
35 // The path component contains the executable name, minus any platform | 32 // with the Service Manager. The path component contains the executable name, |
36 // specific extension. | 33 // minus any platform specific extension. |
37 // | 34 // |
38 // Other types may be supplied but are not recognized by any of the | 35 // Other types may be supplied but are not recognized by any of the |
39 // NativeRunners, and as such custom loaders must be specified for such names. | 36 // NativeRunners, and as such custom loaders must be specified for such names. |
40 // | 37 // |
41 // Any name type may serve as an alias for any other name type. Aliasing is | 38 // Any name type may serve as an alias for any other name type. Aliasing is |
42 // resolved implicitly by the Shell. | 39 // resolved implicitly by the Shell. |
43 | 40 |
44 // Returns true if the name is a valid form, i.e. type:path. path cannot start | 41 // Returns true if the name is a valid form, i.e. type:path. path cannot start |
45 // with a "//" sequence. These are _not_ urls. | 42 // with a "//" sequence. These are _not_ urls. |
46 bool IsValidName(const std::string& name); | 43 bool IsValidName(const std::string& name); |
47 | 44 |
48 // Get the type component of the specified name. | 45 // Get the type component of the specified name. |
49 std::string GetNameType(const std::string& name); | 46 std::string GetNameType(const std::string& name); |
50 | 47 |
51 // Get the path component of the specified name. | 48 // Get the path component of the specified name. |
52 std::string GetNamePath(const std::string& name); | 49 std::string GetNamePath(const std::string& name); |
53 | 50 |
54 } // namespace shell | 51 } // namespace shell |
55 | 52 |
56 #endif // SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ | 53 #endif // SERVICES_SHELL_PUBLIC_CPP_NAMES_H_ |
OLD | NEW |