Struct Location 

pub struct Location {
    pub uri: String,
}

A location to retrieve a particular stream from. This URI should be one of the following:

• An empty string or the string ‘arrow-flight-reuse-connection://?’: indicating that the ticket can be redeemed on the service where the ticket was generated via a DoGet request.
• A valid grpc URI (grpc://, grpc+tls://, grpc+unix://, etc.): indicating that the ticket can be redeemed on the service at the given URI via a DoGet request.
• A valid HTTP URI (http://, https://, etc.): indicating that the client should perform a GET request against the given URI to retrieve the stream. The ticket should be empty in this case and should be ignored by the client. Cloud object storage can be utilized by presigned URLs or mediating the auth separately and returning the full URL (e.g. https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/...).

We allow non-Flight URIs for the purpose of allowing Flight services to indicate that results can be downloaded in formats other than Arrow (such as Parquet) or to allow direct fetching of results from a URI to reduce excess copying and data movement. In these cases, the following conventions should be followed by servers and clients:

• Unless otherwise specified by the ‘Content-Type’ header of the response, a client should assume the response is using the Arrow IPC Streaming format. Usage of an IANA media type like ‘application/octet-stream’ should be assumed to be using the Arrow IPC Streaming format.
• The server may allow the client to choose a specific response format by specifying an ‘Accept’ header in the request, such as ‘application/vnd.apache.parquet’ or ‘application/vnd.apache.arrow.stream’. If multiple types are requested and supported by the server, the choice of which to use is server-specific. If none of the requested content-types are supported, the server may respond with either 406 (Not Acceptable) or 415 (Unsupported Media Type), or successfully respond with a different format that it does support along with the correct ‘Content-Type’ header.

Note: new schemes may be proposed in the future to allow for more flexibility based on community requests.

Fields

uri: String

Trait Implementations

impl Clone for Location

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Location

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Location

fn default() -> Self

Returns the “default value” for a type.

impl Display for Location

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Location

impl Hash for Location

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for Location

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for Location

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Location