GI.Soup.Objects.Request

A request to retrieve a particular URI.

Since: 2.42

Exported types

newtype Request

Memory-managed wrapper type.

Constructors

Request (ManagedPtr Request)

Instances

Eq Request

Defined in GI.Soup.Objects.Request

Methods

(==) :: Request -> Request -> Bool

(/=) :: Request -> Request -> Bool

GObject Request

Defined in GI.Soup.Objects.Request

ManagedPtrNewtype Request

Defined in GI.Soup.Objects.Request

Methods

toManagedPtr :: Request -> ManagedPtr Request

TypedObject Request

Defined in GI.Soup.Objects.Request

Methods

glibType :: IO GType

HasParentTypes Request

Defined in GI.Soup.Objects.Request

IsGValue (Maybe Request)

Convert Request to and from GValue. See toGValue and fromGValue.

Defined in GI.Soup.Objects.Request

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe Request -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe Request)

type ParentTypes Request

Defined in GI.Soup.Objects.Request

type ParentTypes Request = '[Object, Initable]

class (GObject o, IsDescendantOf Request o) => IsRequest o

Type class for types which can be safely cast to Request, for instance with toRequest.

Instances

(GObject o, IsDescendantOf Request o) => IsRequest o

Defined in GI.Soup.Objects.Request

toRequest :: (MonadIO m, IsRequest o) => o -> m Request

Cast to Request, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, init, isFloating, notify, notifyByPspec, ref, refSink, runDispose, send, sendAsync, sendFinish, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getContentLength, getContentType, getData, getProperty, getQdata, getSession, getUri.

Setters

setData, setDataFull, setProperty.

getContentLength

requestGetContentLength

Arguments

:: (HasCallStack, MonadIO m, IsRequest a)

=> a

request: a Request

-> m Int64

Returns: the length of the data represented by request, or -1 if not known.

Gets the length of the data represented by request. For most request types, this will not be known until after you call requestSend or requestSendFinish.

Since: 2.42

getContentType

requestGetContentType

Arguments

:: (HasCallStack, MonadIO m, IsRequest a)

=> a

request: a Request

-> m (Maybe Text)

Returns: the type of the data represented by request, or Nothing if not known.

Gets the type of the data represented by request. For most request types, this will not be known until after you call requestSend or requestSendFinish.

As in the HTTP Content-Type header, this may include parameters after the MIME type.

Since: 2.42

getSession

requestGetSession

Arguments

:: (HasCallStack, MonadIO m, IsRequest a)

=> a

request: a Request

-> m Session

Returns: request's Session

Gets request's Session

Since: 2.42

getUri

requestGetUri

Arguments

:: (HasCallStack, MonadIO m, IsRequest a)

=> a

request: a Request

-> m URI

Returns: request's URI

Gets request's URI

Since: 2.42

send

requestSend

Arguments

:: (HasCallStack, MonadIO m, IsRequest a, IsCancellable b)

=> a

request: a Request

-> Maybe b

cancellable: a Cancellable or Nothing

-> m InputStream

Returns: a InputStream that can be used to read from the URI pointed to by request. (Can throw GError)

Synchronously requests the URI pointed to by request, and returns a InputStream that can be used to read its contents.

Note that you cannot use this method with SoupRequests attached to a SessionAsync.

Since: 2.42

sendAsync

requestSendAsync

Arguments

:: (HasCallStack, MonadIO m, IsRequest a, IsCancellable b)

=> a

request: a Request

-> Maybe b

cancellable: a Cancellable or Nothing

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback

-> m ()

Begins an asynchronously request for the URI pointed to by request.

Note that you cannot use this method with SoupRequests attached to a SessionSync.

Since: 2.42

sendFinish

requestSendFinish

Arguments

:: (HasCallStack, MonadIO m, IsRequest a, IsAsyncResult b)

=> a

request: a Request

-> b

result: the AsyncResult

-> m InputStream

Returns: a InputStream that can be used to read from the URI pointed to by request. (Can throw GError)

Gets the result of a requestSendAsync.

Since: 2.42

Properties

session

The request's Session.

Since: 2.42

constructRequestSession :: (IsRequest o, MonadIO m, IsSession a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “session” property. This is rarely needed directly, but it is used by new.

getRequestSession :: (MonadIO m, IsRequest o) => o -> m Session

Get the value of the “session” property. When overloading is enabled, this is equivalent to

get request #session

uri

The request URI.

Since: 2.42

constructRequestUri :: (IsRequest o, MonadIO m) => URI -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “uri” property. This is rarely needed directly, but it is used by new.

getRequestUri :: (MonadIO m, IsRequest o) => o -> m URI

Get the value of the “uri” property. When overloading is enabled, this is equivalent to

get request #uri