Class PatchRequireInstruction


  • @Generated(value="OracleSDKGenerator",
               comments="API Version: 20240430")
    public final class PatchRequireInstruction
    extends PatchInstruction
    A precondition operation that requires a selection to be non-empty, and optionally to include an item with a specified value (useful for asserting that a value exists before attempting to update it, avoiding accidental creation).

    It fails if the selection is empty, or if value is provided and no item of the selection matches it.
    Note: Objects should always be created or deserialized using the PatchRequireInstruction.Builder. This model distinguishes fields that are null because they are unset from fields that are explicitly set to null. This is done in the setter methods of the PatchRequireInstruction.Builder, which maintain a set of all explicitly set fields called PatchRequireInstruction.Builder.__explicitlySet__. The hashCode() and equals(Object) methods are implemented to take the explicitly set fields into account. The constructor, on the other hand, does not take the explicitly set fields into account (since the constructor cannot distinguish explicit null from unset null).

    • Constructor Detail

      • PatchRequireInstruction

        @Deprecated
        public PatchRequireInstruction​(String selection,
                                       Object value)
        Deprecated.
    • Method Detail

      • getValue

        public Object getValue()
        A value to be compared against each item of the selection.

        If this value is an object, then it matches any item that would be unaffected by applying this value as a merge operation. Otherwise, it matches any item to which it is equal according to the rules of JSON Schema.

        Returns:
        the value
      • toString

        public String toString​(boolean includeByteArrayContents)
        Return a string representation of the object.
        Overrides:
        toString in class PatchInstruction
        Parameters:
        includeByteArrayContents - true to include the full contents of byte arrays
        Returns:
        string representation