src/mojo/public/cpp/application/application_impl.h

   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 #ifndef MOJO_PUBLIC_APPLICATION_APPLICATION_IMPL_H_
   6 #define MOJO_PUBLIC_APPLICATION_APPLICATION_IMPL_H_
   7 #include <vector>
   8
   9 #include "mojo/public/cpp/application/application_connection.h"
  10 #include "mojo/public/cpp/application/lib/service_connector.h"
  11 #include "mojo/public/cpp/application/lib/service_registry.h"
  12 #include "mojo/public/cpp/system/core.h"
  13 #include "mojo/public/interfaces/application/application.mojom.h"
  14 #include "mojo/public/interfaces/application/shell.mojom.h"
  15
  16 namespace mojo {
  17
  18 class ApplicationDelegate;
  19
  20 // Utility class for communicating with the Shell, and providing Services
  21 // to clients.
  22 //
  23 // To use define a class that implements your specific server api, e.g. FooImpl
  24 // to implement a service named Foo.
  25 // That class must subclass an InterfaceImpl specialization.
  26 //
  27 // If there is context that is to be shared amongst all instances, define a
  28 // constructor with that class as its only argument, otherwise define an empty
  29 // constructor.
  30 //
  31 // class FooImpl : public InterfaceImpl<Foo> {
  32 //  public:
  33 //   FooImpl(ApplicationContext* app_context) {}
  34 // };
  35 //
  36 // or
  37 //
  38 // class BarImpl : public InterfaceImpl<Bar> {
  39 //  public:
  40 //   // contexts will remain valid for the lifetime of BarImpl.
  41 //   BarImpl(ApplicationContext* app_context, BarContext* service_context)
  42 //          : app_context_(app_context), servicecontext_(context) {}
  43 //
  44 // Create an ApplicationImpl instance that collects any service implementations.
  45 //
  46 // ApplicationImpl app(service_provider_handle);
  47 // app.AddService<FooImpl>();
  48 //
  49 // BarContext context;
  50 // app.AddService<BarImpl>(&context);
  51 //
  52 //
  53 class ApplicationImpl : public InterfaceImpl<Application> {
  54  public:
  55   ApplicationImpl(ApplicationDelegate* delegate,
  56                   ScopedMessagePipeHandle shell_handle);
  57   ApplicationImpl(ApplicationDelegate* delegate,
  58                   MojoHandle shell_handle);
  59   virtual ~ApplicationImpl();
  60
  61   Shell* shell() const { return shell_.get(); }
  62
  63   // Returns any initial configuration arguments, passed by the Shell.
  64   const Array<String>& args() { return args_; }
  65
  66   // Establishes a new connection to an application. Caller does not own.
  67   ApplicationConnection* ConnectToApplication(const String& application_url);
  68
  69   // Connect to application identified by |application_url| and connect to the
  70   // service implementation of the interface identified by |Interface|.
  71   template <typename Interface>
  72   void ConnectToService(const std::string& application_url,
  73                         InterfacePtr<Interface>* ptr) {
  74     ConnectToApplication(application_url)->ConnectToService(ptr);
  75   }
  76
  77  private:
  78   class ShellPtrWatcher;
  79
  80   void BindShell(ScopedMessagePipeHandle shell_handle);
  81   void ClearConnections();
  82   void OnShellError() {
  83     ClearConnections();
  84     Terminate();
  85   };
  86
  87   // Quits the main run loop for this application.
  88   static void Terminate();
  89
  90   // Application implementation.
  91   virtual void Initialize(Array<String> args) MOJO_OVERRIDE;
  92   virtual void AcceptConnection(const String& requestor_url,
  93                                 ServiceProviderPtr provider) MOJO_OVERRIDE;
  94
  95   typedef std::vector<internal::ServiceRegistry*> ServiceRegistryList;
  96
  97   bool initialized_;
  98   ServiceRegistryList incoming_service_registries_;
  99   ServiceRegistryList outgoing_service_registries_;
 100   ApplicationDelegate* delegate_;
 101   ShellPtr shell_;
 102   ShellPtrWatcher* shell_watch_;
 103   Array<String> args_;
 104
 105   MOJO_DISALLOW_COPY_AND_ASSIGN(ApplicationImpl);
 106 };
 107
 108 }  // namespace mojo
 109
 110 #endif  // MOJO_PUBLIC_APPLICATION_APPLICATION_IMPL_H_