| Index: mojo/public/cpp/application/application_impl_base.h
|
| diff --git a/mojo/public/cpp/application/application_impl_base.h b/mojo/public/cpp/application/application_impl_base.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..04109d7eefe71e09da09ed52914e449944e859fd
|
| --- /dev/null
|
| +++ b/mojo/public/cpp/application/application_impl_base.h
|
| @@ -0,0 +1,98 @@
|
| +// Copyright 2016 The Chromium Authors. All rights reserved.
|
| +// Use of this source code is governed by a BSD-style license that can be
|
| +// found in the LICENSE file.
|
| +
|
| +#ifndef MOJO_PUBLIC_CPP_APPLICATION_APPLICATION_IMPL_BASE_H_
|
| +#define MOJO_PUBLIC_CPP_APPLICATION_APPLICATION_IMPL_BASE_H_
|
| +
|
| +#include <memory>
|
| +#include <string>
|
| +#include <vector>
|
| +
|
| +#include "mojo/public/cpp/bindings/binding.h"
|
| +#include "mojo/public/cpp/bindings/interface_request.h"
|
| +#include "mojo/public/cpp/system/macros.h"
|
| +#include "mojo/public/interfaces/application/application.mojom.h"
|
| +#include "mojo/public/interfaces/application/shell.mojom.h"
|
| +
|
| +namespace mojo {
|
| +
|
| +class ServiceProviderImpl;
|
| +
|
| +// Base helper class for implementing the |Application| interface, which the
|
| +// shell uses for basic communication with an application (e.g., to connect
|
| +// clients to services provided by an application).
|
| +//
|
| +// To use this class, subclass it and implement/override the required methods
|
| +// (see below).
|
| +//
|
| +// TODO(vtl): ApplicationRunners should take this instead of an
|
| +// ApplicationDelegate. Write more here when that's true (it's pretty hard to
|
| +// use this class in the current setup).
|
| +class ApplicationImplBase : public Application {
|
| + public:
|
| + explicit ApplicationImplBase(
|
| + InterfaceRequest<Application> application_request);
|
| + ~ApplicationImplBase() override;
|
| +
|
| + // Quits the main run loop for this application.
|
| + // TODO(vtl): This is implemented in application_runner.cc (for example). Its
|
| + // presence here is pretty dubious.
|
| + static void Terminate();
|
| +
|
| + // This will be valid after |Initialize()| has been received and remain valid
|
| + // until this object is destroyed.
|
| + Shell* shell() const { return shell_.get(); }
|
| +
|
| + // Returns any initial configuration arguments, passed by the shell.
|
| + const std::vector<std::string>& args() const { return args_; }
|
| + bool HasArg(const std::string& arg) const;
|
| +
|
| + const std::string& url() const { return url_; }
|
| +
|
| + // Methods to be implemented/overridden by subclasses:
|
| +
|
| + // Called after |Initialize()| has been received (|shell()|, |args()|, and
|
| + // |url()| will be valid when this is called. The default implementation does
|
| + // nothing.
|
| + virtual void OnInitialize() {}
|
| +
|
| + // Called when another application connects to this application (i.e., we
|
| + // receive |AcceptConnection()|). This should either configure what services
|
| + // are "provided" (made available via a |ServiceProvider|) to that application
|
| + // and return true, or this may return false to reject the connection
|
| + // entirely.
|
| + virtual bool OnAcceptConnection(
|
| + ServiceProviderImpl* service_provider_impl) = 0;
|
| +
|
| + // Called before quitting the main message (run) loop, i.e., before
|
| + // |Terminate()|. The default implementation does nothing.
|
| + virtual void OnQuit() {}
|
| +
|
| + private:
|
| + // |Application| implementation. In general, you probably shouldn't call these
|
| + // directly (but I can't really stop you).
|
| + void Initialize(InterfaceHandle<Shell> shell,
|
| + Array<String> args,
|
| + const mojo::String& url) final;
|
| + void AcceptConnection(const String& requestor_url,
|
| + InterfaceRequest<ServiceProvider> services,
|
| + InterfaceHandle<ServiceProvider> exposed_services,
|
| + const String& url) final;
|
| + void RequestQuit() final;
|
| +
|
| + Binding<Application> application_binding_;
|
| +
|
| + // Set by |Initialize()|.
|
| + ShellPtr shell_;
|
| + std::vector<std::string> args_;
|
| + std::string url_;
|
| +
|
| + std::vector<std::unique_ptr<ServiceProviderImpl>> service_provider_impls_;
|
| +
|
| + MOJO_DISALLOW_COPY_AND_ASSIGN(ApplicationImplBase);
|
| +};
|
| +
|
| +} // namespace mojo
|
| +
|
| +#endif // MOJO_PUBLIC_CPP_APPLICATION_APPLICATION_IMPL_BASE_H_
|
|
|