blob: d5a7c423d68df01347e6c0feea9da3069f29d0d0 [file] [log] [blame]
// Copyright (c) 2012 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_URL_REQUEST_VIEW_CACHE_HELPER_H_
#define NET_URL_REQUEST_VIEW_CACHE_HELPER_H_
#include <string>
#include "base/memory/weak_ptr.h"
#include "net/base/completion_callback.h"
#include "net/base/io_buffer.h"
#include "net/base/net_export.h"
namespace disk_cache {
class Backend;
class Entry;
} // namespace disk_cache
namespace net {
class URLRequestContext;
class NET_EXPORT ViewCacheHelper {
public:
ViewCacheHelper();
~ViewCacheHelper();
// Formats the cache information for |key| as HTML. Returns a net error code.
// If this method returns ERR_IO_PENDING, |callback| will be notified when the
// operation completes. |out| must remain valid until this operation completes
// or the object is destroyed.
int GetEntryInfoHTML(const std::string& key,
const URLRequestContext* context,
std::string* out,
const CompletionCallback& callback);
// Formats the cache contents as HTML. Returns a net error code.
// If this method returns ERR_IO_PENDING, |callback| will be notified when the
// operation completes. |out| must remain valid until this operation completes
// or the object is destroyed. |url_prefix| will be prepended to each entry
// key as a link to the entry.
int GetContentsHTML(const URLRequestContext* context,
const std::string& url_prefix,
std::string* out,
const CompletionCallback& callback);
// Lower-level helper to produce a textual representation of binary data.
// The results are appended to |result| and can be used in HTML pages
// provided the dump is contained within <pre></pre> tags.
static void HexDump(const char *buf, size_t buf_len, std::string* result);
private:
enum State {
STATE_NONE,
STATE_GET_BACKEND,
STATE_GET_BACKEND_COMPLETE,
STATE_OPEN_NEXT_ENTRY,
STATE_OPEN_NEXT_ENTRY_COMPLETE,
STATE_OPEN_ENTRY,
STATE_OPEN_ENTRY_COMPLETE,
STATE_READ_RESPONSE,
STATE_READ_RESPONSE_COMPLETE,
STATE_READ_DATA,
STATE_READ_DATA_COMPLETE
};
// Implements GetEntryInfoHTML and GetContentsHTML.
int GetInfoHTML(const std::string& key,
const URLRequestContext* context,
const std::string& url_prefix,
std::string* out,
const CompletionCallback& callback);
// This is a helper function used to trigger a completion callback. It may
// only be called if callback_ is non-null.
void DoCallback(int rv);
// This will trigger the completion callback if appropriate.
void HandleResult(int rv);
// Runs the state transition loop.
int DoLoop(int result);
// Each of these methods corresponds to a State value. If there is an
// argument, the value corresponds to the return of the previous state or
// corresponding callback.
int DoGetBackend();
int DoGetBackendComplete(int result);
int DoOpenNextEntry();
int DoOpenNextEntryComplete(int result);
int DoOpenEntry();
int DoOpenEntryComplete(int result);
int DoReadResponse();
int DoReadResponseComplete(int result);
int DoReadData();
int DoReadDataComplete(int result);
// Called to signal completion of asynchronous IO.
void OnIOComplete(int result);
const URLRequestContext* context_;
disk_cache::Backend* disk_cache_;
disk_cache::Entry* entry_;
void* iter_;
scoped_refptr<IOBuffer> buf_;
int buf_len_;
int index_;
std::string key_;
std::string url_prefix_;
std::string* data_;
CompletionCallback callback_;
State next_state_;
base::WeakPtrFactory<ViewCacheHelper> weak_factory_;
DISALLOW_COPY_AND_ASSIGN(ViewCacheHelper);
};
} // namespace net.
#endif // NET_URL_REQUEST_VIEW_CACHE_HELPER_H_