dev.langchain4j.data.audio.Audio Maven / Gradle / Ivy

Go to download
package dev.langchain4j.data.audio;

import dev.langchain4j.Experimental;

import java.net.URI;
import java.util.Objects;

import static dev.langchain4j.internal.Utils.quoted;

@Experimental
public class Audio {
    private final URI url;
    private final String base64Data;
    private final String mimeType;

    /**
     * Create a new {@link Audio} from the Builder.
     * @param builder the builder.
     */
    private Audio(Builder builder) {
        this.url = builder.url;
        this.base64Data = builder.base64Data;
        this.mimeType = builder.mimeType;
    }

    /**
     * Create a new {@link Builder}.
     * @return the new {@link Builder}.
     */
    public static Builder builder() {
        return new Builder();
    }

    /**
     * Get the url of the audio.
     * @return the url of the audio, or null if not set.
     */
    public URI url() {
        return url;
    }

    /**
     * Get the base64 data of the audio.
     * @return the base64 data of the audio, or null if not set.
     */
    public String base64Data() {
        return base64Data;
    }

    /**
     * Get the mime type of the audio.
     * @return the mime type of the audio, or null if not set.
     */
    public String mimeType() {
        return mimeType;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Audio that = (Audio) o;
        return Objects.equals(this.url, that.url)
            && Objects.equals(this.base64Data, that.base64Data)
            && Objects.equals(this.mimeType, that.mimeType);
    }

    @Override
    public int hashCode() {
        return Objects.hash(url, base64Data, mimeType);
    }

    @Override
    public String toString() {
        return "Audio {" +
            " url = " + quoted(url) +
            ", base64Data = " + quoted(base64Data) +
            ", mimeType = " + quoted(mimeType) +
            " }";
    }

    /**
     * Builder for {@link Audio}.
     */
    public static class Builder {

        private URI url;
        private String base64Data;
        private String mimeType;

        /**
         * Create a new {@link Builder}.
         */
        public Builder() {}

        /**
         * Set the url of the audio.
         * @param url the url of the audio.
         * @return {@code this}
         */
        public Builder url(URI url) {
            this.url = url;
            return this;
        }

        /**
         * Set the url of the audio.
         * @param url the url of the audio.
         * @return {@code this}
         */
        public Builder url(String url) {
            return url(URI.create(url));
        }

        /**
         * Set the base64 data of the audio.
         * @param base64Data the base64 data of the audio.
         * @return {@code this}
         */
        public Builder base64Data(String base64Data) {
            this.base64Data = base64Data;
            return this;
        }

        /**
         * Set the mime type of the audio.
         * @param mimeType the mime type of the audio.
         * @return {@code this}
         */
        public Builder mimeType(String mimeType) {
            this.mimeType = mimeType;
            return this;
        }

        /**
         * Build the {@link Audio}.
         * @return the {@link Audio}.
         */
        public Audio build() {
            return new Audio(this);
        }
    }
}