CloudTableClient Clase

Paquete:

com.microsoft.azure.storage.table

• java.lang.Object
• • ServiceClient
  • • com.microsoft.azure.storage.table.CloudTableClient

public class CloudTableClient extends ServiceClient

Proporciona un cliente de servicio para acceder a Microsoft Azure Table service.

La CloudTableClient clase encapsula el URI base para el punto de conexión de Table service y las credenciales para acceder a la cuenta de almacenamiento, y proporciona métodos para crear, eliminar, enumerar y consultar tablas, así como métodos para ejecutar operaciones y consultas en entidades de tabla. Estos métodos invocan las operaciones de la API REST del servicio de almacenamiento para realizar las solicitudes y obtener los resultados que se devuelven.

Un punto de conexión de Table service es el URI base para los recursos de Table service, incluido el nombre DNS de la cuenta de almacenamiento:

Para obtener más información, consulte el tema de MSDN Direccionamiento de recursos de Table Service.

Las credenciales pueden ser una combinación del nombre de la cuenta de almacenamiento y una clave, o una firma de acceso compartido. Para obtener más información, consulte el tema de MSDN Autenticación del acceso a la cuenta de almacenamiento.

Resumen del constructor

Constructor	Description
CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)	Inicializa una instancia de la clase mediante un punto de conexión de Table service y las credenciales de la cuenta de almacenamiento.
CloudTableClient(final URI baseUri, StorageCredentials credentials)	Inicializa una instancia de la clase mediante un punto de conexión de Table service y las credenciales de la cuenta de almacenamiento.

Resumen del método

Modificador y tipo	Método y descripción
final ServiceProperties	downloadServiceProperties() Recupera el actual ServiceProperties para el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.
final ServiceProperties	downloadServiceProperties(TableRequestOptions options, OperationContext opContext) Recupera el actual ServiceProperties para el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.
<T extends TableEntity, R> ResultSegment<?>	executeQuerySegmentedImpl(final TableQuery<T> queryToExecute, final EntityResolver<R> resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Ejecuta una operación de consulta segmentada mediante las directivas de reintento y tiempo de espera especificados.
<T extends TableEntity, R> Iterable<?>	generateIteratorForQuery(final TableQuery<T> queryRef, final EntityResolver<R> resolver, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Genera un iterador para una operación de consulta segmentada.
TableRequestOptions	getDefaultRequestOptions() Obtiene el TableRequestOptions objeto que se usa para las solicitudes asociadas a este objeto.
ServiceStats	getServiceStats() Consulta el servicio para .ServiceStats
ServiceStats	getServiceStats(TableRequestOptions options, OperationContext opContext) Consulta el servicio de almacenamiento especificado para .ServiceStats
CloudTable	getTableReference(final String tableName) Obtiene un CloudTable objeto con el nombre especificado.
final StorageUri	getTransformedEndPoint(final OperationContext opContext)
boolean	isUsePathStyleUris() Indica si se usan URI de estilo de ruta de acceso.
Iterable<String>	listTables() Enumera los nombres de tabla de la cuenta de almacenamiento. Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.
Iterable<String>	listTables(final String prefix) Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado. Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.
Iterable<String>	listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext) Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado, mediante el especificado TableRequestOptions y OperationContext. Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia. TableRequestOptions Use para invalidar las opciones de ejecución, como el tiempo de espera o la directiva de reintento para la operación.
ResultSegment<String>	listTablesSegmented() Enumera los nombres de tabla de la cuenta de almacenamiento en modo segmentado. Este método permite reanudar la lista de tablas después de devolver un conjunto parcial de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto . Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.
ResultSegment<String>	listTablesSegmented(final String prefix) Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado en modo segmentado. Este método permite reanudar la lista de tablas después de devolver un conjunto parcial de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto . Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.
ResultSegment<String>	listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) Enumera hasta el máximo especificado de los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado en un modo reanudable con el token de continuación especificado ResultContinuation , mediante el especificado TableRequestOptions y OperationContext. Este método permite reanudar la lista de tablas después de devolver una página de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto . Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia. TableRequestOptions Use para invalidar las opciones de ejecución, como el tiempo de espera o la directiva de reintento para la operación.
void	setDefaultRequestOptions(TableRequestOptions defaultRequestOptions) Establece el TableRequestOptions objeto que se usa para cualquier tabla a la que se tiene acceso con este objeto.
void	uploadServiceProperties(final ServiceProperties properties) Carga una nueva ServiceProperties configuración en el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.
void	uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext) Carga una nueva ServiceProperties configuración en el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.

