// 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 "base/containers/scoped_ptr_hash_map.h" #include "content/public/browser/browser_thread.h" #include "native_mate/arguments.h" #include "native_mate/dictionary.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)>; using BooleanCallback = 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, scoped_refptr request_context, const Handler& handler) : isolate_(isolate), request_context_(request_context), handler_(handler) {} ~CustomProtocolHandler() override {} net::URLRequestJob* MaybeCreateJob( net::URLRequest* request, net::NetworkDelegate* network_delegate) const override { RequestJob* request_job = new RequestJob(request, network_delegate); request_job->SetHandlerInfo(isolate_, request_context_, handler_); return request_job; } private: v8::Isolate* isolate_; scoped_refptr request_context_; 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(const std::string& scheme, const Handler& handler, mate::Arguments* args) { CompletionCallback callback; args->GetNext(&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(), request_context_getter_, handler)); if (job_factory_->SetProtocolHandler(scheme, protocol_handler.Pass())) return PROTOCOL_OK; else return PROTOCOL_FAIL; } // Unregister the protocol handler that handles |scheme|. void UnregisterProtocol(const std::string& scheme, mate::Arguments* args); ProtocolError UnregisterProtocolInIO(const std::string& scheme); // Whether the protocol has handler registered. void IsHandledProtocol(const std::string& scheme, const BooleanCallback& callback); bool IsHandledProtocolInIO(const std::string& scheme); // Replace the protocol handler with a new one. template void InterceptProtocol(const std::string& scheme, const Handler& handler, mate::Arguments* args) { CompletionCallback callback; args->GetNext(&callback); content::BrowserThread::PostTaskAndReplyWithResult( content::BrowserThread::IO, FROM_HERE, base::Bind(&Protocol::InterceptProtocolInIO, base::Unretained(this), scheme, handler), base::Bind(&Protocol::OnIOCompleted, base::Unretained(this), callback)); } template ProtocolError InterceptProtocolInIO(const std::string& scheme, const Handler& handler) { if (!job_factory_->IsHandledProtocol(scheme)) return PROTOCOL_NOT_REGISTERED; // It is possible a protocol is handled but can not be intercepted. if (!job_factory_->HasProtocolHandler(scheme)) return PROTOCOL_FAIL; if (ContainsKey(original_protocols_, scheme)) return PROTOCOL_INTERCEPTED; scoped_ptr> protocol_handler( new CustomProtocolHandler( isolate(), request_context_getter_, handler)); original_protocols_.set( scheme, job_factory_->ReplaceProtocol(scheme, protocol_handler.Pass())); return PROTOCOL_OK; } // 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_; // Map that stores the original protocols of schemes. using OriginalProtocolsMap = base::ScopedPtrHashMap< std::string, scoped_ptr>; OriginalProtocolsMap original_protocols_; AtomURLRequestJobFactory* job_factory_; // weak ref DISALLOW_COPY_AND_ASSIGN(Protocol); }; } // namespace api } // namespace atom #endif // ATOM_BROWSER_API_ATOM_API_PROTOCOL_H_