001/*
002 *   Copyright 2024 Vonage
003 *
004 *   Licensed under the Apache License, Version 2.0 (the "License");
005 *   you may not use this file except in compliance with the License.
006 *   You may obtain a copy of the License at
007 *
008 *        http://www.apache.org/licenses/LICENSE-2.0
009 *
010 *   Unless required by applicable law or agreed to in writing, software
011 *   distributed under the License is distributed on an "AS IS" BASIS,
012 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *   See the License for the specific language governing permissions and
014 *   limitations under the License.
015 */
016package com.vonage.client.messages.mms;
017
018import com.fasterxml.jackson.annotation.JsonProperty;
019import com.vonage.client.messages.Channel;
020import com.vonage.client.messages.MessageRequest;
021import com.vonage.client.messages.MessageType;
022
023public abstract class MmsRequest extends MessageRequest {
024
025        protected MmsRequest(Builder<?, ?> builder, MessageType messageType) {
026                super(builder, Channel.MMS, messageType);
027                media.validateCaptionLength(2000);
028                int min = 300, max = 259200;
029                if (ttl != null && (ttl < min || ttl > max)) {
030                        throw new IllegalArgumentException("TTL must be between "+min+" and "+max+" seconds.");
031                }
032        }
033
034        @JsonProperty("ttl")
035        public Integer getTtl() {
036                return ttl;
037        }
038
039        protected abstract static class Builder<M extends MmsRequest, B extends Builder<? extends M, ? extends B>> extends MessageRequest.Builder<M, B> {
040
041                /**
042                 * (OPTIONAL)
043                 * Time-To-Live (how long a message should exist before it is delivered successfully) in seconds.
044                 * If a message is not delivered successfully within the TTL time, the message is considered expired
045                 * and will be rejected if TTL is supported. Must be between 300 and 259200. Default is 600.
046                 *
047                 * @param ttl The message time-to-live in seconds.
048                 *
049                 * @return This builder.
050                 * @since 8.7.0
051                 */
052                @Override
053                public B ttl(int ttl) {
054                        return super.ttl(ttl);
055                }
056        }
057}