haiku/docs/user
Leorize 78b1442051 libbnetapi: BUrlRequest now outputs to BDataIO
Previously, BUrlRequest returns data received via a callback that can't
return any value. This approach have several issues:

- It's not possible to signify failures to the request.
- Users have to implement custom listeners just to handle the common
  case of outputting to a buffer/file/etc.
- The received data has to be serialized into BMessage when
  BUrlProtocolDispatchingListener is employed. This can cause a
  noticible slowdown in real-world scenarios as evident by #10748.

With this change, BUrlRequest will output directly into a BDataIO, which
exposes a richer API for request handlers to work with (for example a
BitTorrent client can request a BPositionIO for non-linear data
delivery), as well as simplifying common cases for users.

The adaptation only requires one additional API:
BHttpRequest::SetStopOnError(). This API simply instructs the HTTP
request handler to cancel the request if an HTTP error is occurred.

Change-Id: I4160884d77bff0e7678e0a623e2587987704443a
Reviewed-on: https://review.haiku-os.org/c/haiku/+/3084
Reviewed-by: Adrien Destugues <pulkomandy@gmail.com>
2021-02-28 20:39:31 +00:00
..
app Fix typo in BNotification documentation 2020-12-29 14:04:15 +01:00
device Complete and rework BJoystick docs. 2015-01-10 11:44:58 +01:00
drivers FS Interface Docs: Made read_dir description clear 2020-06-11 10:39:35 +00:00
game BFileGameSound docs: Fix typo 2020-07-07 19:20:48 +02:00
graphics Documentation: Added Accelerant documentation 2020-10-08 07:15:28 +00:00
interface BTabView docs: fix typo 2020-10-11 23:50:11 -04:00
keyboard Update keycodes image with more stylish version 2013-01-21 20:10:59 -05:00
locale typo and missing parameter 2020-09-25 12:39:16 +00:00
mail Migrate the BTextMailComponent docs to the Haiku Book. 2017-12-26 13:59:25 -05:00
media Update BBuffer class docs. 2013-02-07 02:11:09 -05:00
midi Haiku Book: old Midi Kit: fix link to the BeBook. 2015-02-11 19:00:18 -05:00
midi2 Haiku Book: revert accidental overzealous search & replace all 2020-03-08 09:21:06 +00:00
net HaikuBook: housekeeping of the netservices documentation 2021-01-29 09:56:28 +00:00
netservices libbnetapi: BUrlRequest now outputs to BDataIO 2021-02-28 20:39:31 +00:00
posix Add some documentation for libroot 2020-12-29 14:04:20 +01:00
ppp
shared HaikuBook: housekeeping of the netservices documentation 2021-01-29 09:56:28 +00:00
storage FindDirectory docs: clarify where the functions are located 2021-01-13 12:57:00 +01:00
support HaikuBook: Add skeleton for support/DateTime.h and support/Job.h. 2020-10-11 15:46:06 +00:00
translation HaikuBook: fix warnings generated by Doxygen 1.18.16. 2020-03-08 08:57:37 +00:00
apidoc.dox HaikuBook: add instructions for including INTERNAL documentation 2020-10-11 15:46:06 +00:00
book.css HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
book.dox HaikuBook: housekeeping of the netservices documentation 2021-01-29 09:56:28 +00:00
compatibility.dox Haiku Book: compatibility: list all authors at the top of the file as per convention. 2015-02-11 19:14:20 -05:00
credits.dox
Doxyfile HaikuBook: housekeeping of the netservices documentation 2021-01-29 09:56:28 +00:00
footer.html HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
header.html HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
HOWTO
Makefile HaikuBook: Add Makefile that supports the default and the develop configurations 2020-10-11 15:46:06 +00:00