How to use build method of io.appium.java_client.touch.ActionOptions class

1package io.appium.java_client.touch.offset;
2
3import static java.util.Optional.ofNullable;
4
5import io.appium.java_client.touch.ActionOptions;
6
7import java.util.Map;
8
9public abstract class AbstractOptionCombinedWithPosition<T extends AbstractOptionCombinedWithPosition<T>>
10        extends ActionOptions<AbstractOptionCombinedWithPosition<T>> {
11    private ActionOptions<?> positionOption;
12
13    /**
14     * Some actions may require coordinates. Invocation of this method
15     * replaces the result of previous {@link #withElement(ElementOption)} invocation.
16     *
17     * @param positionOption required coordinates.     *
18     * @return self-reference
19     */
20    public T withPosition(PointOption positionOption) {
21        this.positionOption = positionOption;
22        return (T) this;
23    }
24
25    /**
26     * Most of touch action may use position which is relative to some element. In order to unify
27     * this behaviour this method was added. Invocation of this method
28     * replaces the result of previous {@link #withPosition(PointOption)} invocation.
29     *
30     * @param element required position which is relative to some element
31     * @return self-reference
32     */
33    public T withElement(ElementOption element) {
34        positionOption = element;
35        return (T) this;
36    }
37
38    protected void verify() {
39        ofNullable(positionOption).orElseThrow(() ->
40                new IllegalArgumentException("Some coordinates or an offset from an element should "
41                        + "be defined. Use withPosition or withElement methods"));
42    }
43
44    @Override
45    public Map<String, Object> build() {
46        final Map<String, Object> result = super.build();
47        result.putAll(positionOption.build());
48        return result;
49    }
50}
51

Source: AbstractOptionCombinedWithPosition.java

package io.appium.java_client.touch.offset;

import static java.util.Optional.ofNullable;

import io.appium.java_client.touch.ActionOptions;

import java.util.Map;

public abstract class AbstractOptionCombinedWithPosition<T extends AbstractOptionCombinedWithPosition<T>>
        extends ActionOptions<AbstractOptionCombinedWithPosition<T>> {
    private ActionOptions<?> positionOption;

    /**
     * Some actions may require coordinates. Invocation of this method
     * replaces the result of previous {@link #withElement(ElementOption)} invocation.
     *
     * @param positionOption required coordinates.     *
     * @return self-reference
     */
    public T withPosition(PointOption positionOption) {
        this.positionOption = positionOption;
        return (T) this;
    }

    /**
     * Most of touch action may use position which is relative to some element. In order to unify
     * this behaviour this method was added. Invocation of this method
     * replaces the result of previous {@link #withPosition(PointOption)} invocation.
     *
     * @param element required position which is relative to some element
     * @return self-reference
     */
    public T withElement(ElementOption element) {
        positionOption = element;
        return (T) this;
    }

    protected void verify() {
        ofNullable(positionOption).orElseThrow(() ->
                new IllegalArgumentException("Some coordinates or an offset from an element should "
                        + "be defined. Use withPosition or withElement methods"));
    }

    @Override
    public Map<String, Object> build() {
        final Map<String, Object> result = super.build();
        result.putAll(positionOption.build());
        return result;
    }
}