Class PatchInsertInstruction


  • @Generated(value="OracleSDKGenerator",
               comments="API Version: 20240430")
    public final class PatchInsertInstruction
    extends PatchInstruction
    An operation that inserts a value into an array, shifting array items as necessary and handling NOT_FOUND exceptions by creating the implied containing structure.
    Note: Objects should always be created or deserialized using the PatchInsertInstruction.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 PatchInsertInstruction.Builder, which maintain a set of all explicitly set fields called PatchInsertInstruction.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).
    • Method Detail

      • getValue

        public Object getValue()
        A value to be inserted into the target.
        Returns:
        the value
      • getSelectedItem

        public String getSelectedItem()
        A selection to be evaluated against the array for identifying a particular reference item within it, with the same format and semantics as selection.
        Returns:
        the value
      • getPosition

        public PatchInsertInstruction.Position getPosition()
        Where to insert the value, relative to the first item matched by selectedItem.

        If selectedItem is unspecified, then “BEFORE” specifies insertion at the first position in an array and “AFTER” specifies insertion at the last position. If selectedItem is specified but results in an empty selection, then both values specify insertion at the last position.

        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