Class StitchAppClientImpl
- java.lang.Object
-
- com.mongodb.stitch.server.core.internal.StitchAppClientImpl
-
- All Implemented Interfaces:
AuthMonitor
,StitchAppClient
,Closeable
,AutoCloseable
public final class StitchAppClientImpl extends Object implements StitchAppClient, AuthMonitor
-
-
Constructor Summary
Constructors Constructor Description StitchAppClientImpl(String clientAppId, StitchAppClientConfiguration config)
Constructs an app client with the given configuration.
-
Method Summary
Modifier and Type Method Description void
callFunction(String name, List<?> args)
Calls the specified Stitch function.<ResultT> ResultT
callFunction(String name, List<?> args, Class<ResultT> resultClass)
Calls the specified Stitch function, and decodes the response into an instance of the specified type.<ResultT> ResultT
callFunction(String name, List<?> args, Class<ResultT> resultClass, CodecRegistry codecRegistry)
Calls the specified Stitch function, and decodes the response into an instance of the specified type.void
callFunction(String name, List<?> args, Long requestTimeout)
Calls the specified Stitch function.<ResultT> ResultT
callFunction(String name, List<?> args, Long requestTimeout, Class<ResultT> resultClass)
Calls the specified Stitch function, and decodes the response into an instance of the specified type.<ResultT> ResultT
callFunction(String name, List<?> args, Long requestTimeout, Class<ResultT> resultClass, CodecRegistry codecRegistry)
Calls the specified Stitch function, and decodes the response into an instance of the specified type.<ResultT> ResultT
callFunction(String name, List<?> args, Long requestTimeout, Decoder<ResultT> resultDecoder)
<ResultT> ResultT
callFunction(String name, List<?> args, Decoder<ResultT> resultDecoder)
void
close()
Closes the client and shuts down all background operations.String
getActiveUserId()
Get the active user id from the applications auth request client.StitchAuth
getAuth()
Gets the authentication component of the app.<T> T
getServiceClient(NamedServiceClientFactory<T> factory, String serviceName)
Gets a client for the given named service.<T> T
getServiceClient(ServiceClientFactory<T> factory)
Gets a client for the given service.StitchServiceClient
getServiceClient(String serviceName)
Gets a general purpose client for the given named service.boolean
isLoggedIn()
Get whether or not the application client is currently logged in.boolean
tryIsLoggedIn()
Get whether or not the application client is currently logged in.
-
-
-
Constructor Detail
-
StitchAppClientImpl
public StitchAppClientImpl(String clientAppId, StitchAppClientConfiguration config)
Constructs an app client with the given configuration.- Parameters:
clientAppId
- the client app id for the app.config
- the configuration to use for the app client.
-
-
Method Detail
-
getAuth
public StitchAuth getAuth()
Description copied from interface:StitchAppClient
Gets the authentication component of the app. This is used for logging in and managing users.- Specified by:
getAuth
in interfaceStitchAppClient
- Returns:
- the authentication component of the app.
-
getServiceClient
public <T> T getServiceClient(NamedServiceClientFactory<T> factory, String serviceName)
Description copied from interface:StitchAppClient
Gets a client for the given named service.- Specified by:
getServiceClient
in interfaceStitchAppClient
- Type Parameters:
T
- the type of client to be returned by the factory.- Parameters:
factory
- the factory that will create a client for the service.serviceName
- the name of the service.- Returns:
- A client to interact with the service.
-
getServiceClient
public <T> T getServiceClient(ServiceClientFactory<T> factory)
Description copied from interface:StitchAppClient
Gets a client for the given service. Only some services offer a factory that requires no service name.- Specified by:
getServiceClient
in interfaceStitchAppClient
- Type Parameters:
T
- the type of client to be returned by the factory.- Parameters:
factory
- the factory that will create a client for the service.- Returns:
- A client to interact with the service.
-
getServiceClient
public StitchServiceClient getServiceClient(String serviceName)
Description copied from interface:StitchAppClient
Gets a general purpose client for the given named service.- Specified by:
getServiceClient
in interfaceStitchAppClient
- Parameters:
serviceName
- the name of the service.- Returns:
- a client to interact with the service.
-
callFunction
public void callFunction(String name, List<?> args)
Description copied from interface:StitchAppClient
Calls the specified Stitch function.- Specified by:
callFunction
in interfaceStitchAppClient
- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.
-
callFunction
public void callFunction(String name, List<?> args, Long requestTimeout)
Description copied from interface:StitchAppClient
Calls the specified Stitch function. Also accepts a timeout in milliseconds. Use this for functions that may run longer than the client-wide default timeout (15 seconds by default).- Specified by:
callFunction
in interfaceStitchAppClient
- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.requestTimeout
- the number of milliseconds the client should wait for a response from the server before failing with an error.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Class<ResultT> resultClass)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into an instance of the specified type. The response will be decoded using the codec registry specified when the client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the Stitch response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.resultClass
- the class that the response should be decoded as.- Returns:
- the decoded value.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Long requestTimeout, Class<ResultT> resultClass)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into an instance of the specified type. The response will be decoded using the codec registry specified when the client was configured. If no codec registry was configured, a default codec registry will be used. The default codec registry supports the mappings specified here Also accepts a timeout in milliseconds. Use this for functions that may run longer than the client-wide default timeout (15 seconds by default).- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the Stitch response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.requestTimeout
- the number of milliseconds the client should wait for a response from the server before failing with an error.resultClass
- the class that the response should be decoded as.- Returns:
- the decoded value.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Class<ResultT> resultClass, CodecRegistry codecRegistry)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into an instance of the specified type. The response will be decoded using the codec registry given.- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the Stitch response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.resultClass
- the class that the response should be decoded as.codecRegistry
- the codec registry used for de/serialization of the function call.- Returns:
- the decoded value.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Long requestTimeout, Class<ResultT> resultClass, CodecRegistry codecRegistry)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into an instance of the specified type. The response will be decoded using the codec registry given. Also accepts a timeout in milliseconds. Use this for functions that may run longer than the client-wide default timeout (15 seconds by default).- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the Stitch response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.requestTimeout
- the number of milliseconds the client should wait for a response from the server before failing with an error.resultClass
- the class that the response should be decoded as.codecRegistry
- the codec registry used for de/serialization of the function call.- Returns:
- the decoded value.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Decoder<ResultT> resultDecoder)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into a value using the providedDecoder
orCodec
.- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.resultDecoder
- theDecoder
orCodec
to use to decode the response into a value.- Returns:
- the decoded value.
-
callFunction
public <ResultT> ResultT callFunction(String name, List<?> args, Long requestTimeout, Decoder<ResultT> resultDecoder)
Description copied from interface:StitchAppClient
Calls the specified Stitch function, and decodes the response into a value using the providedDecoder
orCodec
. Also accepts a timeout in milliseconds. Use this for functions that may run longer than the client-wide default timeout (15 seconds by default).- Specified by:
callFunction
in interfaceStitchAppClient
- Type Parameters:
ResultT
- the type into which the response will be decoded.- Parameters:
name
- the name of the Stitch function to call.args
- the arguments to pass to the function.requestTimeout
- the number of milliseconds the client should wait for a response from the server before failing with an error.resultDecoder
- theDecoder
orCodec
to use to decode the response into a value.- Returns:
- the decoded value.
-
isLoggedIn
public boolean isLoggedIn() throws InterruptedException
Description copied from interface:AuthMonitor
Get whether or not the application client is currently logged in.- Specified by:
isLoggedIn
in interfaceAuthMonitor
- Returns:
- whether or not the application client is logged in
- Throws:
InterruptedException
- will throw interruptibly
-
tryIsLoggedIn
public boolean tryIsLoggedIn()
Description copied from interface:AuthMonitor
Get whether or not the application client is currently logged in.- Specified by:
tryIsLoggedIn
in interfaceAuthMonitor
- Returns:
- whether or not the application client is logged in, or false if the thread was interrupted
-
getActiveUserId
@Nullable public String getActiveUserId()
Description copied from interface:AuthMonitor
Get the active user id from the applications auth request client.- Specified by:
getActiveUserId
in interfaceAuthMonitor
- Returns:
- active user id if there is one, null if not
-
close
public void close() throws IOException
Closes the client and shuts down all background operations.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceStitchAppClient
- Throws:
IOException
- if any thread shutdown errors happen.
-
-