Miembros heredados

ServiceClient.credentials ServiceClient.downloadServicePropertiesImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getCredentials() ServiceClient.getEndpoint() ServiceClient.getServiceStatsImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getStorageUri() ServiceClient.ServiceClient(final StorageUri storageUri, final StorageCredentials credentials) ServiceClient.setCredentials(final StorageCredentials credentials) ServiceClient.setStorageUri(final StorageUri storageUri) ServiceClient.uploadServicePropertiesImpl(final ServiceProperties properties, final RequestOptions options, final OperationContext opContext, final boolean signAsTable)

Detalles del constructor

CloudTableClient

public CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)

Inicializa una instancia de la clase mediante un punto de conexión de Table service y las credenciales de la cuenta de almacenamiento.

Parameters:

baseUri - Objeto StorageUri que representa el punto de conexión de Table service utilizado para inicializar el cliente.

credentials - Objeto StorageCredentials que representa las credenciales de la cuenta de almacenamiento para el acceso.

CloudTableClient

public CloudTableClient(final URI baseUri, StorageCredentials credentials)

Inicializa una instancia de la clase mediante un punto de conexión de Table service y las credenciales de la cuenta de almacenamiento.

Parameters:

baseUri - Objeto java.net.URI que representa el punto de conexión de Table service utilizado para inicializar el cliente.

credentials - Objeto StorageCredentials que representa las credenciales de la cuenta de almacenamiento para el acceso.

Detalles del método

downloadServiceProperties

public final ServiceProperties downloadServiceProperties()

Recupera el actual ServiceProperties para el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.

Returns:

objeto ServiceProperties que representa la configuración actual del servicio.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

downloadServiceProperties

public final ServiceProperties downloadServiceProperties(TableRequestOptions options, OperationContext opContext)

Recupera el actual ServiceProperties para el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.

Parameters:

options - Objeto BlobRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null , se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudBlobClient).

opContext - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Returns:

objeto ServiceProperties que representa la configuración actual del servicio.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

executeQuerySegmentedImpl

protected ResultSegment executeQuerySegmentedImpl(final TableQuery queryToExecute, final EntityResolver resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext)

Reservado para uso interno. Ejecuta una operación de consulta segmentada mediante las directivas de reintento y tiempo de espera especificados.

Parameters:

queryToExecute - Objeto TableQuery<T> que se va a ejecutar.

resolver - Instancia de EntityResolver<T> que crea una proyección de las entidades de resultado de la consulta de tabla en el tipo R especificado. Pase null para devolver los resultados como el tipo de entidad de tabla.

continuationToken - que ResultContinuation se va a pasar con la operación para reanudar una consulta, si existe. Pase null para una consulta inicial.

options - Objeto TableRequestOptions que especifica opciones de ejecución, como la directiva de reintento y la configuración de tiempo de espera de la operación. Especifique null para usar las opciones de solicitud especificadas en .CloudTableClient

opContext - Un objeto OperationContext para realizar un seguimiento de la operación actual. Especifique null para pasar por alto el contexto de la operación de forma segura.

Returns:

que ResultSegment<T> contiene una colección de los resultados de la consulta especializados para el TableEntity tipo o EntityResolver<T> devuelto por la consulta.

Throws:

StorageException - si se produce un error de servicio de almacenamiento.

generateIteratorForQuery

