Qore FileLocationHandler Module Reference 2.3
Loading...
Searching...
No Matches
FileLocationHandler::FileLocationHandlerHttp Class Reference

The class for handling http(s):// locations. More...

#include <FileLocationHandlerHttp.qc.dox.h>

Inheritance diagram for FileLocationHandler::FileLocationHandlerHttp:
[legend]

Public Attributes

const HttpClientLocationOpts
 Valid HTTP location options. More...
 

Private Member Methods

binary getBinaryFileImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
Qore::InputStream getBinaryStreamImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
HTTPClient getHttpClient (string scheme, string location, *hash< auto > opts, reference< string > path, bool do_connect=True)
 Returns an HTTP client for the given location. More...
 
Qore::AbstractPollOperation getIoPollerForLocationImpl (string scheme, string location, *hash< auto > opts)
 Retrieves an I/O poller to retrieve a binary file from the given location. More...
 
OutputStreamWrapper getOutputStreamImpl (string scheme, string location, *hash< auto > opts)
 Returns an output stream for writing data to the given location. More...
 
hash< string, hash< FileHandlerOptionInfo > > getReadOptionsImpl ()
 Gets supported read options. More...
 
Qore::StreamReader getStreamReaderImpl (string scheme, string location, *hash< auto > opts)
 Returns a stream reader for the file's data at the given location. More...
 
string getTextFileImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a text file from the given location. More...
 
hash< string, hash< FileHandlerOptionInfo > > getWriteOptionsImpl ()
 Gets supported write options. More...
 
 writeFileImpl (string scheme, string location, data contents, *hash< auto > opts)
 Writes data to a file at the given location. More...
 
abstract binary getBinaryFileImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
abstract Qore::InputStream getBinaryStreamImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
abstract Qore::AbstractPollOperation getIoPollerForLocationImpl (string scheme, string location, *hash< auto > opts)
 Retrieves an I/O poller to retrieve a binary file from the given location. More...
 
abstract OutputStreamWrapper getOutputStreamImpl (string scheme, string location, *hash< auto > opts)
 Returns an output stream for writing data to the given location. More...
 
abstract hash< string, hash< FileHandlerOptionInfo > > getReadOptionsImpl ()
 Gets supported read options. More...
 
abstract Qore::StreamReader getStreamReaderImpl (string scheme, string location, *hash< auto > opts)
 Returns a string stream for the file's data at the given location. More...
 
abstract string getTextFileImpl (string scheme, string location, *hash< auto > opts)
 Retrieves a text file from the given location. More...
 
abstract hash< string, hash< FileHandlerOptionInfo > > getWriteOptionsImpl ()
 Gets supported write options. More...
 
abstract writeFileImpl (string scheme, string location, data contents, *hash< auto > opts)
 Writes data to a file at the given location. More...
 

Additional Inherited Members

- Public Member Methods inherited from FileLocationHandler::AbstractFileLocationHandler
binary getBinaryFile (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
Qore::InputStream getBinaryStream (string scheme, string location, *hash< auto > opts)
 Retrieves a binary file from the given location. More...
 
Qore::AbstractPollOperation getIoPollerForLocation (string scheme, string location, *hash< auto > opts)
 Retrieves an I/O poller to retrieve a binary file from the given location. More...
 
OutputStreamWrapper getOutputStream (string scheme, string location, *hash< auto > opts)
 Returns an output stream for writing data to the given location. More...
 
hash< string, hash< FileHandlerOptionInfo > > getReadOptions ()
 Gets supported read options. More...
 
Qore::StreamReader getStreamReader (string scheme, string location, *hash< auto > opts)
 Returns a string stream for the file's data at the given location. More...
 
string getTextFile (string scheme, string location, *hash< auto > opts)
 Retrieves a text file from the given location. More...
 
hash< string, hash< FileHandlerOptionInfo > > getWriteOptions ()
 Gets supported write options. More...
 
 writeFile (string scheme, string location, data contents, *hash< auto > opts)
 Writes data to a file at the given location. More...
 
- Static Private Member Methods inherited from FileLocationHandler::AbstractFileLocationHandler
static string forceEncoding (string str, *string encoding)
 Returns a string tagged with the given encoding, if any.
 

Detailed Description

The class for handling http(s):// locations.

Member Function Documentation

◆ getBinaryFileImpl()

binary FileLocationHandler::FileLocationHandlerHttp::getBinaryFileImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Retrieves a binary file from the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optsread options
Returns
the binary data of the file's contents, if it can be retrieved
Note
This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getBinaryStreamImpl()

Qore::InputStream FileLocationHandler::FileLocationHandlerHttp::getBinaryStreamImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Retrieves a binary file from the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optsread options
Returns
an input stream of the file's contents, if it can be retrieved
Note
This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getHttpClient()

HTTPClient FileLocationHandler::FileLocationHandlerHttp::getHttpClient ( string  scheme,
string  location,
*hash< auto >  opts,
reference< string >  path,
bool  do_connect = True 
)
private

Returns an HTTP client for the given location.

Note
This method can throw any exception related to making an HTTP connection

◆ getIoPollerForLocationImpl()

Qore::AbstractPollOperation FileLocationHandler::FileLocationHandlerHttp::getIoPollerForLocationImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Retrieves an I/O poller to retrieve a binary file from the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optsread options
Returns
an I/O poller to retrieve the file's data

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getOutputStreamImpl()

OutputStreamWrapper FileLocationHandler::FileLocationHandlerHttp::getOutputStreamImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Returns an output stream for writing data to the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optswrite options
Returns
an output stream for writing to the file
Note
  • OutputStream::close() must be called to close the stream after writing terminates in order to avoid a deadlock
  • The data written to the OutputStreamWrapper object is written in the background; to ensure that the data has been written to the target, call OutputStreamWrapper::waitForIo()
  • This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getReadOptionsImpl()

hash< string, hash< FileHandlerOptionInfo > > FileLocationHandler::FileLocationHandlerHttp::getReadOptionsImpl ( )
privatevirtual

Gets supported read options.

Returns
supported read options

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getStreamReaderImpl()

Qore::StreamReader FileLocationHandler::FileLocationHandlerHttp::getStreamReaderImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Returns a stream reader for the file's data at the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optsread options
Returns
a stream reader for the file's contents, if it can be retrieved
Note
This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getTextFileImpl()

string FileLocationHandler::FileLocationHandlerHttp::getTextFileImpl ( string  scheme,
string  location,
*hash< auto >  opts 
)
privatevirtual

Retrieves a text file from the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
optsread options
Returns
the string of the file's contents, if it can be retrieved
Note
This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ getWriteOptionsImpl()

hash< string, hash< FileHandlerOptionInfo > > FileLocationHandler::FileLocationHandlerHttp::getWriteOptionsImpl ( )
privatevirtual

Gets supported write options.

Returns
supported write options

Implements FileLocationHandler::AbstractFileLocationHandler.

◆ writeFileImpl()

FileLocationHandler::FileLocationHandlerHttp::writeFileImpl ( string  scheme,
string  location,
data  contents,
*hash< auto >  opts 
)
privatevirtual

Writes data to a file at the given location.

Parameters
schemethe scheme being used
locationthe location string without the scheme
contentsthe file's contents
optswrite options
Note
This method can throw any exception related to making an HTTP call

Implements FileLocationHandler::AbstractFileLocationHandler.

Member Data Documentation

◆ HttpClientLocationOpts

const FileLocationHandler::FileLocationHandlerHttp::HttpClientLocationOpts

Valid HTTP location options.

See also
HTTPClient::constructor() for supported options