Fauna v10 .NET/C# Driver 1.0.0
 
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Properties | List of all members
Fauna.Client Class Reference

Represents a client for interacting with a Fauna. More...

Inheritance diagram for Fauna.Client:
Fauna.BaseClient Fauna.IClient

Public Member Functions

 Client ()
 Initializes a new instance of a Client with the default configuration. Assumes the environment variable FAUNA_SECRET is set.
 
 Client (string secret)
 Initializes a new instance of a Client with a secret.
 
 Client (Configuration config)
 Initializes a new instance of the Client with a custom Configuration.
 
DB DataContext< DB > ()
 Create and return a new database context which uses the Client instance.
 
void Dispose ()
 Disposes the resources used by the Client class.
 
- Public Member Functions inherited from Fauna.BaseClient
Task< QuerySuccess< T > > QueryAsync< T > (Query query, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously executes a specified FQL query against the Fauna database and returns the typed result.
Template Parameters
TThe type of the result expected from the query, corresponding to the structure of the FQL query's expected response.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution as QuerySuccess<T>.
Exceptions
AuthenticationExceptionThrown when authentication fails due to invalid credentials or other authentication issues.
AuthorizationExceptionThrown when the client lacks sufficient permissions to execute the query.
QueryCheckExceptionThrown when the query has syntax errors or is otherwise malformed.
QueryRuntimeExceptionThrown when runtime errors occur during query execution, such as invalid arguments or operational failures.
AbortExceptionThrown when the FQL abort function is called within the query, containing the data provided during the abort operation.
InvalidRequestExceptionThrown for improperly formatted requests or requests that Fauna cannot process.
ContendedTransactionExceptionThrown when a transaction is aborted due to concurrent modification or contention issues.
ThrottlingExceptionThrown when the query exceeds established rate limits for the Fauna service.
QueryTimeoutExceptionThrown when the query execution time exceeds the specified or default timeout period.
ServiceExceptionThrown in response to internal Fauna service errors, indicating issues on the server side.
FaunaExceptionThrown for unexpected or miscellaneous errors not covered by the other specific exception types.

 
Task< QuerySuccess< object?> > QueryAsync (Query query, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously executes a specified FQL query against the Fauna database.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution.
Exceptions
AuthenticationExceptionThrown when authentication fails due to invalid credentials or other authentication issues.
AuthorizationExceptionThrown when the client lacks sufficient permissions to execute the query.
QueryCheckExceptionThrown when the query has syntax errors or is otherwise malformed.
QueryRuntimeExceptionThrown when runtime errors occur during query execution, such as invalid arguments or operational failures.
AbortExceptionThrown when the FQL abort function is called within the query, containing the data provided during the abort operation.
InvalidRequestExceptionThrown for improperly formatted requests or requests that Fauna cannot process.
ContendedTransactionExceptionThrown when a transaction is aborted due to concurrent modification or contention issues.
ThrottlingExceptionThrown when the query exceeds established rate limits for the Fauna service.
QueryTimeoutExceptionThrown when the query execution time exceeds the specified or default timeout period.
ServiceExceptionThrown in response to internal Fauna service errors, indicating issues on the server side.
FaunaExceptionThrown for unexpected or miscellaneous errors not covered by the other specific exception types.

 
Task< QuerySuccess< T > > QueryAsync< T > (Query query, ISerializer< T > serializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously executes a specified FQL query against the Fauna database and returns the typed result.
Template Parameters
TThe type of the result expected from the query, corresponding to the structure of the FQL query's expected response.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
serializerA serializer for the success data type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution as QuerySuccess<T>.
Exceptions
AuthenticationExceptionThrown when authentication fails due to invalid credentials or other authentication issues.
AuthorizationExceptionThrown when the client lacks sufficient permissions to execute the query.
QueryCheckExceptionThrown when the query has syntax errors or is otherwise malformed.
QueryRuntimeExceptionThrown when runtime errors occur during query execution, such as invalid arguments or operational failures.
AbortExceptionThrown when the FQL abort function is called within the query, containing the data provided during the abort operation.
InvalidRequestExceptionThrown for improperly formatted requests or requests that Fauna cannot process.
ContendedTransactionExceptionThrown when a transaction is aborted due to concurrent modification or contention issues.
ThrottlingExceptionThrown when the query exceeds established rate limits for the Fauna service.
QueryTimeoutExceptionThrown when the query execution time exceeds the specified or default timeout period.
ServiceExceptionThrown in response to internal Fauna service errors, indicating issues on the server side.
FaunaExceptionThrown for unexpected or miscellaneous errors not covered by the other specific exception types.

 
Task< QuerySuccess< object?> > QueryAsync (Query query, ISerializer serializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously executes a specified FQL query against the Fauna database and returns the typed result.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
serializerA serializer for the success data type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation toke to use.
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution.
Exceptions
AuthenticationExceptionThrown when authentication fails due to invalid credentials or other authentication issues.
AuthorizationExceptionThrown when the client lacks sufficient permissions to execute the query.
QueryCheckExceptionThrown when the query has syntax errors or is otherwise malformed.
QueryRuntimeExceptionThrown when runtime errors occur during query execution, such as invalid arguments or operational failures.
AbortExceptionThrown when the FQL abort function is called within the query, containing the data provided during the abort operation.
InvalidRequestExceptionThrown for improperly formatted requests or requests that Fauna cannot process.
ContendedTransactionExceptionThrown when a transaction is aborted due to concurrent modification or contention issues.
ThrottlingExceptionThrown when the query exceeds established rate limits for the Fauna service.
QueryTimeoutExceptionThrown when the query execution time exceeds the specified or default timeout period.
ServiceExceptionThrown in response to internal Fauna service errors, indicating issues on the server side.
FaunaExceptionThrown for unexpected or miscellaneous errors not covered by the other specific exception types.

 
IAsyncEnumerable< Page< T > > PaginateAsync< T > (Query query, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor.
Template Parameters
TThe type of the data expected in each page.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items of type T .
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< T > > PaginateAsync< T > (Page< T > page, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor. The provided page is the first page yielded.
Template Parameters
TThe type of the data expected in each page.
Parameters
pageThe initial page.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items of type T .
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< object?> > PaginateAsync (Query query, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items.
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< object?> > PaginateAsync (Page< object?> page, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor. The provided page is the first page yielded.
Parameters
pageThe initial page.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items.
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< T > > PaginateAsync< T > (Query query, ISerializer< T > elemSerializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor.
Template Parameters
TThe type of the data expected in each page.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
elemSerializerA data serializer for the page element type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items of type T .
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< T > > PaginateAsync< T > (Page< T > page, ISerializer< T > elemSerializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor. The provided page is the first page yielded.
Template Parameters
TThe type of the data expected in each page.
Parameters
pageThe initial page.
elemSerializerA data serializer for the page element type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
An asynchronous enumerable of pages, each containing a list of items of type T .
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< object?> > PaginateAsync (Query query, ISerializer elemSerializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor.
Parameters
queryThe FQL query object representing the query to be executed against the Fauna database.
elemSerializerA data serializer for the page element type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution.
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
IAsyncEnumerable< Page< object?> > PaginateAsync (Page< object?> page, ISerializer elemSerializer, QueryOptions? queryOptions=null, CancellationToken cancel=default)
 Asynchronously iterates over pages of a Fauna query result, automatically fetching subsequent pages using the 'after' cursor. The provided page is the first page yielded.
Parameters
pageThe FQL query object representing the query to be executed against the Fauna database.
elemSerializerA data serializer for the page element type.
queryOptionsOptional parameters to customize the query execution, such as timeout settings and custom headers.
cancelA cancellation token to use.
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution.
This method handles pagination by sending multiple requests to Fauna as needed, based on the presence of an 'after' cursor in the query results.
 
async Task< T > LoadRefAsync< T > (BaseRef< T > reference, CancellationToken cancel=default)
 Asynchronously executes a specified FQL query against the Fauna database and returns the typed result.
Template Parameters
TThe type of the result expected from the query, corresponding to the structure of the FQL query's expected response.
Parameters
referenceThe reference to load.
cancelA cancellation token to use
Returns
A Task representing the asynchronous operation, which upon completion contains the result of the query execution as QuerySuccess<T>.
Exceptions
AuthenticationExceptionThrown when authentication fails due to invalid credentials or other authentication issues.
AuthorizationExceptionThrown when the client lacks sufficient permissions to execute the query.
QueryCheckExceptionThrown when the query has syntax errors or is otherwise malformed.
QueryRuntimeExceptionThrown when runtime errors occur during query execution, such as invalid arguments or operational failures.
AbortExceptionThrown when the FQL abort function is called within the query, containing the data provided during the abort operation.
InvalidRequestExceptionThrown for improperly formatted requests or requests that Fauna cannot process.
ContendedTransactionExceptionThrown when a transaction is aborted due to concurrent modification or contention issues.
ThrottlingExceptionThrown when the query exceeds established rate limits for the Fauna service.
QueryTimeoutExceptionThrown when the query execution time exceeds the specified or default timeout period.
ServiceExceptionThrown in response to internal Fauna service errors, indicating issues on the server side.
FaunaExceptionThrown for unexpected or miscellaneous errors not covered by the other specific exception types.
NullDocumentExceptionThrown when the provided reference does not exist.

 
async Task< StreamEnumerable< T > > EventStreamAsync< T > (Query query, QueryOptions? queryOptions=null, StreamOptions? streamOptions=null, CancellationToken cancellationToken=default)
 Retrieves a Stream token from Fauna and returns a StreamEnumerable for the stream events.
 
async Task< StreamEnumerable< T > > EventStreamAsync< T > (EventSource eventSource, CancellationToken cancellationToken=default)
 Returns a StreamEnumerable for the stream events.
 
async Task< FeedEnumerable< T > > EventFeedAsync< T > (EventSource eventSource, FeedOptions? feedOptions=null, CancellationToken cancellationToken=default)
 Opens the event feed with Fauna and returns an enumerator for the events.
 
async Task< FeedEnumerable< T > > EventFeedAsync< T > (Query query, FeedOptions? feedOptions=null, CancellationToken cancellationToken=default)
 Opens the event feed with Fauna and returns an enumerator for the events.
 
IAsyncEnumerator< Event< T > > SubscribeStream< T > (EventSource eventSource, MappingContext ctx, CancellationToken cancel=default)
 Opens the stream with Fauna and returns an enumerator for the stream events.
 
IAsyncEnumerator< FeedPage< T > > SubscribeFeed< T > (EventSource eventSource, MappingContext ctx, CancellationToken cancel=default)
 Opens an event feed with Fauna and returns an enumerator for the events.
 

Public Attributes

readonly? IStatsCollector StatsCollector
 Provides collection and aggregation of query statistics. Can be set to null in the Configuration.
 

Properties

long LastSeenTxn [get]
 Gets the timestamp of the last transaction seen by this client.
 

Detailed Description

Represents a client for interacting with a Fauna.

Definition at line 15 of file Client.cs.

Constructor & Destructor Documentation

◆ Client() [1/3]

Fauna.Client.Client ( )

Initializes a new instance of a Client with the default configuration. Assumes the environment variable FAUNA_SECRET is set.

Definition at line 45 of file Client.cs.

◆ Client() [2/3]

Fauna.Client.Client ( string  secret)

Initializes a new instance of a Client with a secret.

Parameters
secretThe secret key for authentication.

Definition at line 51 of file Client.cs.

◆ Client() [3/3]

Fauna.Client.Client ( Configuration  config)

Initializes a new instance of the Client with a custom Configuration.

Parameters
configThe configuration settings for the client.

Definition at line 60 of file Client.cs.

Member Function Documentation

◆ DataContext< DB >()

DB Fauna.Client.DataContext< DB > ( )

Create and return a new database context which uses the Client instance.

Template Parameters
DBThe DataContext subtype to instantiate.
Returns
An instance of DB .
Type Constraints
DB :DataContext 

Definition at line 72 of file Client.cs.

◆ Dispose()

void Fauna.Client.Dispose ( )

Disposes the resources used by the Client class.

Definition at line 92 of file Client.cs.

Member Data Documentation

◆ StatsCollector

readonly? IStatsCollector Fauna.Client.StatsCollector

Provides collection and aggregation of query statistics. Can be set to null in the Configuration.

Definition at line 34 of file Client.cs.

Property Documentation

◆ LastSeenTxn

long Fauna.Client.LastSeenTxn
get

Gets the timestamp of the last transaction seen by this client.

Definition at line 39 of file Client.cs.


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