protected Iterable generateIteratorForQuery(final TableQuery queryRef, final EntityResolver resolver, TableRequestOptions options, OperationContext opContext)

Reservado para uso interno. Genera un iterador para una operación de consulta segmentada.

Parameters:

queryRef - Objeto TableQuery<T> que se va a ejecutar.

resolver - Instancia de EntityResolver<T> que crea una proyección de las entidades de resultado de la consulta de tabla en el tipo R especificado. Pase null para devolver los resultados como el tipo de entidad de tabla.

options - Objeto TableRequestOptions que especifica opciones de ejecución, como la directiva de reintento y la configuración de tiempo de espera de la operación. Especifique null para usar las opciones de solicitud especificadas en .CloudTableClient

opContext - Un objeto OperationContext para realizar un seguimiento de la operación actual. Especifique null para pasar por alto el contexto de la operación de forma segura.

Returns:

Instancia de Iterable especializada para el TableEntity tipo o EntityResolver<T> devuelto por la consulta.

getDefaultRequestOptions

public TableRequestOptions getDefaultRequestOptions()

Obtiene el TableRequestOptions objeto que se usa para las solicitudes asociadas a este objeto.

Returns:

Objeto TableRequestOptions que contiene los valores usados por este objeto. CloudTableClient

getServiceStats

public ServiceStats getServiceStats()

Consulta el servicio para .ServiceStats

Returns:

ServiceStats para el servicio de almacenamiento determinado

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

getServiceStats

public ServiceStats getServiceStats(TableRequestOptions options, OperationContext opContext)

Consulta el servicio de almacenamiento especificado para .ServiceStats

Parameters:

options - Objeto BlobRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null , se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudBlobClient).

opContext - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Returns:

ServiceStats para el servicio de almacenamiento determinado

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

getTableReference

public CloudTable getTableReference(final String tableName)

Obtiene un CloudTable objeto con el nombre especificado.

Parameters:

tableName - que String representa el nombre de la tabla, que debe cumplir las reglas de nomenclatura de tablas. El nombre de la tabla no debe incluir ningún carácter separador de ruta de acceso (/). Los nombres de tabla no distinguen mayúsculas de minúsculas, deben ser únicos dentro de una cuenta y deben tener entre 3 y 63 caracteres de longitud. Los nombres de tabla deben comenzar con un no puede comenzar con un carácter numérico y solo pueden contener caracteres alfanuméricos. Algunos nombres de tabla están reservados, incluida la "tabla".

Returns:

Referencia a un objeto CloudTable.

Throws:

URISyntaxException - Si el URI del recurso construido basado en tableName no es válido.

StorageException - Si se produjo un error en el servicio de almacenamiento.

getTransformedEndPoint

protected final StorageUri getTransformedEndPoint(final OperationContext opContext)

Parameters:

opContext

isUsePathStyleUris

protected boolean isUsePathStyleUris()

Indica si se usan URI de estilo de ruta de acceso.

Returns:

true si se usan URI de estilo ruta de acceso; de lo contrario false, .

listTables

public Iterable listTables()

Enumera los nombres de tabla de la cuenta de almacenamiento.

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

Returns:

Colección Iterable de los nombres de tabla de la cuenta de almacenamiento recuperada de forma diferida.

listTables

public Iterable listTables(final String prefix)

Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado.

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

Parameters:

prefix - que String contiene el prefijo que se va a buscar en los nombres de tabla que se van a devolver.

Returns:

Colección Iterable de los nombres de tabla de la cuenta de almacenamiento recuperadas de forma diferida que coinciden con el prefijo especificado.

listTables

public Iterable listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext)

Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado, mediante el especificado TableRequestOptions y OperationContext.

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

TableRequestOptions Use para invalidar las opciones de ejecución, como el tiempo de espera o la directiva de reintento para la operación.

Parameters:

prefix - que String contiene el prefijo que se va a buscar en los nombres de tabla que se van a devolver.

options - Objeto TableRequestOptions que especifica opciones de ejecución, como la directiva de reintento y la configuración de tiempo de espera de la operación. Especifique null para usar las opciones de solicitud especificadas en .CloudTableClient

