// Copyright (c) 2013 GitHub, Inc. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #ifndef ATOM_BROWSER_API_ATOM_API_PROTOCOL_H_ #define ATOM_BROWSER_API_ATOM_API_PROTOCOL_H_ #include #include #include #include "atom/browser/net/atom_url_request_job_factory.h" #include "base/callback.h" #include "content/public/browser/browser_thread.h" #include "native_mate/handle.h" #include "native_mate/wrappable.h" namespace net { class URLRequest; class URLRequestContextGetter; } namespace atom { class AtomBrowserContext; class AtomURLRequestJobFactory; namespace api { class Protocol : public mate::Wrappable { public: using Handler = base::Callback)>; using CompletionCallback = base::Callback)>; static mate::Handle Create( v8::Isolate* isolate, AtomBrowserContext* browser_context); protected: explicit Protocol(AtomBrowserContext* browser_context); // mate::Wrappable implementations: virtual mate::ObjectTemplateBuilder GetObjectTemplateBuilder( v8::Isolate* isolate); private: // Possible errors. enum ProtocolError { PROTOCOL_OK, // no error PROTOCOL_FAIL, // operation failed, should never occur PROTOCOL_REGISTERED, PROTOCOL_NOT_REGISTERED, PROTOCOL_INTERCEPTED, PROTOCOL_NOT_INTERCEPTED, }; // The protocol handler that will create a protocol handler for certain // request job. template class CustomProtocolHandler : public net::URLRequestJobFactory::ProtocolHandler { public: CustomProtocolHandler(v8::Isolate* isolate, const Handler& handler) : isolate_(isolate), handler_(handler) {} ~CustomProtocolHandler() override {} net::URLRequestJob* MaybeCreateJob( net::URLRequest* request, net::NetworkDelegate* network_delegate) const override { return new RequestJob(request, network_delegate, isolate_, handler_); } private: v8::Isolate* isolate_; Protocol::Handler handler_; DISALLOW_COPY_AND_ASSIGN(CustomProtocolHandler); }; // Register schemes to standard scheme list. void RegisterStandardSchemes(const std::vector& schemes); // Register the protocol with certain request job. template void RegisterProtocol(v8::Isolate* isolate, const std::string& scheme, const Handler& handler, const CompletionCallback& callback) { content::BrowserThread::PostTaskAndReplyWithResult( content::BrowserThread::IO, FROM_HERE, base::Bind(&Protocol::RegisterProtocolInIO, base::Unretained(this), scheme, handler), base::Bind(&Protocol::OnIOCompleted, base::Unretained(this), callback)); } template ProtocolError RegisterProtocolInIO(const std::string& scheme, const Handler& handler) { if (job_factory_->IsHandledProtocol(scheme)) return PROTOCOL_REGISTERED; scoped_ptr> protocol_handler( new CustomProtocolHandler(isolate(), handler)); if (job_factory_->SetProtocolHandler(scheme, protocol_handler.Pass())) return PROTOCOL_OK; else return PROTOCOL_FAIL; } // Convert error code to JS exception and call the callback. void OnIOCompleted(const CompletionCallback& callback, ProtocolError error); // Convert error code to string. std::string ErrorCodeToString(ProtocolError error); scoped_refptr request_context_getter_; AtomURLRequestJobFactory* job_factory_; // weak ref. DISALLOW_COPY_AND_ASSIGN(Protocol); }; } // namespace api } // namespace atom #endif // ATOM_BROWSER_API_ATOM_API_PROTOCOL_H_