aboutsummaryrefslogtreecommitdiffstats
path: root/Software/Visual_Studio/Tango.Serialization/IDataSerializer.cs
blob: 93465967e6404e67b7ef497e94d5002a3755a7a1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Tango.Serialization
{
    /// <summary>
    /// Represent an interface for creating a custom data serializer.
    /// </summary>
    public interface IDataSerializer
    {
        /// <summary>
        /// Serialize object to a file.
        /// </summary>
        /// <typeparam name="T">Type of specified object.</typeparam>
        /// <param name="obj">The specified object.</param>
        /// <param name="filePath">The full path to the file to write.</param>
        void SerializeToFile<T>(T obj, String filePath);

        /// <summary>
        /// Deserialize object from a file.
        /// </summary>
        /// <typeparam name="T">Type of object to deserialize.</typeparam>
        /// <param name="filePath">The full path of the data file.</param>
        /// <returns>The resulting object.</returns>
        T DeserializeFromFile<T>(String filePath);

        /// <summary>
        /// Serialize object to stream.
        /// </summary>
        /// <typeparam name="T">Type of specified object.</typeparam>
        /// <param name="obj">The specified object.</param>
        /// <param name="st">The stream to write.</param>
        void SerializeToStream<T>(T obj, Stream st);

        /// <summary>
        /// Deserialize object from stream.
        /// </summary>
        /// <typeparam name="T">Type of object to deserialize.</typeparam>
        /// <param name="st">Stream to read from.</param>
        /// <returns>The resulting object.</returns>
        T DeserializeFromStream<T>(Stream st);
    }
}