Package ca.uhn.fhir.rest.api.server.storage

Class TransactionDetails

java.lang.Object
ca.uhn.fhir.rest.api.server.storage.TransactionDetails
public class TransactionDetails extends Object
This object contains runtime information that is gathered and relevant to a single database transaction. This doesn't mean a FHIR transaction necessarily, but rather any operation that happens within a single DB transaction (i.e. a FHIR create, read, transaction, etc.).

The intent with this class is to hold things we want to pass from operation to operation within a transaction in order to avoid looking things up multiple times, etc.

Since:
5.0.0

  • Field Details

  • Constructor Details

  • Method Details

    • getRollbackUndoActions

      public List<Runnable> getRollbackUndoActions()
      Get the actions that should be executed if the transaction is rolled back
      Since:
      5.5.0

    • addRollbackUndoAction

      public void addRollbackUndoAction(@Nonnull Runnable theRunnable)
      Add an action that should be executed if the transaction is rolled back. If a rollback is triggered, the actions will be executed in reverse order in order to leave .
      Since:
      5.5.0

    • clearRollbackUndoActions

      public void clearRollbackUndoActions()
      Clears any previously added rollback actions
      Since:
      5.5.0

    • addUpdatedResourceId

      public void addUpdatedResourceId(@Nonnull IResourcePersistentId theResourceId)
      Since:
      7.6.0

    • addUpdatedResourceIds

      public void addUpdatedResourceIds(Collection<? extends IResourcePersistentId> theResourceIds)
      Since:
      7.6.0

    • getUpdatedResourceIds

      public Set<IResourcePersistentId> getUpdatedResourceIds()
      Since:
      7.6.0

    • addDeletedResourceId

      public void addDeletedResourceId(@Nonnull IResourcePersistentId theResourceId)
      Since:
      6.8.0

    • addDeletedResourceIds

      public void addDeletedResourceIds(Collection<? extends IResourcePersistentId> theResourceIds)
      Since:
      6.8.0

    • getDeletedResourceIds

      @Nonnull public Set<IResourcePersistentId> getDeletedResourceIds()
      Since:
      6.8.0

    • addResolvedPartition

      public void addResolvedPartition(String theId, ca.uhn.fhir.interceptor.model.RequestPartitionId thePartitionId)
      If a resource has been resolved within the current transaction to a specific partition, we cache it here to avoid repeated lookups.

    • getResolvedPartition

      public ca.uhn.fhir.interceptor.model.RequestPartitionId getResolvedPartition(String theId)
      If a resource has been resolved within the current transaction to a specific partition, we cache it here to avoid repeated lookups.

    • getResolvedResourceId

      @Nullable public IResourcePersistentId getResolvedResourceId(org.hl7.fhir.instance.model.api.IIdType theId)
      A Resolved Resource ID is a mapping between a resource ID (e.g. "Patient/ABC" or "Observation/123") and a storage ID for that resource. Resources should only be placed within the TransactionDetails if they are known to exist and be valid targets for other resources to link to.

    • getResolvedResource

      @Nullable public org.hl7.fhir.instance.model.api.IBaseResource getResolvedResource(org.hl7.fhir.instance.model.api.IIdType theId)
      A Resolved Resource ID is a mapping between a resource ID (e.g. "Patient/ABC" or "Observation/123") and the actual persisted/resolved resource with this ID.

    • isResolvedResourceIdEmpty

      public boolean isResolvedResourceIdEmpty(org.hl7.fhir.instance.model.api.IIdType theId)
      Was the given resource ID resolved previously in this transaction as not existing

    • hasResolvedResourceId

      public boolean hasResolvedResourceId(org.hl7.fhir.instance.model.api.IIdType theId)
      Was the given resource ID resolved previously in this transaction

    • hasNullResolvedResourceId

      public boolean hasNullResolvedResourceId(org.hl7.fhir.instance.model.api.IIdType theId)
      Returns true if the given ID was marked as not existing (i.e. someone called addResolvedResourceId(IIdType, IResourcePersistentId) with an ID of null).
      Parameters:
      theId - The resource ID
      Since:
      8.0.0

    • addResolvedResourceId

      public void addResolvedResourceId(org.hl7.fhir.instance.model.api.IIdType theResourceId, @Nullable IResourcePersistentId thePersistentId)
      A Resolved Resource ID is a mapping between a resource ID (e.g. "Patient/ABC" or "Observation/123") and a storage ID for that resource. Resources should only be placed within the TransactionDetails if they are known to exist and be valid targets for other resources to link to.

    • addResolvedResource

      public void addResolvedResource(org.hl7.fhir.instance.model.api.IIdType theResourceId, @Nonnull Supplier<org.hl7.fhir.instance.model.api.IBaseResource> theResource)
      A Resolved Resource ID is a mapping between a resource ID (e.g. "Patient/ABC" or "Observation/123") and the actual persisted/resolved resource. This version takes a Supplier which will only be fetched if the resource is actually needed. This is good in cases where the resource is lazy loaded.

    • addResolvedResource

      public void addResolvedResource(org.hl7.fhir.instance.model.api.IIdType theResourceId, @Nonnull org.hl7.fhir.instance.model.api.IBaseResource theResource)
      A Resolved Resource ID is a mapping between a resource ID (e.g. "Patient/ABC" or "Observation/123") and the actual persisted/resolved resource.

    • getResolvedMatchUrls

      public Map<String,IResourcePersistentId> getResolvedMatchUrls()

    • addResolvedMatchUrl

      public void addResolvedMatchUrl(ca.uhn.fhir.context.FhirContext theFhirContext, String theConditionalUrl, @Nonnull IResourcePersistentId<?> thePersistentId)
      A Resolved Conditional URL is a mapping between a conditional URL (e.g. "Patient?identifier=foo|bar" or "Observation/123") and a storage ID for that resource. Resources should only be placed within the TransactionDetails if they are known to exist and be valid targets for other resources to link to.

    • removeResolvedMatchUrl

      public void removeResolvedMatchUrl(String theMatchUrl)
      Since:
      6.8.0
      See Also:

    • getTransactionDate

      public Date getTransactionDate()
      This is the wall-clock time that a given transaction started.

    • clearUserData

      public void clearUserData(String theKey)
      Remove an item previously stored in user data
      See Also:

    • putUserData

      public void putUserData(String theKey, Object theValue)
      Sets an arbitrary object that will last the lifetime of the current transaction
      See Also:

    • getUserData

      public <T> T getUserData(String theKey)
      Gets an arbitrary object that will last the lifetime of the current transaction
      See Also:

    • getOrCreateUserData

      public <T> T getOrCreateUserData(String theKey, Supplier<T> theSupplier)
      Fetches the existing value in the user data map, or uses theSupplier to create a new object and puts that in the map, and returns it

    • beginAcceptingDeferredInterceptorBroadcasts

      public void beginAcceptingDeferredInterceptorBroadcasts(ca.uhn.fhir.interceptor.api.Pointcut... thePointcuts)
      This can be used by processors for FHIR transactions to defer interceptor broadcasts on sub-requests if needed
      Since:
      5.2.0

    • isAcceptingDeferredInterceptorBroadcasts

      public boolean isAcceptingDeferredInterceptorBroadcasts()
      This can be used by processors for FHIR transactions to defer interceptor broadcasts on sub-requests if needed
      Since:
      5.2.0

    • isAcceptingDeferredInterceptorBroadcasts

      public boolean isAcceptingDeferredInterceptorBroadcasts(ca.uhn.fhir.interceptor.api.Pointcut thePointcut)
      This can be used by processors for FHIR transactions to defer interceptor broadcasts on sub-requests if needed
      Since:
      5.2.0

    • endAcceptingDeferredInterceptorBroadcasts

      public com.google.common.collect.ListMultimap<ca.uhn.fhir.interceptor.api.Pointcut,ca.uhn.fhir.interceptor.api.HookParams> endAcceptingDeferredInterceptorBroadcasts()
      This can be used by processors for FHIR transactions to defer interceptor broadcasts on sub-requests if needed
      Since:
      5.2.0

    • addDeferredInterceptorBroadcast

      public void addDeferredInterceptorBroadcast(ca.uhn.fhir.interceptor.api.Pointcut thePointcut, ca.uhn.fhir.interceptor.api.HookParams theHookParams)
      This can be used by processors for FHIR transactions to defer interceptor broadcasts on sub-requests if needed
      Since:
      5.2.0

    • getInvocationTiming

      public ca.uhn.fhir.rest.api.InterceptorInvocationTimingEnum getInvocationTiming(ca.uhn.fhir.interceptor.api.Pointcut thePointcut)

    • deferredBroadcastProcessingFinished

      public void deferredBroadcastProcessingFinished()

    • clearResolvedItems

      public void clearResolvedItems()

    • hasResolvedResourceIds

      public boolean hasResolvedResourceIds()

    • isFhirTransaction

      public boolean isFhirTransaction()

    • setFhirTransaction

      public void setFhirTransaction(boolean theFhirTransaction)

    • addAutoCreatedPlaceholderResource

      public void addAutoCreatedPlaceholderResource(org.hl7.fhir.instance.model.api.IIdType theResource)

    • getAutoCreatedPlaceholderResourcesAndClear

      @Nonnull public List<org.hl7.fhir.instance.model.api.IIdType> getAutoCreatedPlaceholderResourcesAndClear()

    • getReverseResolvedId

      public <T extends IResourcePersistentId<?>> org.hl7.fhir.instance.model.api.IIdType getReverseResolvedId(T thePid)