io.cdap.wrangler.clients

Class SchemaRegistryClient

java.lang.Object

io.cdap.wrangler.clients.SchemaRegistryClient

public final class SchemaRegistryClient
extends Object

This class SchemaRegistryClient is a client API for the SchemaRegistry service. Client allows only read-only access to service. It doesn't support the ability to mutate the service. Example usage of the client. ... SchemaRegistryClient client = new SchemaRegistryClient(); ... client.setAcceptEncoding("application/json"); client.setConnectionTimeout(2000); // 2 seconds of connect timeout. client.setReadTimeout(1000); // 1 second of read timeout. try { Response info = client.getSchema("test", 2); } catch (IOException e) { ... } catch (URIException e) { ... } catch (RestClientException e) { ... } ...

Constructor Summary

Constructors

Constructor and Description
SchemaRegistryClient(String baseUrl)

Method Summary

Modifier and Type	Method and Description
String	getAcceptEncoding()
String	getBaseUrl()
int	getConnectionTimeout()
static SchemaRegistryClient	getInstance(ExecutorContext context) Returns a instance of SchemaRegistryClient initialized with service url.
int	getReadTimeout()
byte[]	getSchema(String namespace, String id) Retrieves schema provided a schema id.
byte[]	getSchema(String namespace, String id, long version) Retrieves schema provided a schema id and version of the schema.
List<Long>	getVersions(String namespace, String id) Gets all the versions of schemas given a schema id.
void	setAcceptEncoding(String acceptEncoding)
void	setConnectionTimeout(int connectionTimeout) Sets the connection timeout in milliseconds.
void	setReadTimeout(int readTimeout) Sets the read timeout in milliseconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

SchemaRegistryClient

public SchemaRegistryClient(String baseUrl)

Method Detail

getInstance

public static SchemaRegistryClient getInstance(ExecutorContext context)

Returns a instance of SchemaRegistryClient initialized with service url.

Parameters:

context - of the pipeline in which this client is invoked.

Returns:

instance of this class.

getSchema

public byte[] getSchema(String namespace,
                        String id,
                        long version)
                 throws URISyntaxException,
                        IOException,
                        RestClientException

Retrieves schema provided a schema id and version of the schema.

Parameters:

namespace - the schema namespace

id - the schema id

version - the schema version

Returns:

Response of the schema.

Throws:

URISyntaxException - thrown if there are issue with construction of url.

IOException - throw when there are issues connecting to the service.

RestClientException - thrown when there are issues with request or response returned.

getSchema

public byte[] getSchema(String namespace,
                        String id)
                 throws URISyntaxException,
                        IOException,
                        RestClientException

Retrieves schema provided a schema id. It provides the latest, current version of schema.

Parameters:

namespace - the schema namespace

id - the schema id

Returns:

SchemaInfo of the schema if ok, else null.

Throws:

URISyntaxException - thrown if there are issue with construction of url.

IOException - throw when there are issues connecting to the service.

RestClientException - thrown when there are issues with request or response returned.

getVersions

public List<Long> getVersions(String namespace,
                              String id)
                       throws URISyntaxException,
                              IOException,
                              RestClientException

Gets all the versions of schemas given a schema id.

Parameters:

namespace - the schema namespace

id - the schema id

Returns:

a list of schema versions.

Throws:

URISyntaxException - thrown if there are issue with construction of url.

IOException - throw when there are issues connecting to the service.

RestClientException - thrown when there are issues with request or response returned.

getBaseUrl

public String getBaseUrl()

Returns:

the base url set for this client.

getAcceptEncoding

public String getAcceptEncoding()

Returns:

Accept encoding currently setup for the client.

setAcceptEncoding

public void setAcceptEncoding(String acceptEncoding)

Parameters:

acceptEncoding - sets the accept encoding for the client.

getConnectionTimeout

public int getConnectionTimeout()

Returns:

the timeout set for connection in milliseconds.

setConnectionTimeout

public void setConnectionTimeout(int connectionTimeout)

Sets the connection timeout in milliseconds.

Parameters:

connectionTimeout - specified in milliseconds.

getReadTimeout

public int getReadTimeout()

Returns:

the read timeout in milliseconds.

setReadTimeout

public void setReadTimeout(int readTimeout)

Sets the read timeout in milliseconds.

Parameters:

readTimeout -