blob: d0d3599e3f198ec36707048ec022a85539a1860d [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_HTTP_HTTP_PIPELINED_CONNECTION_H_
#define NET_HTTP_HTTP_PIPELINED_CONNECTION_H_
#include "net/base/net_export.h"
#include "net/base/net_log.h"
#include "net/socket/ssl_client_socket.h"
namespace net {
class BoundNetLog;
class ClientSocketHandle;
class HostPortPair;
class HttpPipelinedStream;
class ProxyInfo;
struct SSLConfig;
class NET_EXPORT_PRIVATE HttpPipelinedConnection {
public:
enum Feedback {
OK,
PIPELINE_SOCKET_ERROR,
OLD_HTTP_VERSION,
MUST_CLOSE_CONNECTION,
AUTHENTICATION_REQUIRED,
};
class Delegate {
public:
// Called when a pipeline has newly available capacity. This may be because
// the first request has been sent and the pipeline is now active. Or, it
// may be because a request successfully completed.
virtual void OnPipelineHasCapacity(HttpPipelinedConnection* pipeline) = 0;
// Called every time a pipeline receives headers. Lets the delegate know if
// the headers indicate that pipelining can be used.
virtual void OnPipelineFeedback(HttpPipelinedConnection* pipeline,
Feedback feedback) = 0;
};
class Factory {
public:
virtual ~Factory() {}
virtual HttpPipelinedConnection* CreateNewPipeline(
ClientSocketHandle* connection,
Delegate* delegate,
const HostPortPair& origin,
const SSLConfig& used_ssl_config,
const ProxyInfo& used_proxy_info,
const BoundNetLog& net_log,
bool was_npn_negotiated,
NextProto protocol_negotiated) = 0;
};
virtual ~HttpPipelinedConnection() {}
// Returns a new stream that uses this pipeline.
virtual HttpPipelinedStream* CreateNewStream() = 0;
// The number of streams currently associated with this pipeline.
virtual int depth() const = 0;
// True if this pipeline can accept new HTTP requests. False if a fatal error
// has occurred.
virtual bool usable() const = 0;
// True if this pipeline has bound one request and is ready for additional
// requests.
virtual bool active() const = 0;
// The SSLConfig used to establish this connection.
virtual const SSLConfig& used_ssl_config() const = 0;
// The ProxyInfo used to establish this connection.
virtual const ProxyInfo& used_proxy_info() const = 0;
// The BoundNetLog of this pipelined connection.
virtual const BoundNetLog& net_log() const = 0;
// True if this connection was NPN negotiated.
virtual bool was_npn_negotiated() const = 0;
// Protocol negotiated with the server.
virtual NextProto protocol_negotiated() const = 0;
};
} // namespace net
#endif // NET_HTTP_HTTP_PIPELINED_CONNECTION_H_