blob: 9417bfc1b14e948617d1df58ae8f456e540a4f3d [file] [log] [blame]
// Copyright (c) 2011 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 NET_FTP_FTP_AUTH_CACHE_H_
#define NET_FTP_FTP_AUTH_CACHE_H_
#include <list>
#include "googleurl/src/gurl.h"
#include "net/base/auth.h"
#include "net/base/net_export.h"
namespace net {
// The FtpAuthCache class is a simple cache structure to store authentication
// information for ftp. Provides lookup, insertion, and deletion of entries.
// The parameter for doing lookups, insertions, and deletions is a GURL of the
// server's address (not a full URL with path, since FTP auth isn't per path).
// For example:
// GURL("ftp://myserver") -- OK (implied port of 21)
// GURL("ftp://myserver:21") -- OK
// GURL("ftp://myserver/PATH") -- WRONG, paths not allowed
class NET_EXPORT_PRIVATE FtpAuthCache {
public:
// Maximum number of entries we allow in the cache.
static const size_t kMaxEntries;
struct Entry {
Entry(const GURL& origin, const AuthCredentials& credentials);
#if defined(DISABLE_FTP_SUPPORT)
~Entry() {
NOTREACHED();
}
#else
~Entry();
#endif
GURL origin;
AuthCredentials credentials;
};
FtpAuthCache();
~FtpAuthCache();
// Return Entry corresponding to given |origin| or NULL if not found.
Entry* Lookup(const GURL& origin);
// Add an entry for |origin| to the cache using |credentials|. If there is
// already an entry for |origin|, it will be overwritten.
void Add(const GURL& origin, const AuthCredentials& credentials);
// Remove the entry for |origin| from the cache, if one exists and matches
// |credentials|.
void Remove(const GURL& origin, const AuthCredentials& credentials);
private:
typedef std::list<Entry> EntryList;
// Internal representation of cache, an STL list. This makes lookups O(n),
// but we expect n to be very low.
EntryList entries_;
};
} // namespace net
#endif // NET_FTP_FTP_AUTH_CACHE_H_