Deprecating Tizen.Messaging.Messages APIs (#5593)

Signed-off-by: Krishna Kant Jaju <krishna.jaju@samsung.com>
Co-authored-by: randeepsingh01 <49635973+randeepsingh01@users.noreply.github.com>

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/CBMessage.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/CBMessage.cs
index 08ddae8..1a24ef0 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/CBMessage.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/CBMessage.cs
@@ -22,6 +22,7 @@ namespace Tizen.Messaging.Messages
     /// This class represents the cell broadcast messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class CBMessage : Message
     {
         internal CBMessage(IntPtr messageHandle) : base(messageHandle)

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/Message.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/Message.cs
index c2c2a28..3ac8630 100644 (file)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/Message.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/Message.cs
@@ -24,6 +24,7 @@ namespace Tizen.Messaging.Messages
     /// This class represents all the messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public abstract class Message : IDisposable
     {
         internal IntPtr _messageHandle = IntPtr.Zero;
@@ -72,6 +73,7 @@ namespace Tizen.Messaging.Messages
         /// Releases all resources used by the Message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public void Dispose()
         {
             Dispose(true);
@@ -189,6 +191,7 @@ namespace Tizen.Messaging.Messages
         /// After creating the Message object, the default value of this property is 0. After sending, this value is changed.
         /// </remarks>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public int Id
         {
             get
@@ -208,6 +211,7 @@ namespace Tizen.Messaging.Messages
         /// The destination port of the message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public int Port
         {
             get
@@ -227,6 +231,7 @@ namespace Tizen.Messaging.Messages
         /// The message box type.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessageBoxType BoxType
         {
             get
@@ -255,6 +260,7 @@ namespace Tizen.Messaging.Messages
         /// The text of the message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public string Text
         {
             get
@@ -283,6 +289,7 @@ namespace Tizen.Messaging.Messages
         /// The time of the message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public DateTime Time
         {
             get
@@ -311,6 +318,7 @@ namespace Tizen.Messaging.Messages
         /// The SIM slot index of the message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public SimSlotId SimId
         {
             get
@@ -339,6 +347,7 @@ namespace Tizen.Messaging.Messages
         /// Indicates the sender of the message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public IReadOnlyCollection<MessagesAddress> From
         {
             get

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessageReceivedEventArgs.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessageReceivedEventArgs.cs
index c91c601..25d60ff 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessageReceivedEventArgs.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessageReceivedEventArgs.cs
@@ -22,6 +22,7 @@ namespace Tizen.Messaging.Messages
     /// An extended EventArgs class, which contains a received message.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class MessageReceivedEventArgs : EventArgs
     {
         private Message _message;
@@ -35,6 +36,7 @@ namespace Tizen.Messaging.Messages
         /// The received message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public Message ReceivedMessage
         {
             get

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAddress.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAddress.cs
index 74f834f..8b03b5d 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAddress.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAddress.cs
@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+using System;
 
 namespace Tizen.Messaging.Messages
 {
@@ -20,6 +21,7 @@ namespace Tizen.Messaging.Messages
     /// This class is used to manage the information of the message address.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class MessagesAddress
     {
         internal RecipientType Type;
@@ -34,6 +36,7 @@ namespace Tizen.Messaging.Messages
         /// </summary>
         /// <param name="number">The recipient's address to receive a message.</param>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessagesAddress(string number)
         {
             Number = number;

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAttachment.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAttachment.cs
index d06d605..bfd4db6 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAttachment.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesAttachment.cs
@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+using System;
 
 namespace Tizen.Messaging.Messages
 {
@@ -20,18 +21,21 @@ namespace Tizen.Messaging.Messages
     /// This class is used to manage the information of the message attachment.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class MessagesAttachment
     {
         /// <summary>
         /// The media type of the attachment.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MediaType Type { get; }
 
         /// <summary>
         /// The file path of the attachment.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public string FilePath { get; }
 
         /// <summary>
@@ -40,6 +44,7 @@ namespace Tizen.Messaging.Messages
         /// <param name="type">The attachment's type.</param>
         /// <param name="filePath">The file path to attach.</param>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessagesAttachment(MediaType type, string filePath)
         {
             Type = type;

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesEnumerations.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesEnumerations.cs
index f95ed7c..e6cc1f1 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesEnumerations.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesEnumerations.cs
@@ -13,6 +13,7 @@
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
+using System;
 
 namespace Tizen.Messaging.Messages
 {
@@ -20,6 +21,7 @@ namespace Tizen.Messaging.Messages
     /// Enumeration for the result of sending a message.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public enum SentResult
     {
         /// <summary>
@@ -36,6 +38,7 @@ namespace Tizen.Messaging.Messages
     /// Enumeration for the message type.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public enum MessageType
     {
         /// <summary>
@@ -64,6 +67,7 @@ namespace Tizen.Messaging.Messages
     /// Enumeration for the message box type.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public enum MessageBoxType
     {
         /// <summary>
@@ -92,6 +96,7 @@ namespace Tizen.Messaging.Messages
     /// Enumeration for the SIM slot index of a message.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public enum SimSlotId
     {
         /// <summary>
@@ -135,6 +140,7 @@ namespace Tizen.Messaging.Messages
     /// Enumeration for the attachment type for the MMS messaging.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public enum MediaType
     {
         /// <summary>

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesManager.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesManager.cs
index ce41df0..6349861 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesManager.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesManager.cs
@@ -25,6 +25,7 @@ namespace Tizen.Messaging.Messages
     /// </summary>
     /// <privilege>http://tizen.org/privilege/message.read</privilege>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public static class MessagesManager
     {
         /// <summary>
@@ -39,6 +40,7 @@ namespace Tizen.Messaging.Messages
         /// <exception cref="ArgumentException">Thrown when input coordinates are invalid.</exception>
         /// <exception cref="UnauthorizedAccessException">Thrown when an application does not have proper privileges.</exception>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public static Task<SentResult> SendMessageAsync(Message message, bool saveToSentbox)
         {
             return MessagesManagerImpl.Instance.SendMessageAsync(message, saveToSentbox);
@@ -56,6 +58,7 @@ namespace Tizen.Messaging.Messages
         /// <exception cref="OutOfMemoryException">Thrown when failed due to out of memory.</exception>
         /// <exception cref="UnauthorizedAccessException">Thrown when an application does not have proper privileges.</exception>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public static Task<IEnumerable<Message>> SearchMessageAsync(MessagesSearchFilter filter)
         {
             return MessagesManagerImpl.Instance.SearchMessageAsync(filter);
@@ -66,6 +69,7 @@ namespace Tizen.Messaging.Messages
         /// </summary>
         /// <privilege>http://tizen.org/privilege/message.read</privilege>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         static public event EventHandler<MessageReceivedEventArgs> MessageReceived
         {
             add

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesSearchFilter.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesSearchFilter.cs
index 44d7f54..03d7dbb 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesSearchFilter.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MessagesSearchFilter.cs
@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+using System;
 
 namespace Tizen.Messaging.Messages
 {
@@ -20,12 +21,14 @@ namespace Tizen.Messaging.Messages
     /// This class represents message search filters.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class MessagesSearchFilter
     {
         /// <summary>
         /// Creates a search filter for searching messages.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessagesSearchFilter()
         {
         }
@@ -34,21 +37,25 @@ namespace Tizen.Messaging.Messages
         /// The message box type.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessageBoxType MessageBoxType { get; set; }
         /// <summary>
         /// The message type.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MessageType MessageType { get; set; }
         /// <summary>
         /// The keyword to search in the text and the subject.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public string TextKeyword { get; set; }
         /// <summary>
         /// The recipient address.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public string AddressKeyword { get; set; }
     }
 }

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/MmsMessage.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/MmsMessage.cs
index 83d9fdc..43a8d2e 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/MmsMessage.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/MmsMessage.cs
@@ -23,6 +23,7 @@ namespace Tizen.Messaging.Messages
     /// This class represents multimedia messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class MmsMessage : Message
     {
         private IList<MessagesAttachment> _attachment = new List<MessagesAttachment>();
@@ -31,6 +32,7 @@ namespace Tizen.Messaging.Messages
         /// Creates a multimedia message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public MmsMessage() : base(MessageType.Mms)
         {
         }
@@ -44,6 +46,7 @@ namespace Tizen.Messaging.Messages
         /// The subject of the multimedia message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public string Subject
         {
             get
@@ -72,6 +75,7 @@ namespace Tizen.Messaging.Messages
         /// The collection of normal message recipients.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public ICollection<MessagesAddress> To
         {
             get
@@ -84,6 +88,7 @@ namespace Tizen.Messaging.Messages
         /// The collection of CC (carbon copy) message recipients.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public ICollection<MessagesAddress> Cc
         {
             get
@@ -96,6 +101,7 @@ namespace Tizen.Messaging.Messages
         /// The collection of BCC (blind carbon copy) message recipients.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public ICollection<MessagesAddress> Bcc
         {
             get
@@ -108,6 +114,7 @@ namespace Tizen.Messaging.Messages
         /// The list of attachment files.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public IList<MessagesAttachment> Attachments
         {
             get

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/PushMessage.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/PushMessage.cs
index eaca56a..2352ce5 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/PushMessage.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/PushMessage.cs
@@ -22,6 +22,7 @@ namespace Tizen.Messaging.Messages
     /// This class represents the WAP push messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class PushMessage : Message
     {
         internal PushMessage(IntPtr messageHandle) : base(messageHandle)

diff --git a/src/Tizen.Messaging/Tizen.Messaging.Messages/SmsMessage.cs b/src/Tizen.Messaging/Tizen.Messaging.Messages/SmsMessage.cs
index 76f5b1d..4cdaf96 100755 (executable)
--- a/src/Tizen.Messaging/Tizen.Messaging.Messages/SmsMessage.cs
+++ b/src/Tizen.Messaging/Tizen.Messaging.Messages/SmsMessage.cs
@@ -23,12 +23,14 @@ namespace Tizen.Messaging.Messages
     /// This class represents short text messages.
     /// </summary>
     /// <since_tizen> 3 </since_tizen>
+    [Obsolete("Deprecated since API11. Might be removed in API13.")]
     public class SmsMessage : Message
     {
         /// <summary>
         /// Creates a short text message.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public SmsMessage() : base(MessageType.Sms)
         {
         }
@@ -41,6 +43,7 @@ namespace Tizen.Messaging.Messages
         /// The collection of normal message recipients.
         /// </summary>
         /// <since_tizen> 3 </since_tizen>
+        [Obsolete("Deprecated since API11. Might be removed in API13.")]
         public ICollection<MessagesAddress> To
         {
             get

diff --git a/src/Tizen.Messaging/doc/api/Tizen.Messaging.Messages.md b/src/Tizen.Messaging/doc/api/Tizen.Messaging.Messages.md
index 4036a10..b2d0e61 100644 (file)
--- a/src/Tizen.Messaging/doc/api/Tizen.Messaging.Messages.md
+++ b/src/Tizen.Messaging/doc/api/Tizen.Messaging.Messages.md
@@ -15,4 +15,7 @@
 
 uid: Tizen.Messaging.Messages
 summary: The Tizen.Messaging.Messages namespace contains classes providing the functionality to send, receive, and search messages. 
+
+  > [!NOTE]
+  > All Messages APIs have been deprecated since Tizen 8.0 (API Level 11) which means they are planned to be removed after two releases.
 ---