001// Generated by delombok at Tue Dec 10 13:42:03 UTC 2024
002/*
003 * Copyright (c) 2010-2024 Mark Allen, Norbert Bartels.
004 *
005 * Permission is hereby granted, free of charge, to any person obtaining a copy
006 * of this software and associated documentation files (the "Software"), to deal
007 * in the Software without restriction, including without limitation the rights
008 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
009 * copies of the Software, and to permit persons to whom the Software is
010 * furnished to do so, subject to the following conditions:
011 *
012 * The above copyright notice and this permission notice shall be included in
013 * all copies or substantial portions of the Software.
014 *
015 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
016 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
017 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
018 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
019 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
020 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
021 * THE SOFTWARE.
022 */
023package com.restfb.types.send;
024
025import java.util.ArrayList;
026import java.util.Collections;
027import java.util.List;
028import com.restfb.Facebook;
029import com.restfb.exception.FacebookPreconditionException;
030import com.restfb.types.AbstractFacebookType;
031
032public class Message extends AbstractFacebookType {
033  private static final int QUICK_REPLY_ITEM_LIMIT = 13;
034  @Facebook
035  private String text;
036  @Facebook("quick_replies")
037  private List<QuickReply> quickReplies;
038  @Facebook
039  private String metadata;
040  @Facebook
041  private MessageAttachment attachment;
042
043  public Message(String text) {
044    this.text = text;
045  }
046
047  public Message(MessageAttachment attachment) {
048    this.attachment = attachment;
049  }
050
051  /**
052   * add single {@code QuickReply} to the list of QuickReplies
053   * 
054   * @param quickReply
055   *          the QuickReply you like to add
056   * @return
057   */
058  public boolean addQuickReply(QuickReply quickReply) {
059    if (quickReplies == null) {
060      quickReplies = new ArrayList<>();
061    }
062    checkPrecondition(1);
063    return quickReplies.add(quickReply);
064  }
065
066  /**
067   * add list of {@code QuickReply} objects to the list of QuickReplies
068   * 
069   * @param quickReplyList
070   *          the list QuickReplies you like to add
071   * @return
072   */
073  public boolean addQuickReplies(List<QuickReply> quickReplyList) {
074    if (quickReplies == null) {
075      quickReplies = new ArrayList<>();
076    }
077    checkPrecondition(quickReplyList.size());
078    return quickReplies.addAll(quickReplyList);
079  }
080
081  public List<QuickReply> getQuickReplies() {
082    if (quickReplies == null) {
083      return Collections.emptyList();
084    }
085    return Collections.unmodifiableList(quickReplies);
086  }
087
088  private void checkPrecondition(int addingRepliesSize) {
089    if (quickReplies.size() + addingRepliesSize > QUICK_REPLY_ITEM_LIMIT) {
090      String message = "You cannot have more than " + QUICK_REPLY_ITEM_LIMIT + " replies in one message, current size/try adding: " + quickReplies.size() + "/" + addingRepliesSize;
091      throw new FacebookPreconditionException(message);
092    }
093  }
094
095  @java.lang.SuppressWarnings("all")
096  public String getText() {
097    return this.text;
098  }
099
100  @java.lang.SuppressWarnings("all")
101  public String getMetadata() {
102    return this.metadata;
103  }
104
105  @java.lang.SuppressWarnings("all")
106  public void setMetadata(final String metadata) {
107    this.metadata = metadata;
108  }
109
110  @java.lang.SuppressWarnings("all")
111  public MessageAttachment getAttachment() {
112    return this.attachment;
113  }
114}