it.auties.whatsapp.api.ConnectionBuilder Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of whatsappweb4j Show documentation
Standalone fully-featured Whatsapp Web API for Java and Kotlin
There is a newer version: 2.7.2
package it.auties.whatsapp.api;

import it.auties.whatsapp.controller.ControllerSerializer;
import it.auties.whatsapp.controller.DefaultControllerSerializer;
import lombok.NonNull;
import lombok.RequiredArgsConstructor;

import java.util.Objects;
import java.util.UUID;

/**
 * A builder to specify the type of connection to use
 *
 * @param  the type of the result
 */
@RequiredArgsConstructor
@SuppressWarnings("unused")
public class ConnectionBuilder> {
    private final ClientType clientType;
    private ControllerSerializer serializer;

    /**
     * Uses a custom serializer
     *
     * @param serializer the non-null serializer to use
     * @return an options builder
     */
    public ConnectionBuilder serializer(@NonNull ControllerSerializer serializer) {
       this.serializer = serializer;
       return this;
    }

    /**
     * Creates a new connection using a random uuid
     *
     * @return a non-null options selector
     */
    public T newConnection() {
        return newConnection(null);
    }

    /**
     * Creates a new connection using a unique identifier
     *
     * @param uuid the nullable uuid to use to create the connection
     * @return a non-null options selector
     */
    public T newConnection(UUID uuid) {
        return createConnection(uuid, ConnectionType.NEW);
    }

    /**
     * Creates a new connection using a random uuid
     *
     * @param phoneNumber the nullable uuid to use to create the connection
     * @return a non-null options selector
     */
    public T newConnection(long phoneNumber) {
        return createConnection(phoneNumber, ConnectionType.NEW);
    }

    /**
     * Creates a new connection using a supplied uuid
     * If a connection was serialized in the past with that uuid, it will be retrieved, otherwise a {@link it.auties.whatsapp.exception.UnknownSessionException} will be thrown
     *
     * @param uuid the non-null uuid to use
     * @return a non-null options selector
     */
    public T knownConnection(@NonNull UUID uuid) {
        return createConnection(uuid, ConnectionType.KNOWN);
    }

    /**
     * Creates a new connection using a supplied phone numberWithoutPrefix
     * If a connection was serialized in the past with that uuid, it will be retrieved, otherwise a {@link it.auties.whatsapp.exception.UnknownSessionException} will be thrown
     *
     * @param phoneNumber the non-null phone numberWithoutPrefix
     * @return a non-null options selector
     */
    public T knownConnection(long phoneNumber) {
        return createConnection(phoneNumber, ConnectionType.KNOWN);
    }

    /**
     * Creates a new connection from the first connection that was serialized
     * If no connection is available, a new one will be created
     *
     * @return a non-null options selector
     */
    public T firstConnection() {
        return createConnection(null, ConnectionType.FIRST);
    }

    /**
     * Creates a new connection from the last connection that was serialized
     * If no connection is available, a new one will be created
     *
     * @return a non-null options selector
     */
    public T lastConnection() {
        return createConnection(null, ConnectionType.LAST);
    }

    @SuppressWarnings("unchecked")
    private T createConnection(UUID uuid, ConnectionType connectionType) {
        return (T) switch (clientType) {
            case WEB_CLIENT ->
                    new WebOptionsBuilder(uuid, Objects.requireNonNullElse(serializer, DefaultControllerSerializer.instance()), connectionType);
            case APP_CLIENT ->
                    new MobileOptionsBuilder(uuid, Objects.requireNonNullElse(serializer, DefaultControllerSerializer.instance()), connectionType);
        };
    }

    @SuppressWarnings("unchecked")
    private T createConnection(long phoneNumber, ConnectionType connectionType) {
        return (T) switch (clientType) {
            case WEB_CLIENT ->
                    new WebOptionsBuilder(phoneNumber, Objects.requireNonNullElse(serializer, DefaultControllerSerializer.instance()), connectionType);
            case APP_CLIENT ->
                    new MobileOptionsBuilder(phoneNumber, Objects.requireNonNullElse(serializer, DefaultControllerSerializer.instance()), connectionType);
        };
    }
}