1// Copyright (c) 2010 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 NET_FTP_FTP_AUTH_CACHE_H_ 6#define NET_FTP_FTP_AUTH_CACHE_H_ 7#pragma once 8 9#include <list> 10 11#include "base/string16.h" 12#include "googleurl/src/gurl.h" 13 14namespace net { 15 16// The FtpAuthCache class is a simple cache structure to store authentication 17// information for ftp. Provides lookup, insertion, and deletion of entries. 18// The parameter for doing lookups, insertions, and deletions is a GURL of the 19// server's address (not a full URL with path, since FTP auth isn't per path). 20// For example: 21// GURL("ftp://myserver") -- OK (implied port of 21) 22// GURL("ftp://myserver:21") -- OK 23// GURL("ftp://myserver/PATH") -- WRONG, paths not allowed 24class FtpAuthCache { 25 public: 26 // Maximum number of entries we allow in the cache. 27 static const size_t kMaxEntries; 28 29 struct Entry { 30 Entry(const GURL& origin, const string16& username, 31 const string16& password); 32 ~Entry(); 33 34 const GURL origin; 35 string16 username; 36 string16 password; 37 }; 38 39 FtpAuthCache(); 40 ~FtpAuthCache(); 41 42 // Return Entry corresponding to given |origin| or NULL if not found. 43 Entry* Lookup(const GURL& origin); 44 45 // Add an entry for |origin| to the cache (consisting of |username| and 46 // |password|). If there is already an entry for |origin|, it will be 47 // overwritten. 48 void Add(const GURL& origin, const string16& username, 49 const string16& password); 50 51 // Remove the entry for |origin| from the cache, if one exists and matches 52 // |username| and |password|. 53 void Remove(const GURL& origin, const string16& username, 54 const string16& password); 55 56 private: 57 typedef std::list<Entry> EntryList; 58 59 // Internal representation of cache, an STL list. This makes lookups O(n), 60 // but we expect n to be very low. 61 EntryList entries_; 62}; 63 64} // namespace net 65 66#endif // NET_FTP_FTP_AUTH_CACHE_H_ 67