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