org.ic4j.agent

Class UpdateBuilder

java.lang.Object

org.ic4j.agent.UpdateBuilder

public final class UpdateBuilder
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
UpdateBuilder	arg(byte[] arg)
java.util.concurrent.CompletableFuture<RequestId>	call()
java.util.concurrent.CompletableFuture<Response<RequestId>>	call(java.util.Map<java.lang.String,java.lang.String> headers)
java.util.concurrent.CompletableFuture<byte[]>	callAndWait(Waiter waiter)
static UpdateBuilder	create(Agent agent, org.ic4j.types.Principal canisterId, java.lang.String methodName)
UpdateBuilder	effectiveCanisterId(org.ic4j.types.Principal effectiveCanisterId)
UpdateBuilder	expireAfter(java.time.Duration duration) Takes a Duration (i.e.
UpdateBuilder	expireAt(java.time.LocalDateTime time) Takes a SystemTime converts it to a Duration by calling duration_since(UNIX_EPOCH) to learn about where in time this SystemTime lies.
java.util.concurrent.CompletableFuture<Response<byte[]>>	getState(RequestId requestId, java.util.Map<java.lang.String,java.lang.String> headers, boolean disableRangeCheck, Waiter waiter)
java.util.concurrent.CompletableFuture<Response<byte[]>>	getState(RequestId requestId, java.util.Map<java.lang.String,java.lang.String> headers, Waiter waiter)
java.util.concurrent.CompletableFuture<byte[]>	getState(RequestId requestId, Waiter waiter)
java.util.concurrent.CompletableFuture<byte[]>	getState(RequestId requestId, Waiter waiter, boolean disableRangeCheck)

Methods inherited from class java.lang.Object

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

Method Detail

create

public static UpdateBuilder create(Agent agent,
                                   org.ic4j.types.Principal canisterId,
                                   java.lang.String methodName)

effectiveCanisterId

public UpdateBuilder effectiveCanisterId(org.ic4j.types.Principal effectiveCanisterId)

arg

public UpdateBuilder arg(byte[] arg)

expireAt

public UpdateBuilder expireAt(java.time.LocalDateTime time)

Takes a SystemTime converts it to a Duration by calling duration_since(UNIX_EPOCH) to learn about where in time this SystemTime lies. The Duration is converted to nanoseconds and stored in ingressExpiryDatetime

expireAfter

public UpdateBuilder expireAfter(java.time.Duration duration)

Takes a Duration (i.e. 30 sec/5 min 30 sec/1 h 30 min, etc.) and adds it to the Duration of the current SystemTime since the UNIX_EPOCH Subtracts a permitted drift from the sum to account for using system time and not block time. Converts the difference to nanoseconds and stores in ingressExpiryDatetime

callAndWait

public java.util.concurrent.CompletableFuture<byte[]> callAndWait(Waiter waiter)
                                                           throws AgentError

Throws:

AgentError

call

public java.util.concurrent.CompletableFuture<RequestId> call()
                                                       throws AgentError

Throws:

AgentError

getState

public java.util.concurrent.CompletableFuture<byte[]> getState(RequestId requestId,
                                                               Waiter waiter)
                                                        throws AgentError

Throws:

AgentError

getState

public java.util.concurrent.CompletableFuture<byte[]> getState(RequestId requestId,
                                                               Waiter waiter,
                                                               boolean disableRangeCheck)
                                                        throws AgentError

Throws:

AgentError

call

public java.util.concurrent.CompletableFuture<Response<RequestId>> call(java.util.Map<java.lang.String,java.lang.String> headers)
                                                                 throws AgentError

Throws:

AgentError

getState

public java.util.concurrent.CompletableFuture<Response<byte[]>> getState(RequestId requestId,
                                                                         java.util.Map<java.lang.String,java.lang.String> headers,
                                                                         Waiter waiter)
                                                                  throws AgentError

Throws:

AgentError

getState

public java.util.concurrent.CompletableFuture<Response<byte[]>> getState(RequestId requestId,
                                                                         java.util.Map<java.lang.String,java.lang.String> headers,
                                                                         boolean disableRangeCheck,
                                                                         Waiter waiter)
                                                                  throws AgentError

Throws:

AgentError