summaryrefslogtreecommitdiff
path: root/mcs/class/System.Web/System.Web.Caching/SqlCacheDependency.cs
blob: f3f12486592dd64fe8e57c1d98c4dfdc1f0b3f22 (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
117
118
//
// System.Web.UI.SqlCacheDependency
//
// Authors:
//   Marek Habersack (mhabersack@novell.com)
//
// Copyright (C) 2008 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
// 
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//

using System;
using System.Collections.Generic;
using System.Security.Permissions;
using System.Data.SqlClient;
using System.Web;

namespace System.Web.Caching
{
	[AspNetHostingPermissionAttribute (SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
	public sealed class SqlCacheDependency: CacheDependency
	{
		string uniqueId = Guid.NewGuid().ToString();

		[MonoTODO ("What to do with the sqlCmd?")]
		public SqlCacheDependency (SqlCommand sqlCmd)
		{
			if (sqlCmd == null)
				throw new ArgumentNullException ("sqlCmd");
		}

		[MonoTODO ("What are the params good for?")]
		public SqlCacheDependency (string databaseEntryName, string tableName)
		{
			if (databaseEntryName == null)
				throw new ArgumentNullException ("databaseEntryName");

			if (tableName == null)
				throw new ArgumentNullException ("tableName");
		}

#if NET_4_0
		[MonoTODO ("Needs more testing - especially the return value and database+table lookup.")]
		public static CacheDependency CreateOutputCacheDependency (string dependency)
		{
			if (dependency == null)
				throw new HttpException (InvalidDependencyFormatMessage (dependency));

			if (dependency.Length == 0)
				throw new ArgumentException (InvalidDependencyFormatMessage (dependency), "dependency");

			int colon;
			string[] pairs = dependency.Split (';');
			var dependencies = new List <SqlCacheDependency> ();

			foreach (string pair in pairs) {
				colon = pair.IndexOf (':');
				if (colon == -1)
					throw new ArgumentException (InvalidDependencyFormatMessage (dependency), "dependency");

				dependencies.Add (new SqlCacheDependency (pair.Substring (0, colon), pair.Substring (colon + 1)));
			}

			switch (dependencies.Count) {
				case 0:
					return null;

				case 1:
					return dependencies [0];

				default:
					var acd = new AggregateCacheDependency ();
					acd.Add (dependencies.ToArray ());
					return acd;
			}
		}

		static string InvalidDependencyFormatMessage (string dependency)
		{
			return String.Format (@"The '' SqlDependency attribute for OutputCache directive is invalid.

For SQL Server 7.0 and SQL Server 2000, the valid format is ""database:tablename"", and table name must conform to the format of regular identifiers in SQL. To specify multiple pairs of values, use the ';' separator between pairs. (To specify ':', '\' or ';', prefix it with the '\' escape character.)

For dependencies that use SQL Server 9.0 notifications, specify the value 'CommandNotification'.", dependency);
		}
#endif
		
		protected override void DependencyDispose ()
		{
			// MSDN doesn't document it as being part of the class, but assembly
			// comparison shows that it does exist in this type, so we're just calling
			// the base class here
			base.DependencyDispose ();
		}
		
		public override string GetUniqueID ()
		{
			return uniqueId;
		}
	}
}