001// Generated by delombok at Fri Mar 17 23:20:38 UTC 2023
002/*
003 * Copyright (c) 2010-2023 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.media;
024
025import java.util.ArrayList;
026import java.util.List;
027import com.restfb.Facebook;
028import com.restfb.types.AbstractFacebookType;
029import com.restfb.types.send.AbstractButton;
030import com.restfb.types.send.MediaAttachment;
031import com.restfb.types.send.WebButton;
032
033/**
034 * Represents the media template element that is used with the url as defined
035 * <a href="https://developers.facebook.com/docs/messenger-platform/send-messages/template/media#url">here</a>
036 *
037 * Allowed urls are:
038 * <ul>
039 * <li>https://business.facebook.com/<PAGE_NAME>/videos/<NUMERIC_ID></li>
040 * <li>https://www.facebook.com/<USERNAME>/videos/<NUMERIC_ID>/</li>
041 * <li>https://business.facebook.com/<PAGE_NAME>/photos/<NUMERIC_ID></li>
042 * <li>https://www.facebook.com/photo.php?fbid=<NUMERIC_ID></li>
043 * </ul>
044 */
045public class MediaTemplateUrlElement extends AbstractFacebookType implements MediaAttachment.MediaTemplateElement {
046  @Facebook("media_type")
047  private String mediaType;
048  @Facebook
049  private String url;
050  @Facebook
051  private List<AbstractButton> buttons;
052
053  public MediaTemplateUrlElement(String url) {
054    if (!validUrl(url)) {
055      throw new IllegalArgumentException("The given URL is not valid");
056    }
057    this.url = url;
058    if (url.contains("/videos/")) {
059      this.mediaType = MediaAttachment.MediaType.VIDEO.name().toLowerCase();
060    } else {
061      this.mediaType = MediaAttachment.MediaType.IMAGE.name().toLowerCase();
062    }
063  }
064
065  @Override
066  public void addButton(AbstractButton button) {
067    if (buttons == null) {
068      buttons = new ArrayList<>();
069    }
070    buttons.add(button);
071  }
072
073  private boolean validUrl(String url) {
074    if (url == null) {
075      throw new IllegalArgumentException("The media URL may not be null");
076    }
077    if (url.startsWith("https://business.facebook.com/")) {
078      return true;
079    }
080    return url.startsWith("https://www.facebook.com/");
081  }
082
083  @java.lang.SuppressWarnings("all")
084  public String getMediaType() {
085    return this.mediaType;
086  }
087
088  @java.lang.SuppressWarnings("all")
089  public String getUrl() {
090    return this.url;
091  }
092
093  @java.lang.SuppressWarnings("all")
094  public List<AbstractButton> getButtons() {
095    return this.buttons;
096  }
097}