Package oracle.as.scheduler

Class Incompatibility

java.lang.Object
oracle.as.scheduler.BaseMetadata<Incompatibility>
oracle.as.scheduler.Incompatibility
All Implemented Interfaces:
Serializable
public class Incompatibility extends BaseMetadata<Incompatibility> implements Serializable
Encapsulate an incompatibility among job and/or job set definitions over a given resource.

An Incompatibility specifies JobDefinition and/or JobSet definitions that are considered to be incompatible in the system and jobs for those definitions should not be concurrently run. Enterprise Scheduler performs incompatibility checks when it prepares to execute a request. The request will be blocked if an incompatible request is already being executed.

An Incompatibility is made up of one or more incompatible entities. An entity references a JobDefintion or JobSet definition. Each entity must reference a different JobDefintion or JobSet that is present in the metadata repository.

An entity can be marked self-incompatible. A self incompatible entity means that two request for that entity are not compatible and should not run concurrently.

An Incompatibility can be defined globally or for a given domain (resource). The entities for a global incompatibility are always considered to be incompatible. The entities for a domain incompatibility are considered incompatible if they have the same value for the specified domain resource. The resource is identified by a property name specified for each entity making up the Incompatibility. Each entity can specify the same property name or a different property name.

A valid Incompatibility definition usually has two or more entities. An Incompatibility having one entity is valid only if it is a self-incompatible entity.

See Also:

  • Constructor Details

    • Incompatibility

      public Incompatibility(String name, String description, Incompatibility.IncompatibilityType type)
      Constructs a new incompatibility definition.

      This constructor is used by clients to create Incompatibility definitions. Each incompatibility entity that is subsequently added is expected to be valid for incompatibility type associated with this object

      Parameters:
      name - the unique name to be given to this incompatibility definition. Must not be null. The name is also used as the default display name unless otherwise specifically set.
      description - an optional description. This can be null.
      type - the incompatibility type. Must not be null.
      Throws:
      NullPointerException - if a name or incompatibility type is not specified.

    • Incompatibility

      public Incompatibility(String name, String displayNameKey, String descriptionKey, Incompatibility.IncompatibilityType type, String[] resourceBundleIDs)
      Constructs a new incompatibility definition and associate resource bundles.

      This constructor is used by clients to create Incompatibility definitions. Each incompatibility entity that is subsequently added is expected to be valid for incompatibility type associated with this object

      Parameters:
      name - the name for this instance. It cannot be null. The name is also used as the default display name unless otherwise specifically set.
      displayNameKey - the resource bundle key for the display name. Optional.
      descriptionKey - the resource bundle key for the description. Optional.
      type - the incompatibility type. Must not be null.
      resourceBundleIDs - an array of resource bundle id. Optional.
      Throws:
      NullPointerException - if a name or incompatibility type is not specified.

  • Method Details

    • getType

      public Incompatibility.IncompatibilityType getType()
      Gets the incompatibility type.
      Returns:
      the incompatibility type

    • addEntity

      public void addEntity(MetadataObjectId entity, boolean selfIncompatible) throws ValidationException
      Adds an incompatibility entity to this object. This method is suitable for adding a new entity to a global incompatibility definition.
      Parameters:
      entity - the unique identifier for the JobDefinition or JobSet entity being added.
      selfIncompatible - true if the incompatibility entity is self-incompatible, or false if it is not self-incompatible.
      Throws:
      ValidationException - if this incompatibility already contains a reference to the entity. Also, thrown if the entity is not suitable for this incompatibility definition; for example, a property must be specified for each entity of a domain incompatibility.

    • addEntity

      public void addEntity(MetadataObjectId entity, String property, boolean selfIncompatible) throws ValidationException
      Adds an incompatibility entity to this object. This method is suitable for adding a new entity to a domain incompatibility definition.
      Parameters:
      entity - the unique identifier for the JobDefinition or JobSet entity being added.
      property - the property associated with the incompatibility entity. This cannot be null for a domain incompatibility.
      selfIncompatible - true if the incompatibility entity is self-incompatible, or false if it is not self-incompatible.
      Throws:
      ValidationException - if this incompatibility already contains a reference to the entity. Also, thrown if the entity is not suitable for this incompatibility definition; for example, a property must be specified for each entity of a domain incompatibility.

    • addEntity

      public void addEntity(IncompatibleEntity incompEntity) throws ValidationException
      Adds an incompatibility entity to this object.

      This makes a copy of the entity information being added.

      Parameters:
      incompEntity - information for the incompatibility entity.
      Throws:
      NullPointerException - if incompatibility entity not specified.
      ValidationException - if this incompatibility already contains a reference to the entity. Also, thrown if the entity is not suitable for this incompatibility definition; for example, a property must be specified for each entity of a domain incompatibility.

    • removeEntity

      public void removeEntity(MetadataObjectId entity)
      Removes the specified entity from this incompatibility definition.
      Parameters:
      entity - the identifier of the entity to be removed.

    • getEntity

      public IncompatibleEntity getEntity(MetadataObjectId entity)
      Gets information for an incompatibility entity associated with this incompatibility definition.
      Parameters:
      entity - the identiifer of the incompatibility entity
      Returns:
      information for the incompatibility entity. This will be null if no such entity is associated with this object, or no entity was specified.

    • getAllEntities

      public Collection<IncompatibleEntity> getAllEntities()
      Gets a collection of the incompatibility entities associated with this object.
      Returns:
      the entities associated with this object.

    • hashCode

      public int hashCode()
      The hash code for this object.
      Overrides:
      hashCode in class BaseMetadata<Incompatibility>
      Returns:
      hash code of this object.

    • equals

      public boolean equals(Object obj)
      Compares an object for equality with this Incompatibility object.
      Overrides:
      equals in class Object
      Parameters:
      obj - the object to compare with this Incompatibility.
      Returns:
      true if the object is an instance of Incompatibility and is considered equal to this object, or false otherwise.

    • getBaseMetadataType

      public BaseMetadataType<Incompatibility> getBaseMetadataType()
      Description copied from class: BaseMetadata
      Gets the intended type of this metadata.
      Specified by:
      getBaseMetadataType in class BaseMetadata<Incompatibility>
      Returns:
      the base metadata type

    • clone

      public Incompatibility clone(String newName) throws ValidationException
      Specified by:
      clone in class BaseMetadata<Incompatibility>
      Throws:
      ValidationException