opContext - Un objeto OperationContext para realizar un seguimiento de la operación actual. Especifique null para pasar por alto el contexto de la operación de forma segura.

Returns:

Colección Iterable de los nombres de tabla de la cuenta de almacenamiento recuperadas de forma diferida que coinciden con el prefijo especificado.

listTablesSegmented

public ResultSegment listTablesSegmented()

Enumera los nombres de tabla de la cuenta de almacenamiento en modo segmentado. Este método permite reanudar la lista de tablas después de devolver un conjunto parcial de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto .

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

Returns:

de ResultSegment<T> objetos que contienen nombres de String tabla en la cuenta de almacenamiento.

Throws:

StorageException - si se produjo un error del servicio de almacenamiento durante la operación.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix)

Enumera los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado en modo segmentado. Este método permite reanudar la lista de tablas después de devolver un conjunto parcial de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto .

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

Parameters:

prefix - que String contiene el prefijo que se va a buscar en los nombres de tabla que se van a devolver.

Returns:

de ResultSegment<T> objetos que contienen nombres de String tabla que coinciden con el prefijo de la cuenta de almacenamiento.

Throws:

StorageException - si se produjo un error del servicio de almacenamiento durante la operación.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

Enumera hasta el máximo especificado de los nombres de tabla de la cuenta de almacenamiento que coinciden con el prefijo especificado en un modo reanudable con el token de continuación especificado ResultContinuation , mediante el especificado TableRequestOptions y OperationContext. Este método permite reanudar la lista de tablas después de devolver una página de resultados, utilizando la información devuelta por el servidor en el ResultSegment<T> objeto .

Este método invoca la API DE REST De tablas de consulta para enumerar los nombres de tabla que coinciden con el prefijo, mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento de esta instancia.

TableRequestOptions Use para invalidar las opciones de ejecución, como el tiempo de espera o la directiva de reintento para la operación.

Parameters:

prefix - que String contiene el prefijo que se va a buscar en los nombres de tabla que se van a devolver.

maxResults - Número máximo de nombres de tabla que se van a devolver en .ResultSegment<T> Si este parámetro es null, la consulta mostrará hasta el máximo 1000 resultados.

continuationToken - Objeto ResultContinuation que representa un token de continuación desde el servidor cuando la operación devuelve un resultado parcial. Especifique null en la llamada inicial. Llame al getContinuationToken() método en el resultado para obtener el ResultContinuation objeto que se usará en la siguiente llamada para reanudar la consulta.

options - Objeto TableRequestOptions que especifica opciones de ejecución, como la directiva de reintento y la configuración de tiempo de espera de la operación. Especifique null para usar las opciones de solicitud especificadas en .CloudTableClient

opContext - Un objeto OperationContext para realizar un seguimiento de la operación actual. Especifique null para pasar por alto el contexto de la operación de forma segura.

Returns:

de ResultSegment<T> objetos que contienen nombres de String tabla en la cuenta de almacenamiento.

Throws:

StorageException - si se produjo un error del servicio de almacenamiento durante la operación.

setDefaultRequestOptions

public void setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)

Establece el TableRequestOptions objeto que se usa para cualquier tabla a la que se tiene acceso con este objeto.

Parameters:

defaultRequestOptions - TableRequestOptions que se va a usar.

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties)

Carga una nueva ServiceProperties configuración en el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.

Parameters:

properties - que ServiceProperties se va a cargar.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)

Carga una nueva ServiceProperties configuración en el servicio de almacenamiento determinado. Esto incluye las configuraciones registro, HourMetrics, MinuteMetrics y CORS.

Parameters:

properties - que ServiceProperties se va a cargar.

options - Objeto BlobRequestOptions que especifica las opciones adicionales de la solicitud. Al especificar null , se usarán las opciones de solicitud predeterminadas del cliente de servicio asociado ( CloudBlobClient).

opContext - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.