blob: 44c4cbb05306abfd313809a438c0822d42af31b5 (
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
//-----------------------------------------------------------------------
// <copyright file="IProtocolMessageWithExtensions.cs" company="Andrew Arnott">
// Copyright (c) Andrew Arnott. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------
namespace DotNetOpenAuth.Messaging {
using System;
using System.Collections.Generic;
using System.Diagnostics.Contracts;
/// <summary>
/// A protocol message that supports adding extensions to the payload for transmission.
/// </summary>
[ContractClass(typeof(IProtocolMessageWithExtensionsContract))]
public interface IProtocolMessageWithExtensions : IProtocolMessage {
/// <summary>
/// Gets the list of extensions that are included with this message.
/// </summary>
/// <remarks>
/// Implementations of this interface should ensure that this property never returns null.
/// </remarks>
IList<IExtensionMessage> Extensions { get; }
}
/// <summary>
/// Code contract for the <see cref="IProtocolMessageWithExtensions"/> interface.
/// </summary>
[ContractClassFor(typeof(IProtocolMessageWithExtensions))]
internal abstract class IProtocolMessageWithExtensionsContract : IProtocolMessageWithExtensions {
/// <summary>
/// Prevents a default instance of the <see cref="IProtocolMessageWithExtensionsContract"/> class from being created.
/// </summary>
private IProtocolMessageWithExtensionsContract() {
}
#region IProtocolMessageWithExtensions Members
/// <summary>
/// Gets the list of extensions that are included with this message.
/// </summary>
/// <remarks>
/// Implementations of this interface should ensure that this property never returns null.
/// </remarks>
IList<IExtensionMessage> IProtocolMessageWithExtensions.Extensions {
get {
Contract.Ensures(Contract.Result<IList<IExtensionMessage>>() != null);
throw new NotImplementedException();
}
}
#endregion
#region IProtocolMessage Members
/// <summary>
/// Gets the level of protection this message requires.
/// </summary>
MessageProtections IProtocolMessage.RequiredProtection {
get { throw new NotImplementedException(); }
}
/// <summary>
/// Gets a value indicating whether this is a direct or indirect message.
/// </summary>
MessageTransport IProtocolMessage.Transport {
get { throw new NotImplementedException(); }
}
#endregion
#region IMessage Members
/// <summary>
/// Gets the version of the protocol or extension this message is prepared to implement.
/// </summary>
/// <remarks>
/// Implementations of this interface should ensure that this property never returns null.
/// </remarks>
Version IMessage.Version {
get {
throw new NotImplementedException();
}
}
/// <summary>
/// Gets the extra, non-standard Protocol parameters included in the message.
/// </summary>
/// <remarks>
/// Implementations of this interface should ensure that this property never returns null.
/// </remarks>
IDictionary<string, string> IMessage.ExtraData {
get {
throw new NotImplementedException();
}
}
/// <summary>
/// Checks the message state for conformity to the protocol specification
/// and throws an exception if the message is invalid.
/// </summary>
/// <remarks>
/// <para>Some messages have required fields, or combinations of fields that must relate to each other
/// in specialized ways. After deserializing a message, this method checks the state of the
/// message to see if it conforms to the protocol.</para>
/// <para>Note that this property should <i>not</i> check signatures or perform any state checks
/// outside this scope of this particular message.</para>
/// </remarks>
/// <exception cref="ProtocolException">Thrown if the message is invalid.</exception>
void IMessage.EnsureValidMessage() {
throw new NotImplementedException();
}
#endregion
}
}
|
