Module com.hedera.hashgraph.sdk

Package com.hedera.hashgraph.sdk

Class FileInfoQuery

java.lang.Object

com.hedera.hashgraph.sdk.Executable<FileInfoQuery,Query,Response,FileInfo>

com.hedera.hashgraph.sdk.Query<FileInfo,FileInfoQuery>

com.hedera.hashgraph.sdk.FileInfoQuery

public final class FileInfoQuery
extends Query<FileInfo,FileInfoQuery>

Get all of the information about a file, except for its contents.

When a file expires, it no longer exists, and there will be no info about it, and the fileInfo field will be blank.

If a transaction or smart contract deletes the file, but it has not yet expired, then the fileInfo field will be non-empty, the deleted field will be true, its size will be 0, and its contents will be empty. Note that each file has a FileID, but does not have a filename.

Nested Class Summary

Nested classes/interfaces inherited from class com.hedera.hashgraph.sdk.Executable

Executable.GrpcRequest

Field Summary

Fields inherited from class com.hedera.hashgraph.sdk.Query

paymentTransactionId, paymentTransactions

Fields inherited from class com.hedera.hashgraph.sdk.Executable

attemptedAllNodes, blockingUnaryCall, grpcDeadline, logger, maxAttempts, maxBackoff, minBackoff, nodeAccountIds, nodes, random, RST_STREAM

Constructor Summary

Constructors

Constructor	Description
FileInfoQuery()	Constructor.

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Hbar>	getCostAsync(Client client)	Fetch the expected cost asynchronously.
FileId	getFileId()	Extract the file id.
(package private) io.grpc.MethodDescriptor<Query,Response>	getMethodDescriptor()	Called to direct the invocation of the query to the appropriate gRPC service.
(package private) QueryHeader	mapRequestHeader(Query request)	The derived class should access its request header and return.
(package private) FileInfo	mapResponse(Response response, AccountId nodeId, Query request)	Called after receiving the query response from Hedera.
(package private) ResponseHeader	mapResponseHeader(Response response)	The derived class should access its response header and return.
(package private) void	onMakeRequest(Query.Builder queryBuilder, QueryHeader header)	Called in Query.makeRequest() just before the query is built.
FileInfoQuery	setFileId(FileId fileId)	Sets the file ID for which information is requested.
(package private) void	validateChecksums(Client client)	Validate the checksums.

Methods inherited from class com.hedera.hashgraph.sdk.Query

getCost, getCost, getCostAsync, getCostAsync, getCostAsync, getCostAsync, getCostAsync, getOperatorFromClient, getPaymentTransaction, getPaymentTransactionId, getTransactionIdInternal, isPaymentRequired, makeRequest, mapResponseStatus, onExecute, onExecuteAsync, setMaxQueryPayment, setPaymentTransactionId, setQueryPayment, toString

Methods inherited from class com.hedera.hashgraph.sdk.Executable

advanceRequest, checkNodeAccountIds, execute, execute, executeAsync, executeAsync, executeAsync, executeAsync, executeAsync, executeAsync, getExecutionState, getGrpcRequest, getMaxAttempts, getMaxBackoff, getMaxRetry, getMinBackoff, getNodeAccountIds, getNodeForExecute, grpcDeadline, isBatchedAndNotBatchTransaction, logTransaction, mergeFromClient, setGrpcDeadline, setLogger, setMaxAttempts, setMaxBackoff, setMaxRetry, setMinBackoff, setNodeAccountIds, setNodesFromNodeAccountIds, setRequestListener, setResponseListener, shouldRetryExceptionally

Methods inherited from class java.lang.Object

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

Constructor Details

FileInfoQuery

public FileInfoQuery()

Constructor.

Method Details

getFileId

@Nullable
public FileId getFileId()

Extract the file id.

Returns:

the file id

setFileId

public FileInfoQuery setFileId(FileId fileId)

Sets the file ID for which information is requested.

Parameters:

fileId - The FileId to be set

Returns:

this

validateChecksums

void validateChecksums(Client client)
                throws BadEntityIdException

Description copied from class: Query

Validate the checksums.

Specified by:

validateChecksums in class Query<FileInfo,FileInfoQuery>

Throws:

BadEntityIdException

onMakeRequest

void onMakeRequest(Query.Builder queryBuilder,
 QueryHeader header)

Description copied from class: Query

Called in Query.makeRequest() just before the query is built. The intent is for the derived class to assign their data variant to the query.

Specified by:

onMakeRequest in class Query<FileInfo,FileInfoQuery>

mapResponseHeader

ResponseHeader mapResponseHeader(Response response)

Description copied from class: Query

The derived class should access its response header and return.

Specified by:

mapResponseHeader in class Query<FileInfo,FileInfoQuery>

mapRequestHeader

QueryHeader mapRequestHeader(Query request)

Description copied from class: Query

The derived class should access its request header and return.

Specified by:

mapRequestHeader in class Query<FileInfo,FileInfoQuery>

mapResponse

FileInfo mapResponse(Response response,
 AccountId nodeId,
 Query request)

Description copied from class: Executable

Called after receiving the query response from Hedera. The derived class should map into its output type.

Specified by:

mapResponse in class Executable<FileInfoQuery,Query,Response,FileInfo>

getMethodDescriptor

io.grpc.MethodDescriptor<Query,Response> getMethodDescriptor()

Description copied from class: Executable

Called to direct the invocation of the query to the appropriate gRPC service.

Specified by:

getMethodDescriptor in class Executable<FileInfoQuery,Query,Response,FileInfo>

getCostAsync

public CompletableFuture<Hbar> getCostAsync(Client client)

Description copied from class: Query

Fetch the expected cost asynchronously.

Overrides:

getCostAsync in class Query<FileInfo,FileInfoQuery>

Parameters:

client - the client

Returns:

Future result of the cost in hbar