com.contentful.java.cma

Class ModuleApiKeys

java.lang.Object

com.contentful.java.cma.ModuleApiKeys

public class ModuleApiKeys
extends Object

Api Keys Module.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ModuleApiKeys.Async Async module.

Constructor Summary

Constructors

Constructor and Description
ModuleApiKeys(retrofit2.Retrofit retrofit, Executor callbackExecutor, String spaceId, String environmentId, boolean environmentIdConfigured) Create api keys module.

Method Summary

Modifier and Type	Method and Description
ModuleApiKeys.Async	async()
CMAApiKey	create(CMAApiKey key) Create a new delivery api key from the configured space.
CMAApiKey	create(String spaceId, CMAApiKey key) Create a new delivery api key.
protected com.contentful.java.cma.ServiceApiKeys	createService(retrofit2.Retrofit retrofit)
int	delete(CMAApiKey key) Delete a given api key from the configured space.
CMAArray<CMAApiKey>	fetchAll() Fetch all delivery API keys from the configured space.
CMAArray<CMAApiKey>	fetchAll(Map<String,String> query) Query for specific api keys from the configured space.
CMAArray<CMAApiKey>	fetchAll(String spaceId) Fetch all delivery api keys from the given space.
CMAArray<CMAApiKey>	fetchAll(String spaceId, Map<String,String> query) Query for specific api keys, overriding the configuration set.
CMAApiKey	fetchOne(String keyId) Fetch only one delivery api key from the configured space.
CMAApiKey	fetchOne(String spaceId, String keyId) Fetch only one delivery api key.
CMAApiKey	update(CMAApiKey key) Updates a delivery api key from the configured space.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ModuleApiKeys

public ModuleApiKeys(retrofit2.Retrofit retrofit,
                     Executor callbackExecutor,
                     String spaceId,
                     String environmentId,
                     boolean environmentIdConfigured)

Create api keys module.

Parameters:

retrofit - the retrofit instance to be used to create the service.

callbackExecutor - to tell on which thread it should run.

spaceId - the space to be used when not given.

environmentId - the environment to be used when not given.

environmentIdConfigured - internal helper to see if environment was set.

Method Detail

createService

protected com.contentful.java.cma.ServiceApiKeys createService(retrofit2.Retrofit retrofit)

fetchAll

public CMAArray<CMAApiKey> fetchAll()

Fetch all delivery API keys from the configured space.

Returns:

a list of delivery api keys.

Throws:

IllegalArgumentException - if configured space Id is null.

CMANotWithEnvironmentsException - if environmentId was set using CMAClient.Builder.setEnvironmentId(String).

See Also:

CMAClient.Builder.setSpaceId(String)

fetchAll

public CMAArray<CMAApiKey> fetchAll(String spaceId)

Fetch all delivery api keys from the given space.

This method will override the configuration specified through CMAClient.Builder.setSpaceId(String) and will ignore CMAClient.Builder.setEnvironmentId(String).

Parameters:

spaceId - the id of the space to host the api keys.

Returns:

a list of delivery api keys.

Throws:

IllegalArgumentException - if spaceId is null.

fetchAll

public CMAArray<CMAApiKey> fetchAll(Map<String,String> query)

Query for specific api keys from the configured space.

Parameters:

query - the terms to query for specific keys.

Returns:

a list of delivery api keys.

Throws:

IllegalArgumentException - if configured space Id is null.

CMANotWithEnvironmentsException - if environmentId was set using CMAClient.Builder.setEnvironmentId(String).

See Also:

CMAClient.Builder.setSpaceId(String)

fetchAll

public CMAArray<CMAApiKey> fetchAll(String spaceId,
                                    Map<String,String> query)

Query for specific api keys, overriding the configuration set.

This method will override the configuration specified through CMAClient.Builder.setSpaceId(String) and will ignore CMAClient.Builder.setEnvironmentId(String).

Parameters:

spaceId - the id of the space to host the api keys.

query - the terms to query for specific keys.

Returns:

a list of delivery api keys.

Throws:

IllegalArgumentException - if spaceId is null.

fetchOne

public CMAApiKey fetchOne(String keyId)

Fetch only one delivery api key from the configured space.

This method will override the configuration specified through CMAClient.Builder.setSpaceId(String) and will ignore CMAClient.Builder.setEnvironmentId(String).

Parameters:

keyId - the id of the key itself.

Returns:

one delivery api key.

Throws:

IllegalArgumentException - if configured spaceId is null.

IllegalArgumentException - if keyId is null.

CMANotWithEnvironmentsException - if environmentId was set using CMAClient.Builder.setEnvironmentId(String).

See Also:

CMAClient.Builder.setSpaceId(String)

fetchOne

public CMAApiKey fetchOne(String spaceId,
                          String keyId)

Fetch only one delivery api key.

This method will override the configuration specified through CMAClient.Builder.setSpaceId(String) and will ignore CMAClient.Builder.setEnvironmentId(String).

Parameters:

spaceId - the id of the space this is valid on.

keyId - the id of the key itself.

Returns:

one delivery api key.

Throws:

IllegalArgumentException - if spaceId is null.

IllegalArgumentException - if keyId is null.

create

public CMAApiKey create(CMAApiKey key)

Create a new delivery api key from the configured space.

This method will override the configuration specified through CMAClient.Builder.setSpaceId(String) and will ignore CMAClient.Builder.setEnvironmentId(String).

Parameters:

key - the key to be created.

Returns:

the just created key, containing the delivery token.

Throws:

IllegalArgumentException - if configured spaceId is null.

IllegalArgumentException - if key is null.

CMANotWithEnvironmentsException - if environmentId was set using CMAClient.Builder.setEnvironmentId(String).

See Also:

CMAClient.Builder.setSpaceId(String)

update

public CMAApiKey update(CMAApiKey key)

Updates a delivery api key from the configured space.

Parameters:

key - the key to be updated.

Returns:

the just updated key.

Throws:

IllegalArgumentException - if key is null.

IllegalArgumentException - if keys id is null.

IllegalArgumentException - if keys spaceId is null.

create

public CMAApiKey create(String spaceId,
                        CMAApiKey key)

Create a new delivery api key.

Parameters:

spaceId - the id of the space this is valid on.

key - the key to be created.

Returns:

the just created key, containing the delivery token.

Throws:

IllegalArgumentException - if spaceId is null.

IllegalArgumentException - if key is null.

delete

public int delete(CMAApiKey key)

Delete a given api key from the configured space.

Parameters:

key - the key to be deleted.

Returns:

204 upon success.

Throws:

IllegalArgumentException - if key is null.

IllegalArgumentException - if key's spaceId is null.

async

public ModuleApiKeys.Async async()

Returns:

a module with a set of asynchronous methods.