Package com.aquima.interactions.profile.wrapper

Class ReadonlyProfile

java.lang.Object
com.aquima.interactions.profile.wrapper.ReadonlyProfile
All Implemented Interfaces:
IEventChannel, IProfile, IProfileLifecycle, Serializable
Direct Known Subclasses:
DependencyProfile, ReadonlyInferenceContext
public class ReadonlyProfile extends Object implements IProfile
Decorator class that wraps a profile to make it immutable (read-only).
Since:
5.0
Author:
O. Kerpershoek
See Also:

  • Constructor Details Link icon

    • ReadonlyProfile Link icon

      public ReadonlyProfile(IProfile profile)
      Constructs a read-only wrapper for the specified profile.
      Parameters:
      profile - The profile that should be wrapped in this read-only decorator.

  • Method Details Link icon

    • getProfile Link icon

      protected IProfile getProfile()

    • wrapInstance Link icon

      protected IEntityInstance wrapInstance(IEntityInstance instance)

    • createInstance Link icon

      public IEntityInstance createInstance(String entityName)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      createInstance in interface IProfile
      Parameters:
      entityName - The name of the entity for which a new instance should be created.
      Returns:
      A new instance for the specified type. Never null.

    • createInstance Link icon

      public IEntityInstance createInstance(String entityName, GUID instanceId, String instanceName)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      createInstance in interface IProfile
      Parameters:
      entityName - The name of the entity for which a new instance should be created.
      instanceId - Unique ID of the new instance.
      instanceName - Unique name of the new instance. when null is supplied a name will be generated by the profile.
      Returns:
      A new instance for the specified type. Never null.

    • deleteInstance Link icon

      public void deleteInstance(IEntityInstance instance, boolean autoDetach)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      deleteInstance in interface IProfile
      Parameters:
      instance - IEntityInstance the instance to delete.
      autoDetach - Boolean indicating if references to this instance should automatically be updated.

    • getAllInstancesForEntity Link icon

      public IEntityInstance[] getAllInstancesForEntity(String entityName, boolean includeChildren)
      Description copied from interface: IProfile
      This method returns all existing instances of a certain type in the profile. Even when there are no instances available for a certain type an empty array will be returned.
      Specified by:
      getAllInstancesForEntity in interface IProfile
      Parameters:
      entityName - The entity type for which the instances are requested.
      includeChildren - when this option is passed as true, all child entity-types are also returned.
      Returns:
      An array of instances for the specified type (never null).

    • getEntityDefinition Link icon

      public IEntityDefinition getEntityDefinition(String entityName)
      Description copied from interface: IProfile
      This method returns an entity definition for the supplied entity name.
      Specified by:
      getEntityDefinition in interface IProfile
      Parameters:
      entityName - The name of the entity for which the definition is requested.
      Returns:
      IEntityDefinition object containing the static entity information.

    • getInstance Link icon

      public IEntityInstance getInstance(EntityValue instance)
      Description copied from interface: IProfile
      This method can be used to lookup an instance based on a reference.
      Specified by:
      getInstance in interface IProfile
      Parameters:
      instance - InstanceReference of the instance that should be returned.
      Returns:
      IEntityInstance The entity instance for the specified ID.

    • getInstanceByName Link icon

      public IEntityInstance getInstanceByName(String entityName, String instanceName)
      Description copied from interface: IProfile
      This method returns an instance of the specified type for the given instance name.
      Specified by:
      getInstanceByName in interface IProfile
      Parameters:
      entityName - The name of the entity (type) of which the instance should be.
      instanceName - The name of the instance.
      Returns:
      IEntityInstance object of the correct type for the specified name.

    • getInstanceById Link icon

      public IEntityInstance getInstanceById(String entityName, GUID instanceId)
      Description copied from interface: IProfile
      This method returns the instance of the specified type for the given instance id. The id of an instance is generated when the instance is created, and can thus only be used within the same session.
      Specified by:
      getInstanceById in interface IProfile
      Parameters:
      entityName - The name of the entity (type) of which the instance should be.
      instanceId - The (unique) id of the instance.
      Returns:
      IEntityInstance object of the correct type for the specified name.

    • getSingletonInstance Link icon

      public IEntityInstance getSingletonInstance(String entityName, boolean create)
      Description copied from interface: IProfile

      This method can be used to retrieve the singleton instance from the profile for a specific entity type. Depending on the value of the create parameter that is passed, the behavior of this method differs slightly.

      • When there is a singleton instance present in the profile for the specified type, this method will return that instance regardless the value of create.
      • When no instance is present for the specified type and create is set to true, the singleton instance will be created and returned.
      • When no instance is present for the specified type and create is set to false, an UnknownInstanceException will be thrown.
      When this method is invoked for an entity that has not been specified as a singleton type in the meta-model, this method will throw an exception, as a singleton instance can not exist for entities that allow multiple instances in the profile.
      Specified by:
      getSingletonInstance in interface IProfile
      Parameters:
      entityName - String the Name of the entity
      create - boolean indicating whether the singleton instance should be created in case it does not exist yet.
      Returns:
      IEntityInstance interface pointing to the singleton ('0'th) instance for the specified entity type.

    • addEventListener Link icon

      public boolean addEventListener(IEventListener listener)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      addEventListener in interface IEventChannel
      Parameters:
      listener - The event listener that should be added.
      Returns:
      boolean indicating if the listener was actually added.

    • getSupportedEvents Link icon

      public int getSupportedEvents()
      Description copied from interface: IEventChannel
      This method returns a bit-mask containing all event types that are supported by this event channel. The bit-mask is a bitwise OR of the diverse event types. To check whether a specific event-listener is supported, you can do the following: 
       // This checks if a VALUE listener is supported
 if ((channel.getSupportedEvents() & IEvent.Mask.VALUE) != 0) {
   // VALUE event listeners that are supported
 }
      Specified by:
      getSupportedEvents in interface IEventChannel
      Returns:
      Bit-mask containing the event types that are supported by this event channel.

    • removeEventListener Link icon

      public boolean removeEventListener(IEventListener listener)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      removeEventListener in interface IEventChannel
      Parameters:
      listener - The event listener that should be removed.
      Returns:
      boolean indicating if the listener was actually removed.

    • commitTransaction Link icon

      public void commitTransaction(String name)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      commitTransaction in interface IProfile
      Parameters:
      name - Identifier for the transaction.
      Throws:
      InvalidStateException - This exception will always be thrown, as no modifications are allowed.

    • rollbackTransaction Link icon

      public void rollbackTransaction(String name)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      rollbackTransaction in interface IProfile
      Parameters:
      name - Identifier for the transaction.
      Throws:
      InvalidStateException - This exception will always be thrown, as no modifications are allowed.

    • startTransaction Link icon

      public void startTransaction(String name)
      Always throws an InvalidStateException: No modifications allowed on a read only profile.
      Specified by:
      startTransaction in interface IProfile
      Parameters:
      name - Identifier for the transaction.
      Throws:
      InvalidStateException - This exception will always be thrown, as no modifications are allowed.

    • getState Link icon

      public IProfileState getState()
      Description copied from interface: IProfile
      Returns the state of the profile (for serialization)
      Specified by:
      getState in interface IProfile
      Returns:
      returns the current state of the profile.

    • restore Link icon

      public void restore(IProfileState state)
      Description copied from interface: IProfile
      Clears the current state and overrides it with the provided state.
      Specified by:
      restore in interface IProfile
      Parameters:
      state - The new state for this profile.

    • passivate Link icon

      public void passivate()
      Description copied from interface: IProfileLifecycle
      This method may be used for preparing the profile for serialization.
      Specified by:
      passivate in interface IProfileLifecycle

    • activate Link icon

      public void activate(IProfileActivationContext profileActivationContext)
      Description copied from interface: IProfileLifecycle
      This method may be used for activating the profile after deserialization.
      Specified by:
      activate in interface IProfileLifecycle
      Parameters:
      profileActivationContext - the current profile activation context.