|
| 1 | +diff --git a/modules/caddyhttp/responsewriter.go b/modules/caddyhttp/responsewriter.go |
| 2 | +index 374bbfbac6..9820b41bc6 100644 |
| 3 | +--- a/modules/caddyhttp/responsewriter.go |
| 4 | ++++ b/modules/caddyhttp/responsewriter.go |
| 5 | +@@ -62,6 +62,16 @@ func (rww *ResponseWriterWrapper) Push(target string, opts *http.PushOptions) er |
| 6 | + return ErrNotImplemented |
| 7 | + } |
| 8 | + |
| 9 | ++// ReadFrom implements io.ReaderFrom. It simply calls the underlying |
| 10 | ++// ResponseWriter's ReadFrom method if there is one, otherwise it defaults |
| 11 | ++// to io.Copy. |
| 12 | ++func (rww *ResponseWriterWrapper) ReadFrom(r io.Reader) (n int64, err error) { |
| 13 | ++ if rf, ok := rww.ResponseWriter.(io.ReaderFrom); ok { |
| 14 | ++ return rf.ReadFrom(r) |
| 15 | ++ } |
| 16 | ++ return io.Copy(rww.ResponseWriter, r) |
| 17 | ++} |
| 18 | ++ |
| 19 | + // HTTPInterfaces mix all the interfaces that middleware ResponseWriters need to support. |
| 20 | + type HTTPInterfaces interface { |
| 21 | + http.ResponseWriter |
| 22 | +@@ -188,9 +198,26 @@ func (rr *responseRecorder) Write(data []byte) (int, error) { |
| 23 | + } else { |
| 24 | + n, err = rr.buf.Write(data) |
| 25 | + } |
| 26 | +- if err == nil { |
| 27 | +- rr.size += n |
| 28 | ++ |
| 29 | ++ rr.size += n |
| 30 | ++ return n, err |
| 31 | ++} |
| 32 | ++ |
| 33 | ++func (rr *responseRecorder) ReadFrom(r io.Reader) (int64, error) { |
| 34 | ++ rr.WriteHeader(http.StatusOK) |
| 35 | ++ var n int64 |
| 36 | ++ var err error |
| 37 | ++ if rr.stream { |
| 38 | ++ if rf, ok := rr.ResponseWriter.(io.ReaderFrom); ok { |
| 39 | ++ n, err = rf.ReadFrom(r) |
| 40 | ++ } else { |
| 41 | ++ n, err = io.Copy(rr.ResponseWriter, r) |
| 42 | ++ } |
| 43 | ++ } else { |
| 44 | ++ n, err = rr.buf.ReadFrom(r) |
| 45 | + } |
| 46 | ++ |
| 47 | ++ rr.size += int(n) |
| 48 | + return n, err |
| 49 | + } |
| 50 | + |
| 51 | +@@ -251,4 +278,10 @@ type ShouldBufferFunc func(status int, header http.Header) bool |
| 52 | + var ( |
| 53 | + _ HTTPInterfaces = (*ResponseWriterWrapper)(nil) |
| 54 | + _ ResponseRecorder = (*responseRecorder)(nil) |
| 55 | ++ |
| 56 | ++ // Implementing ReaderFrom can be such a significant |
| 57 | ++ // optimization that it should probably be required! |
| 58 | ++ // see PR #5022 (25%-50% speedup) |
| 59 | ++ _ io.ReaderFrom = (*ResponseWriterWrapper)(nil) |
| 60 | ++ _ io.ReaderFrom = (*responseRecorder)(nil) |
| 61 | + ) |
| 62 | +diff --git a/modules/caddyhttp/responsewriter_test.go b/modules/caddyhttp/responsewriter_test.go |
| 63 | +new file mode 100644 |
| 64 | +index 0000000000..1913932003 |
| 65 | +--- /dev/null |
| 66 | ++++ b/modules/caddyhttp/responsewriter_test.go |
| 67 | +@@ -0,0 +1,165 @@ |
| 68 | ++package caddyhttp |
| 69 | ++ |
| 70 | ++import ( |
| 71 | ++ "bytes" |
| 72 | ++ "fmt" |
| 73 | ++ "io" |
| 74 | ++ "net/http" |
| 75 | ++ "strings" |
| 76 | ++ "testing" |
| 77 | ++) |
| 78 | ++ |
| 79 | ++type responseWriterSpy interface { |
| 80 | ++ http.ResponseWriter |
| 81 | ++ Written() string |
| 82 | ++ CalledReadFrom() bool |
| 83 | ++} |
| 84 | ++ |
| 85 | ++var ( |
| 86 | ++ _ responseWriterSpy = (*baseRespWriter)(nil) |
| 87 | ++ _ responseWriterSpy = (*readFromRespWriter)(nil) |
| 88 | ++) |
| 89 | ++ |
| 90 | ++// a barebones http.ResponseWriter mock |
| 91 | ++type baseRespWriter []byte |
| 92 | ++ |
| 93 | ++func (brw *baseRespWriter) Write(d []byte) (int, error) { |
| 94 | ++ *brw = append(*brw, d...) |
| 95 | ++ return len(d), nil |
| 96 | ++} |
| 97 | ++func (brw *baseRespWriter) Header() http.Header { return nil } |
| 98 | ++func (brw *baseRespWriter) WriteHeader(statusCode int) {} |
| 99 | ++func (brw *baseRespWriter) Written() string { return string(*brw) } |
| 100 | ++func (brw *baseRespWriter) CalledReadFrom() bool { return false } |
| 101 | ++ |
| 102 | ++// an http.ResponseWriter mock that supports ReadFrom |
| 103 | ++type readFromRespWriter struct { |
| 104 | ++ baseRespWriter |
| 105 | ++ called bool |
| 106 | ++} |
| 107 | ++ |
| 108 | ++func (rf *readFromRespWriter) ReadFrom(r io.Reader) (int64, error) { |
| 109 | ++ rf.called = true |
| 110 | ++ return io.Copy(&rf.baseRespWriter, r) |
| 111 | ++} |
| 112 | ++ |
| 113 | ++func (rf *readFromRespWriter) CalledReadFrom() bool { return rf.called } |
| 114 | ++ |
| 115 | ++func TestResponseWriterWrapperReadFrom(t *testing.T) { |
| 116 | ++ tests := map[string]struct { |
| 117 | ++ responseWriter responseWriterSpy |
| 118 | ++ wantReadFrom bool |
| 119 | ++ }{ |
| 120 | ++ "no ReadFrom": { |
| 121 | ++ responseWriter: &baseRespWriter{}, |
| 122 | ++ wantReadFrom: false, |
| 123 | ++ }, |
| 124 | ++ "has ReadFrom": { |
| 125 | ++ responseWriter: &readFromRespWriter{}, |
| 126 | ++ wantReadFrom: true, |
| 127 | ++ }, |
| 128 | ++ } |
| 129 | ++ for name, tt := range tests { |
| 130 | ++ t.Run(name, func(t *testing.T) { |
| 131 | ++ // what we expect middlewares to do: |
| 132 | ++ type myWrapper struct { |
| 133 | ++ *ResponseWriterWrapper |
| 134 | ++ } |
| 135 | ++ |
| 136 | ++ wrapped := myWrapper{ |
| 137 | ++ ResponseWriterWrapper: &ResponseWriterWrapper{ResponseWriter: tt.responseWriter}, |
| 138 | ++ } |
| 139 | ++ |
| 140 | ++ const srcData = "boo!" |
| 141 | ++ // hides everything but Read, since strings.Reader implements WriteTo it would |
| 142 | ++ // take precedence over our ReadFrom. |
| 143 | ++ src := struct{ io.Reader }{strings.NewReader(srcData)} |
| 144 | ++ |
| 145 | ++ fmt.Println(name) |
| 146 | ++ if _, err := io.Copy(wrapped, src); err != nil { |
| 147 | ++ t.Errorf("Copy() err = %v", err) |
| 148 | ++ } |
| 149 | ++ |
| 150 | ++ if got := tt.responseWriter.Written(); got != srcData { |
| 151 | ++ t.Errorf("data = %q, want %q", got, srcData) |
| 152 | ++ } |
| 153 | ++ |
| 154 | ++ if tt.responseWriter.CalledReadFrom() != tt.wantReadFrom { |
| 155 | ++ if tt.wantReadFrom { |
| 156 | ++ t.Errorf("ReadFrom() should have been called") |
| 157 | ++ } else { |
| 158 | ++ t.Errorf("ReadFrom() should not have been called") |
| 159 | ++ } |
| 160 | ++ } |
| 161 | ++ }) |
| 162 | ++ } |
| 163 | ++} |
| 164 | ++ |
| 165 | ++func TestResponseRecorderReadFrom(t *testing.T) { |
| 166 | ++ tests := map[string]struct { |
| 167 | ++ responseWriter responseWriterSpy |
| 168 | ++ shouldBuffer bool |
| 169 | ++ wantReadFrom bool |
| 170 | ++ }{ |
| 171 | ++ "buffered plain": { |
| 172 | ++ responseWriter: &baseRespWriter{}, |
| 173 | ++ shouldBuffer: true, |
| 174 | ++ wantReadFrom: false, |
| 175 | ++ }, |
| 176 | ++ "streamed plain": { |
| 177 | ++ responseWriter: &baseRespWriter{}, |
| 178 | ++ shouldBuffer: false, |
| 179 | ++ wantReadFrom: false, |
| 180 | ++ }, |
| 181 | ++ "buffered ReadFrom": { |
| 182 | ++ responseWriter: &readFromRespWriter{}, |
| 183 | ++ shouldBuffer: true, |
| 184 | ++ wantReadFrom: false, |
| 185 | ++ }, |
| 186 | ++ "streamed ReadFrom": { |
| 187 | ++ responseWriter: &readFromRespWriter{}, |
| 188 | ++ shouldBuffer: false, |
| 189 | ++ wantReadFrom: true, |
| 190 | ++ }, |
| 191 | ++ } |
| 192 | ++ for name, tt := range tests { |
| 193 | ++ t.Run(name, func(t *testing.T) { |
| 194 | ++ var buf bytes.Buffer |
| 195 | ++ |
| 196 | ++ rr := NewResponseRecorder(tt.responseWriter, &buf, func(status int, header http.Header) bool { |
| 197 | ++ return tt.shouldBuffer |
| 198 | ++ }) |
| 199 | ++ |
| 200 | ++ const srcData = "boo!" |
| 201 | ++ // hides everything but Read, since strings.Reader implements WriteTo it would |
| 202 | ++ // take precedence over our ReadFrom. |
| 203 | ++ src := struct{ io.Reader }{strings.NewReader(srcData)} |
| 204 | ++ |
| 205 | ++ if _, err := io.Copy(rr, src); err != nil { |
| 206 | ++ t.Errorf("Copy() err = %v", err) |
| 207 | ++ } |
| 208 | ++ |
| 209 | ++ wantStreamed := srcData |
| 210 | ++ wantBuffered := "" |
| 211 | ++ if tt.shouldBuffer { |
| 212 | ++ wantStreamed = "" |
| 213 | ++ wantBuffered = srcData |
| 214 | ++ } |
| 215 | ++ |
| 216 | ++ if got := tt.responseWriter.Written(); got != wantStreamed { |
| 217 | ++ t.Errorf("streamed data = %q, want %q", got, wantStreamed) |
| 218 | ++ } |
| 219 | ++ if got := buf.String(); got != wantBuffered { |
| 220 | ++ t.Errorf("buffered data = %q, want %q", got, wantBuffered) |
| 221 | ++ } |
| 222 | ++ |
| 223 | ++ if tt.responseWriter.CalledReadFrom() != tt.wantReadFrom { |
| 224 | ++ if tt.wantReadFrom { |
| 225 | ++ t.Errorf("ReadFrom() should have been called") |
| 226 | ++ } else { |
| 227 | ++ t.Errorf("ReadFrom() should not have been called") |
| 228 | ++ } |
| 229 | ++ } |
| 230 | ++ }) |
| 231 | ++ } |
| 232 | ++} |
0 commit comments