-//\r
-// System.Messaging\r
-//\r
-// Authors:\r
-// Peter Van Isacker (sclytrack@planetinternet.be)\r
-//\r
-// (C) 2003 Peter Van Isacker\r
-//\r
-
+//
+// System.Messaging.MessageQueuePermission.cs
+//
+// Authors:
+// Peter Van Isacker (sclytrack@planetinternet.be)
+// Sebastien Pouliot <sebastien@ximian.com>
+//
+// (C) 2003 Peter Van Isacker
+// Copyright (C) 2004 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
// 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;\r
-using System.Security;\r
-using System.Security.Permissions;\r
-\r
-namespace System.Messaging \r
-{\r
- [Serializable]\r
- public sealed class MessageQueuePermission: CodeAccessPermission, IUnrestrictedPermission \r
- {\r
- [MonoTODO]\r
- public MessageQueuePermission()\r
- {\r
- }\r
- \r
- [MonoTODO]\r
- public MessageQueuePermission(MessageQueuePermissionEntry[] permissionAccessEntries)\r
- {\r
- }\r
- \r
- [MonoTODO]\r
- public MessageQueuePermission(PermissionState state)\r
- {\r
- }\r
- \r
- [MonoTODO]\r
- public MessageQueuePermission(MessageQueuePermissionAccess permissionAccess, string path)\r
- {\r
- }\r
- \r
- [MonoTODO]\r
- public bool IsUnrestricted() \r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public MessageQueuePermission(MessageQueuePermissionAccess permissionAccess,\r
- string machineName,\r
- string label,\r
- string category)\r
- {\r
- }\r
- \r
- public MessageQueuePermissionEntryCollection PermissionEntries\r
- {\r
- [MonoTODO]\r
- get {throw new NotImplementedException();}\r
- }\r
- \r
- [MonoTODO]\r
- public override IPermission Copy()\r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public override void FromXml(SecurityElement securityElement)\r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public override IPermission Intersect(IPermission target)\r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public override bool IsSubsetOf(IPermission target)\r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public override SecurityElement ToXml()\r
- {\r
- throw new NotImplementedException();\r
- }\r
- \r
- [MonoTODO]\r
- public override IPermission Union(IPermission target)\r
- {\r
- throw new NotImplementedException();\r
- }\r
-\r
- [MonoTODO]\r
- internal void Clear ()\r
- {\r
- }\r
- }\r
-}\r
+
+using System.Globalization;
+using System.Security;
+using System.Security.Permissions;
+
+namespace System.Messaging {
+
+ [Serializable]
+ public sealed class MessageQueuePermission: CodeAccessPermission, IUnrestrictedPermission {
+
+ private const int version = 1;
+
+ private MessageQueuePermissionEntryCollection _list;
+ private bool _unrestricted;
+
+ public MessageQueuePermission ()
+ {
+ _list = new MessageQueuePermissionEntryCollection (this);
+ }
+
+ public MessageQueuePermission (MessageQueuePermissionEntry[] permissionAccessEntries)
+ : this ()
+ {
+ foreach (MessageQueuePermissionEntry entry in permissionAccessEntries)
+ _list.Add (entry);
+ }
+
+ public MessageQueuePermission (PermissionState state)
+ : this ()
+ {
+ _unrestricted = (state == PermissionState.Unrestricted);
+ }
+
+ public MessageQueuePermission (MessageQueuePermissionAccess permissionAccess, string path)
+ : this ()
+ {
+ MessageQueuePermissionEntry entry = new MessageQueuePermissionEntry (permissionAccess, path);
+ _list.Add (entry);
+ }
+
+ public MessageQueuePermission (MessageQueuePermissionAccess permissionAccess,
+ string machineName, string label, string category) : this ()
+ {
+ MessageQueuePermissionEntry entry = new MessageQueuePermissionEntry (permissionAccess, machineName, label, category);
+ _list.Add (entry);
+ }
+
+ public MessageQueuePermissionEntryCollection PermissionEntries {
+ get { return _list; }
+ }
+
+ public override IPermission Copy ()
+ {
+ if (_unrestricted)
+ return new MessageQueuePermission (PermissionState.Unrestricted);
+ else {
+ MessageQueuePermission copy = new MessageQueuePermission (PermissionState.None);
+ foreach (MessageQueuePermissionEntry entry in _list)
+ copy._list.Add (entry);
+ return copy;
+ }
+ }
+
+ public bool IsUnrestricted ()
+ {
+ return _unrestricted;
+ }
+
+ [MonoTODO]
+ public override void FromXml (SecurityElement securityElement)
+ {
+ CheckSecurityElement (securityElement, "securityElement", version, version);
+ // Note: we do not (yet) care about the return value
+ // as we only accept version 1 (min/max values)
+
+ _unrestricted = (IsUnrestricted (securityElement));
+
+ // TODO read elements
+ }
+
+ [MonoTODO]
+ public override IPermission Intersect (IPermission target)
+ {
+ Cast (target);
+ return null;
+ }
+
+ [MonoTODO]
+ public override bool IsSubsetOf (IPermission target)
+ {
+ Cast (target);
+ return false;
+ }
+
+ [MonoTODO]
+ public override SecurityElement ToXml ()
+ {
+ SecurityElement se = Element (version);
+ if (_unrestricted)
+ se.AddAttribute ("Unrestricted", "true");
+ else {
+ // TODO
+ }
+ return se;
+ }
+
+ [MonoTODO]
+ public override IPermission Union (IPermission target)
+ {
+ Cast (target);
+ return null;
+ }
+
+ // helpers
+
+ private bool IsEmpty ()
+ {
+ return (!_unrestricted && (_list.Count == 0));
+ }
+
+ private MessageQueuePermission Cast (IPermission target)
+ {
+ if (target == null)
+ return null;
+
+ MessageQueuePermission mqp = (target as MessageQueuePermission);
+ if (mqp == null) {
+ ThrowInvalidPermission (target, typeof (MessageQueuePermission));
+ }
+
+ return mqp;
+ }
+
+ // static helpers
+
+ private static char[] invalidChars = new char[] { '\t', '\n', '\v', '\f', '\r', ' ', '\\', '\x160' };
+
+ internal static void ValidateMachineName (string name)
+ {
+ // FIXME: maybe other checks are required (but not documented)
+ if ((name == null) || (name.Length == 0) || (name.IndexOfAny (invalidChars) != -1)) {
+ string msg = Locale.GetText ("Invalid machine name '{0}'.");
+ if (name == null)
+ name = "(null)";
+ msg = String.Format (msg, name);
+ throw new ArgumentException (msg, "MachineName");
+ }
+ }
+
+ internal static void ValidatePath (string path)
+ {
+ // FIXME: maybe other checks are required (but not documented)
+ if ((path.Length > 0) && (path [0] != '\\')) {
+ string msg = Locale.GetText ("Invalid path '{0}'.");
+ throw new ArgumentException (String.Format (msg, path), "Path");
+ }
+ }
+
+ // NOTE: The following static methods should be moved out to a (static?) class
+ // if (ever) System.Drawing.dll gets more than one permission in it's assembly.
+
+ // snippet moved from FileIOPermission (nickd) to be reused in all derived classes
+ internal SecurityElement Element (int version)
+ {
+ SecurityElement se = new SecurityElement ("IPermission");
+ Type type = this.GetType ();
+ se.AddAttribute ("class", type.FullName + ", " + type.Assembly.ToString ().Replace ('\"', '\''));
+ se.AddAttribute ("version", version.ToString ());
+ return se;
+ }
+
+ internal static PermissionState CheckPermissionState (PermissionState state, bool allowUnrestricted)
+ {
+ string msg;
+ switch (state) {
+ case PermissionState.None:
+ break;
+ case PermissionState.Unrestricted:
+ if (!allowUnrestricted) {
+ msg = Locale.GetText ("Unrestricted isn't not allowed for identity permissions.");
+ throw new ArgumentException (msg, "state");
+ }
+ break;
+ default:
+ msg = String.Format (Locale.GetText ("Invalid enum {0}"), state);
+ throw new ArgumentException (msg, "state");
+ }
+ return state;
+ }
+
+ // logic isn't identical to CodeAccessPermission.CheckSecurityElement - see unit tests
+ internal static int CheckSecurityElement (SecurityElement se, string parameterName, int minimumVersion, int maximumVersion)
+ {
+ if (se == null)
+ throw new ArgumentNullException (parameterName);
+
+ if (se.Attribute ("class") == null) {
+ string msg = Locale.GetText ("Missing 'class' attribute.");
+ throw new ArgumentException (msg, parameterName);
+ }
+
+ // we assume minimum version if no version number is supplied
+ int version = minimumVersion;
+ string v = se.Attribute ("version");
+ if (v != null) {
+ try {
+ version = Int32.Parse (v);
+ }
+ catch (Exception e) {
+ string msg = Locale.GetText ("Couldn't parse version from '{0}'.");
+ msg = String.Format (msg, v);
+ throw new ArgumentException (msg, parameterName, e);
+ }
+ }
+
+ if ((version < minimumVersion) || (version > maximumVersion)) {
+ string msg = Locale.GetText ("Unknown version '{0}', expected versions between ['{1}','{2}'].");
+ msg = String.Format (msg, version, minimumVersion, maximumVersion);
+ throw new ArgumentException (msg, parameterName);
+ }
+ return version;
+ }
+
+ // must be called after CheckSecurityElement (i.e. se != null)
+ internal static bool IsUnrestricted (SecurityElement se)
+ {
+ string value = se.Attribute ("Unrestricted");
+ if (value == null)
+ return false;
+ return (String.Compare (value, Boolean.TrueString, true, CultureInfo.InvariantCulture) == 0);
+ }
+
+ internal static void ThrowInvalidPermission (IPermission target, Type expected)
+ {
+ string msg = Locale.GetText ("Invalid permission type '{0}', expected type '{1}'.");
+ msg = String.Format (msg, target.GetType (), expected);
+ throw new ArgumentException (msg, "target");
+ }
+ }
+}