shaka::HttpFile Class Reference

#include <http_file.h>

Inheritance diagram for shaka::HttpFile:

Public Member Functions
	HttpFile (HttpMethod method, const std::string &url)
	HttpFile (HttpMethod method, const std::string &url, const std::string &upload_content_type, const std::vector< std::string > &headers, uint32_t timeout_in_seconds)
	HttpFile (const HttpFile &)=delete
HttpFile &	operator= (const HttpFile &)=delete
Status	CloseWithStatus ()
File implementation overrides.
bool	Close () override
int64_t	Read (void *buffer, uint64_t length) override
int64_t	Write (const void *buffer, uint64_t length) override
int64_t	Size () override
bool	Flush () override
bool	Seek (uint64_t position) override
bool	Tell (uint64_t *position) override
bool	Open () override
	Internal open. Should not be used directly.
Public Member Functions inherited from shaka::File
const std::string &	file_name () const

Additional Inherited Members
Static Public Member Functions inherited from shaka::File
static File *	Open (const char *file_name, const char *mode)
static File *	OpenWithNoBuffering (const char *file_name, const char *mode)
static bool	Delete (const char *file_name)
static int64_t	GetFileSize (const char *file_name)
static bool	ReadFileToString (const char *file_name, std::string *contents)
static bool	WriteStringToFile (const char *file_name, const std::string &contents)
static bool	WriteFileAtomically (const char *file_name, const std::string &contents)
static bool	Copy (const char *from_file_name, const char *to_file_name)
static int64_t	CopyFile (File *source, File *destination)
static int64_t	CopyFile (File *source, File *destination, int64_t max_copy)
static bool	IsLocalRegularFile (const char *file_name)
static std::string	MakeCallbackFileName (const BufferCallbackParams &callback_params, const std::string &name)
static bool	ParseCallbackFileName (const std::string &callback_file_name, const BufferCallbackParams **callback_params, std::string *name)
Protected Member Functions inherited from shaka::File
	File (const std::string &file_name)
virtual	~File ()

Detailed Description

HttpFile reads or writes network requests.

Note that calling Flush will indicate EOF for the upload and no more can be uploaded.

About how to use this, please visit the corresponding documentation [1].

[1] https://google.github.io/shaka-packager/html/tutorials/http_upload.html

Definition at line 38 of file http_file.h.

Member Function Documentation

Close()

bool shaka::HttpFile::Close ( )

overridevirtual

Flush() and de-allocate resources associated with this file, and delete this File object. THIS IS THE ONE TRUE WAY TO DEALLOCATE THIS OBJECT.

Returns

true on success. For writable files, returning false MAY INDICATE DATA LOSS.

Implements shaka::File.

Definition at line 236 of file http_file.cc.

Flush()

bool shaka::HttpFile::Flush ( )

overridevirtual

Flush the file so that recently written data will survive an application crash (but not necessarily an OS crash). For instance, in LocalFile the data is flushed into the OS but not necessarily to disk.

Returns

true on success, false otherwise.

Implements shaka::File.

Definition at line 255 of file http_file.cc.

Read()

int64_t shaka::HttpFile::Read ( void *  buffer, uint64_t  length  )

overridevirtual

Read data and return it in buffer.

Parameters

[out]	buffer	points to a block of memory with a size of at least length bytes.
	length	indicates number of bytes to be read.

Returns

Number of bytes read, or a value < 0 on error. Zero on end-of-file, or if 'length' is zero.

Implements shaka::File.

Definition at line 240 of file http_file.cc.

Seek()

bool shaka::HttpFile::Seek ( uint64_t  position )

overridevirtual

Seek to the specifield position in the file.

Parameters

position

is the position to seek to.

Returns

true on success, false otherwise.

Implements shaka::File.

Definition at line 260 of file http_file.cc.

Size()

int64_t shaka::HttpFile::Size ( )

overridevirtual

Returns

Size of the file in bytes. A return value less than zero indicates a problem getting the size.

Implements shaka::File.

Definition at line 250 of file http_file.cc.

Tell()

bool shaka::HttpFile::Tell ( uint64_t *  position )

overridevirtual

Get the current file position.

Parameters

position

is a pointer to contain the current file position upon successful return.

Returns

true on succcess, false otherwise.

Implements shaka::File.

Definition at line 265 of file http_file.cc.

Write()

int64_t shaka::HttpFile::Write ( const void *  buffer, uint64_t  length  )

overridevirtual

Write block of data.

Parameters

buffer	points to a block of memory with at least length bytes.
length	indicates number of bytes to write.

Returns

Number of bytes written, or a value < 0 on error.

Implements shaka::File.

Definition at line 245 of file http_file.cc.

---

The documentation for this class was generated from the following files:

• packager/file/http_file.h
• packager/file/http_file.cc