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;
024
025import static java.util.Collections.unmodifiableList;
026import java.util.ArrayList;
027import java.util.Date;
028import java.util.List;
029import com.restfb.Facebook;
030
031/**
032 * Represents the <a href="http://developers.facebook.com/docs/reference/api/page/#conversations"> Conversation Graph
033 * API type</a>.
034 * 
035 * @author <a href="http://restfb.com">Mark Allen</a>
036 * @author Felipe Kurkowski
037 */
038public class Conversation extends FacebookType {
039  /**
040   * A URL for this conversation.
041   * 
042   */
043  @Facebook
044  private String link;
045  /**
046   * The subject of this conversation.
047   * 
048   */
049  @Facebook
050  private String subject;
051  /**
052   * The title of a message in the conversation
053   * 
054   */
055  @Facebook
056  private String snippet;
057  /**
058   * The new identifier for threads effective after September 24, 2017
059   */
060  @Facebook("thread_key")
061  private String threadKey;
062  /**
063   * Last update time of the conversation
064   * 
065   */
066  @Facebook("updated_time")
067  private Date updatedTime;
068  /**
069   * The number of messages in the conversation
070   * 
071   */
072  @Facebook("message_count")
073  private Long messageCount;
074  /**
075   * The name of the message folder or source.
076   */
077  @Facebook
078  private String name;
079  /**
080   * The number of unread messages in the conversation
081   * <p>
082   * Facebook does not send the unread count if there aren't any new messages. In order to keep data consistency, we set
083   * the default value to zero. If this value is sent, the {@link com.restfb.JsonMapper} will override it.
084   * 
085   */
086  @Facebook("unread_count")
087  private Long unreadCount = 0L;
088  /**
089   * Wallpaper to display as a background for the thread
090   */
091  @Facebook
092  private String wallpaper;
093  @Facebook
094  private List<Tag> tags = new ArrayList<>();
095  @Facebook
096  private List<ExtendedReferenceType> participants = new ArrayList<>();
097  @Facebook("former_participants")
098  private List<NamedFacebookType> formerParticipants = new ArrayList<>();
099  @Facebook
100  private List<NamedFacebookType> senders = new ArrayList<>();
101  /**
102   * Whether The Page can reply to the conversation
103   * 
104   */
105  @Facebook("can_reply")
106  private Boolean canReply;
107  /**
108   * Whether you are subscribed to the conversation
109   * 
110   */
111  @Facebook("is_subscribed")
112  private Boolean subscribed;
113  @Facebook
114  private List<Message> messages = new ArrayList<>();
115  private static final long serialVersionUID = 1L;
116
117
118  /**
119   * Represents the <a href="http://developers.facebook.com/docs/reference/api/page/#conversations"> Tag Graph API
120   * type</a>.
121   * 
122   * @author <a href="http://restfb.com">Mark Allen</a>
123   * @author Felipe Kurkowski
124   */
125  public static class Tag extends AbstractFacebookType {
126    /**
127     * The name field for this type.
128     * 
129     */
130    @Facebook
131    private String name;
132    private static final long serialVersionUID = 1L;
133
134    /**
135     * The name field for this type.
136     * 
137     * @return The name field for this type.
138     */
139    @java.lang.SuppressWarnings("all")
140    public String getName() {
141      return this.name;
142    }
143
144    /**
145     * The name field for this type.
146     * 
147     */
148    @java.lang.SuppressWarnings("all")
149    public void setName(final String name) {
150      this.name = name;
151    }
152  }
153
154  /**
155   * A list of tags indicating the message folder, and whether the conversation is read and seen.
156   * 
157   * @return A list of tags indicating the message folder, and whether the conversation is read and seen.
158   */
159  public List<Tag> getTags() {
160    return unmodifiableList(tags);
161  }
162
163  public boolean addTag(Tag tag) {
164    return tags.add(tag);
165  }
166
167  public boolean removeTag(Tag tag) {
168    return tags.remove(tag);
169  }
170
171  /**
172   * Users who are on this message conversation
173   * 
174   * @return Users who are on this message conversation
175   */
176  public List<ExtendedReferenceType> getParticipants() {
177    return unmodifiableList(participants);
178  }
179
180  public boolean addParticipant(ExtendedReferenceType participant) {
181    return participants.add(participant);
182  }
183
184  public boolean removeParticipant(ExtendedReferenceType participant) {
185    return participants.remove(participant);
186  }
187
188  /**
189   * Users who send a message on the conversation
190   * 
191   * @return Users who send a message on the conversation
192   */
193  public List<NamedFacebookType> getSenders() {
194    return unmodifiableList(senders);
195  }
196
197  public boolean addSender(NamedFacebookType sender) {
198    return senders.add(sender);
199  }
200
201  public boolean removeSender(NamedFacebookType sender) {
202    return senders.remove(sender);
203  }
204
205  /**
206   * List of all messages in the conversation
207   * 
208   * @return List of all messages in the conversation
209   */
210  public List<Message> getMessages() {
211    return unmodifiableList(messages);
212  }
213
214  public boolean addMessage(Message message) {
215    return messages.add(message);
216  }
217
218  public boolean removeMessage(Message message) {
219    return messages.remove(message);
220  }
221
222  /**
223   * Users who used to be on this message conversation.
224   * 
225   * @return Users who used to be on this message conversation.
226   */
227  public List<NamedFacebookType> getFormerParticipants() {
228    return unmodifiableList(formerParticipants);
229  }
230
231  public boolean addFormerParticipant(NamedFacebookType formerParticipant) {
232    return formerParticipants.add(formerParticipant);
233  }
234
235  public boolean removeFormerParticipant(NamedFacebookType formerParticipant) {
236    return formerParticipants.remove(formerParticipant);
237  }
238
239  /**
240   * A URL for this conversation.
241   * 
242   * @return A URL for this conversation.
243   */
244  @java.lang.SuppressWarnings("all")
245  public String getLink() {
246    return this.link;
247  }
248
249  /**
250   * A URL for this conversation.
251   * 
252   */
253  @java.lang.SuppressWarnings("all")
254  public void setLink(final String link) {
255    this.link = link;
256  }
257
258  /**
259   * The subject of this conversation.
260   * 
261   * @return The subject of this conversation.
262   */
263  @java.lang.SuppressWarnings("all")
264  public String getSubject() {
265    return this.subject;
266  }
267
268  /**
269   * The subject of this conversation.
270   * 
271   */
272  @java.lang.SuppressWarnings("all")
273  public void setSubject(final String subject) {
274    this.subject = subject;
275  }
276
277  /**
278   * The title of a message in the conversation
279   * 
280   * @return The title of a message in the conversation
281   */
282  @java.lang.SuppressWarnings("all")
283  public String getSnippet() {
284    return this.snippet;
285  }
286
287  /**
288   * The title of a message in the conversation
289   * 
290   */
291  @java.lang.SuppressWarnings("all")
292  public void setSnippet(final String snippet) {
293    this.snippet = snippet;
294  }
295
296  /**
297   * The new identifier for threads effective after September 24, 2017
298   *
299   * @return The new identifier for threads effective after September 24, 2017
300   */
301  @java.lang.SuppressWarnings("all")
302  public String getThreadKey() {
303    return this.threadKey;
304  }
305
306  /**
307   * The new identifier for threads effective after September 24, 2017
308   */
309  @java.lang.SuppressWarnings("all")
310  public void setThreadKey(final String threadKey) {
311    this.threadKey = threadKey;
312  }
313
314  /**
315   * Last update time of the conversation
316   * 
317   * @return Last update time of the conversation
318   */
319  @java.lang.SuppressWarnings("all")
320  public Date getUpdatedTime() {
321    return this.updatedTime;
322  }
323
324  /**
325   * Last update time of the conversation
326   * 
327   */
328  @java.lang.SuppressWarnings("all")
329  public void setUpdatedTime(final Date updatedTime) {
330    this.updatedTime = updatedTime;
331  }
332
333  /**
334   * The number of messages in the conversation
335   * 
336   * @return The number of messages in the conversation
337   */
338  @java.lang.SuppressWarnings("all")
339  public Long getMessageCount() {
340    return this.messageCount;
341  }
342
343  /**
344   * The number of messages in the conversation
345   * 
346   */
347  @java.lang.SuppressWarnings("all")
348  public void setMessageCount(final Long messageCount) {
349    this.messageCount = messageCount;
350  }
351
352  /**
353   * The name of the message folder or source.
354   *
355   * @return The name of the message folder or source
356   */
357  @java.lang.SuppressWarnings("all")
358  public String getName() {
359    return this.name;
360  }
361
362  /**
363   * The name of the message folder or source.
364   */
365  @java.lang.SuppressWarnings("all")
366  public void setName(final String name) {
367    this.name = name;
368  }
369
370  /**
371   * The number of unread messages in the conversation
372   * <p>
373   * Facebook does not send the unread count if there aren't any new messages. In order to keep data consistency, we set
374   * the default value to zero. If this value is sent, the {@link com.restfb.JsonMapper} will override it.
375   * 
376   * @return The number of unread messages in the conversation
377   */
378  @java.lang.SuppressWarnings("all")
379  public Long getUnreadCount() {
380    return this.unreadCount;
381  }
382
383  /**
384   * The number of unread messages in the conversation
385   * <p>
386   * Facebook does not send the unread count if there aren't any new messages. In order to keep data consistency, we set
387   * the default value to zero. If this value is sent, the {@link com.restfb.JsonMapper} will override it.
388   * 
389   */
390  @java.lang.SuppressWarnings("all")
391  public void setUnreadCount(final Long unreadCount) {
392    this.unreadCount = unreadCount;
393  }
394
395  /**
396   * Wallpaper to display as a background for the thread
397   *
398   * @return Wallpaper to display as a background for the thread
399   */
400  @java.lang.SuppressWarnings("all")
401  public String getWallpaper() {
402    return this.wallpaper;
403  }
404
405  /**
406   * Wallpaper to display as a background for the thread
407   */
408  @java.lang.SuppressWarnings("all")
409  public void setWallpaper(final String wallpaper) {
410    this.wallpaper = wallpaper;
411  }
412
413  /**
414   * Whether The Page can reply to the conversation
415   * 
416   * @return Whether The Page can reply to the conversation
417   */
418  @java.lang.SuppressWarnings("all")
419  public Boolean getCanReply() {
420    return this.canReply;
421  }
422
423  /**
424   * Whether The Page can reply to the conversation
425   * 
426   */
427  @java.lang.SuppressWarnings("all")
428  public void setCanReply(final Boolean canReply) {
429    this.canReply = canReply;
430  }
431
432  /**
433   * Whether you are subscribed to the conversation
434   * 
435   * @return Whether you are subscribed to the conversation
436   */
437  @java.lang.SuppressWarnings("all")
438  public Boolean getSubscribed() {
439    return this.subscribed;
440  }
441
442  /**
443   * Whether you are subscribed to the conversation
444   * 
445   */
446  @java.lang.SuppressWarnings("all")
447  public void setSubscribed(final Boolean subscribed) {
448    this.subscribed = subscribed;
449  }
450}