Landing Recent QUIC changes until 03:18 AM, May 28, UTC

net/quic/quartc/quartc_session_interface.h

 // Copyright (c) 2017 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_QUIC_QUARTC_QUARTC_SESSION_INTERFACE_H_
 #define NET_QUIC_QUARTC_QUARTC_SESSION_INTERFACE_H_
 
 #include <stddef.h>
 #include <stdint.h>
 #include <string>
 
+#include "net/quic/core/quic_error_codes.h"
+#include "net/quic/core/quic_types.h"
 #include "net/quic/quartc/quartc_stream_interface.h"
 
 namespace net {
 
 // Given a PacketTransport, provides a way to send and receive separate streams
 // of reliable, in-order, encrypted data. For example, this can build on top of
 // a WebRTC IceTransport for sending and receiving data over QUIC.
-class QuartcSessionInterface {
+class QUIC_EXPORT_PRIVATE QuartcSessionInterface {
  public:
   virtual ~QuartcSessionInterface() {}
 
   virtual void StartCryptoHandshake() = 0;
 
   // Only needed when using SRTP with QuicTransport
   // Key Exporter interface from RFC 5705
   // Arguments are:
   // label               -- the exporter label.
   //                        part of the RFC defining each exporter usage (IN)
@@ skipping 11 matching lines @@
                                     uint8_t* result,
                                     size_t result_len) = 0;
 
   // For forward-compatibility. More parameters could be added through the
   // struct without changing the API.
   struct OutgoingStreamParameters {};
 
   virtual QuartcStreamInterface* CreateOutgoingStream(
       const OutgoingStreamParameters& params) = 0;
 
+  // If the given stream is still open, sends a reset frame to cancel it.
+  // Note:  This method cancels a stream by QuicStreamId rather than by pointer
+  // (or by a method on QuartcStreamInterface) because QuartcSession (and not
+  // the caller) owns the streams.  Streams may finish and be deleted before the
+  // caller tries to cancel them, rendering the caller's pointers invalid.
+  virtual void CancelStream(QuicStreamId stream_id) = 0;
+
   // Send and receive packets, like a virtual UDP socket. For example, this
   // could be implemented by WebRTC's IceTransport.
   class PacketTransport {
    public:
     virtual ~PacketTransport() {}
 
     // Called by the QuartcPacketWriter to check if the underneath transport is
     // writable. True if packets written are expected to be sent.  False if
     // packets will be dropped.
     virtual bool CanWrite() = 0;
@@ skipping 31 matching lines @@
     // TODO(zhihuang): Add proof verification.
   };
 
   // The |delegate| is not owned by QuartcSession.
   virtual void SetDelegate(Delegate* delegate) = 0;
 };
 
 }  // namespace net
 
 #endif  // NET_QUIC_QUARTC_QUARTC_SESSION_INTERFACE_H_