Rename SecurityOriginCache to URLSecurityOriginMap

third_party/WebKit/Source/core/html/PublicURLManager.h

 /*
  * Copyright (C) 2012 Motorola Mobility Inc.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
  * 2.  Redistributions in binary form must reproduce the above copyright
@@ skipping 11 matching lines @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
 #ifndef PublicURLManager_h
 #define PublicURLManager_h
 
 #include "core/dom/ActiveDOMObject.h"
 #include "platform/heap/Handle.h"
 #include "wtf/HashMap.h"
-#include "wtf/HashSet.h"
 #include "wtf/text/WTFString.h"
 
 namespace blink {
 
 class KURL;
 class ExecutionContext;
-class SecurityOrigin;
 class URLRegistry;
 class URLRegistrable;
 
 class PublicURLManager final : public GarbageCollectedFinalized<PublicURLManager>, public ActiveDOMObject {
     USING_GARBAGE_COLLECTED_MIXIN(PublicURLManager);
 public:
     static PublicURLManager* create(ExecutionContext*);
 
-    void registerURL(SecurityOrigin*, const KURL&, URLRegistrable*, const String& uuid = String());
+    // Generates a new Blob URL and registers the URLRegistrable to the
+    // corresponding URLRegistry with the Blob URL. Returns the serialization
+    // of the Blob URL.
+    //
+    // |uuid| can be used for revoke() to revoke all URLs associated with the
+    // |uuid|. It's not the UUID generated and appended to the BlobURL, but an
+    // identifier for the object to which URL(s) are generated e.g. ones
+    // returned by blink::Blob::uuid().
+    String registerURL(ExecutionContext*, URLRegistrable*, const String& uuid);
+    // Revokes the given URL.
     void revoke(const KURL&);
+    // Revokes all URLs associated with |uuid|.
     void revoke(const String& uuid);
 
     // ActiveDOMObject interface.
     void stop() override;
 
     DECLARE_VIRTUAL_TRACE();
 
 private:
     explicit PublicURLManager(ExecutionContext*);
 
     // One or more URLs can be associated with the same unique ID.
     // Objects need be revoked by unique ID in some cases.
     typedef String URLString;
     typedef HashMap<URLString, String> URLMap;
+    // Map from URLRegistry instances to the maps which store association
+    // between URLs registered with the URLRegistry and UUIDs assigned for
+    // each of the URLs.
     typedef HashMap<URLRegistry*, URLMap> RegistryURLMap;
 
     RegistryURLMap m_registryToURL;
     bool m_isStopped;
 };
 
 } // namespace blink
 
 #endif // PublicURLManager_h