MonoRail/Castle.MonoRail.ActiveRecordSupport/ARDataBindAttribute.cs

   1 // Copyright 2004-2007 Castle Project - http://www.castleproject.org/
   2 //
   3 // Licensed under the Apache License, Version 2.0 (the "License");
   4 // you may not use this file except in compliance with the License.
   5 // You may obtain a copy of the License at
   6 //
   7 //     http://www.apache.org/licenses/LICENSE-2.0
   8 //
   9 // Unless required by applicable law or agreed to in writing, software
  10 // distributed under the License is distributed on an "AS IS" BASIS,
  11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 // See the License for the specific language governing permissions and
  13 // limitations under the License.
  14
  15 namespace Castle.MonoRail.ActiveRecordSupport
  16 {
  17         using System;
  18         using System.Reflection;
  19         using Castle.Components.Binder;
  20         using Castle.MonoRail.Framework;
  21
  22         /// <summary>
  23         /// Defines the behavior of
  24         /// Autoload feature on <see cref="ARDataBinder"/>
  25         /// </summary>
  26         public enum AutoLoadBehavior
  27         {
  28                 /// <summary>
  29                 /// Means that no autoload should be performed on the target
  30                 /// type or on nested types.
  31                 /// </summary>
  32                 Never,
  33
  34                 /// <summary>
  35                 /// Means that autoload should be used for the target type
  36                 /// and the nested types (if present). This demands that
  37                 /// the primary key be present on the http request
  38                 /// </summary>
  39                 Always,
  40
  41                 /// <summary>
  42                 /// Does not load the root type, but loads nested types
  43                 /// if the primary key is present. If not present, sets null on nested type.
  44                 /// </summary>
  45                 OnlyNested,
  46
  47                 /// <summary>
  48                 /// Means that we should autoload, but if the key is
  49                 /// invalid, like <c>null</c>, 0 or an empty string, then just
  50                 /// create a new instance of the target type.
  51                 /// </summary>
  52                 NewInstanceIfInvalidKey,
  53
  54                 /// <summary>
  55                 /// Means that we should autoload target and nested types when the key is valid.
  56                 /// If the key is invalid, like <c>null</c>, 0 or an empty string, and the
  57                 /// instance is the root instance, then create a new instance of the target type.
  58                 /// If the key is invalid, and it's a nested instance, then set null on the nested type.
  59                 /// </summary>
  60                 NewRootInstanceIfInvalidKey,
  61
  62                 /// <summary>
  63                 /// Means that we should autoload, but if the key is
  64                 /// invalid, like <c>null</c>, 0 or an empty string, then just
  65                 /// return null
  66                 /// </summary>
  67                 NullIfInvalidKey
  68         }
  69
  70         /// <summary>
  71         /// Extends <see cref="DataBindAttribute"/> with
  72         /// ActiveRecord specific functionallity
  73         /// </summary>
  74         [AttributeUsage(AttributeTargets.Parameter), Serializable]
  75         public class ARDataBindAttribute : DataBindAttribute, IParameterBinder
  76         {
  77                 private AutoLoadBehavior autoLoad = AutoLoadBehavior.Never;
  78                 private string expect = null;
  79
  80                 /// <summary>
  81                 /// Defines a binder for the parameter
  82                 /// using the <see cref="ARDataBinder"/> and the
  83                 /// specified <c>prefix</c>.
  84                 /// </summary>
  85                 /// <remarks>
  86                 /// This uses the default <see cref="AutoLoadBehavior"/>
  87                 /// whic is <see cref="AutoLoadBehavior.Never"/>
  88                 /// </remarks>
  89                 /// <param name="prefix">A name that prefixes the entries on the http request</param>
  90                 public ARDataBindAttribute(String prefix) : base(prefix)
  91                 {
  92                 }
  93
  94                 /// <summary>
  95                 /// Defines a binder for the parameter
  96                 /// using the <see cref="ARDataBinder"/> and the
  97                 /// specified <c>prefix</c>.
  98                 /// </summary>
  99                 /// <param name="prefix">A name that prefixes the entries on the http request</param>
 100                 /// <param name="autoLoadBehavior">The predefined behavior the autoload feature should use</param>
 101                 public ARDataBindAttribute(String prefix, AutoLoadBehavior autoLoadBehavior) : base(prefix)
 102                 {
 103                         autoLoad = autoLoadBehavior;
 104                 }
 105
 106                 /// <summary>
 107                 /// Defines the behavior the autoload feature
 108                 /// should use
 109                 /// </summary>
 110                 public AutoLoadBehavior AutoLoad
 111                 {
 112                         get { return autoLoad; }
 113                         set { autoLoad = value; }
 114                 }
 115
 116                 /// <summary>
 117                 /// Gets or sets the names of the collection that are expected to be binded.
 118                 /// If the binder does not find any value to an expected collection, it will clear to collection.
 119                 /// </summary>
 120                 /// <value>The expect collections names, in a csv fashion.</value>
 121                 public string Expect
 122                 {
 123                         get { return expect; }
 124                         set { expect = value; }
 125                 }
 126
 127                 public override object Bind(SmartDispatcherController controller, ParameterInfo parameterInfo)
 128                 {
 129                         ARDataBinder binder = (ARDataBinder) CreateBinder();
 130
 131                         ConfigureValidator(controller, binder);
 132
 133                         binder.AutoLoad = autoLoad;
 134
 135                         CompositeNode node = controller.ObtainParamsNode(From);
 136
 137                         object instance = binder.BindObject(parameterInfo.ParameterType, Prefix, Exclude, Allow, Expect, node);
 138
 139                         BindInstanceErrors(controller, binder, instance);
 140                         PopulateValidatorErrorSummary(controller, binder, instance);
 141
 142                         return instance;
 143                 }
 144
 145                 protected override IDataBinder CreateBinder()
 146                 {
 147                         return new ARDataBinder();
 148                 }
 149         }
 150 }