Breaking Changes in Xafari 15.1.308.217

1. Now numerators is based on XafariService (see Documentation).
2. Some methods have been removed or signatures were changed:
   class Xafari.BC.Numerators.NumeratorBase

• – void SaveDeletedNumber(object, long) -> void SaveDeletedNumber(object, Nullable<long>)

class Xafari.BC.Numerators.IDeletedNumbersSupport

• – long GetRealIndex(NumeratorBase, string) -> Nullable<long> GetRealIndex(NumeratorBase, string)
• – void SetRealIndex(NumeratorBase, string, long) -> void SetRealIndex(NumeratorBase, string, Nullable<long>)

class Xafari.BC.Numerators.INumeratorPersistenceProvider

• – TypeInfo GetNumeratorValueType() -> ITypeInfo GetNumeratorValueType()

class Xafari.BC.Numerators.NumeratorFormatter

• – void NumeratorFormatter(NumeratorBase) -> void NumeratorFormatter(ServiceSpaceContext, NumeratorBase)

class Xafari.BC.Numerators.NumeratorLink

• – void NumeratorLink(NumeratorBase, Type, string) – Delete
• – void NumeratorLink(NumeratorBase, Type, string, Nullable<int>) -> void NumeratorLink(NumeratorBase, Type, string, Nullable<int>, ApplyNumeratorsStrategy)

class Xafari.BC.Numerators.NumeratorManager

• – void AddNumerator(NumeratorBase) -> NumeratorManager AddNumerator(NumeratorBase)
• – void AddLink(NumeratorLink) -> NumeratorManager AddLink(NumeratorLink)
• – void SaveDeletedNumbers(object) – Delete
• – long GetRealIndex(object, NumeratorBase, string) – Delete
• – IObjectSpace CreateObjectSpace() – Delete
• – XafApplication Application – Delete
• – NumeratorManager Instance – Delete

class Xafari.BC.Numerators.Model.Extensions

• – IModelBCNumerators XafariBCNumerators(IModelApplication) – Delete
• 3. Enumeration Xafari.BC.Numerators.ApplyNumeratorsStrategy has been added in the numerator settings in the application model. You can use it to control numerators applying strategy.
  • class Xafari.BC.Numerators.Model.IModelNumerators
    – public ApplyNumeratorsStrategy DefaultApplyStrategy – New
  • class Xafari.BC.Numerators.Model.IModelNumeratorLink
    – public ApplyNumeratorsStrategy ApplyStrategy – New

1. When you work with settings in the application you have the capability to save or to rollback changes.
2. To attach the AppSettings module you can just add it to modules list. All needed settings is done by default.

– Use case with standard layers structure (Root->Users)
You need to upgrade existing project and do the following:

1. Find in the source code of platform-independent module or in the AppModule code for settings initialization and delete it.
   For example, you have the code like this

   void application_SetupComplete(object sender, EventArgs e)
   {
       if (this.Application.IsSharedApplication()) return;
       SettingsAccessor.Instance = new BCDemoSettingsAccessor((XafApplication)sender);
   }
   
   

   It should looks like this:

   void application_SetupComplete(object sender, EventArgs e)
   {
       if (this.Application.IsSharedApplication()) return;
   }
   
   

2. Find in the source code of platform-independent module or in the AppModule code for current layer settings initialization and delete it.
   For example, you have the code like this

   public override void Setup(XafApplication application)
   {
       base.Setup(application);
   
       application.SettingUp += (sender, args) =>
       {
           if (this.Application.IsSharedApplication()) return;
           this.Application.LoggedOn += (o, eventArgs) =>
           {
              SettingsAccessor.Instance.CurrentSlice = SettingsAccessor.Instance.GetSlice(SecuritySystem.CurrentUser);
               NumeratorManager.Instance.PersistenceProvider = new DCNumeratorPersistenceProvider();
           };
       };
       application.SetupComplete += application_SetupComplete;
   }
   

   It should looks like this:

   public override void Setup(XafApplication application)
   {
       base.Setup(application);
   
       application.SettingUp += (sender, args) =>
       {
           if (this.Application.IsSharedApplication()) return;
           this.Application.LoggedOn += (o, eventArgs) =>
           {
               NumeratorManager.Instance.PersistenceProvider = new DCNumeratorPersistenceProvider();
           };
       };
       application.SetupComplete += application_SetupComplete;
   }
   

3. One more example
   You have the code:

   void Application_LoggedOn(object sender, LogonEventArgs e)
   {
       var application = sender as XafApplication;
       if (application == null) return;
       if (SettingsAccessor.Instance != null) return;
       SettingsAccessor.Instance = new NorthwindSettingsAccessor(application);
       if (SecuritySystem.CurrentUser != null)
           SettingsAccessor.Instance.CurrentSlice = SettingsAccessor.Instance.GetSlice(((InheritedUser)SecuritySystem.CurrentUser).Department, SecuritySystem.CurrentUser);
   }

   It should looks like this:

   void Application_LoggedOn(object sender, LogonEventArgs e)
   {
       var application = sender as XafApplication;
       if (application == null) return;
   }
   

Use case with non-typical layers structure.
(see example from Xafari.Northwind project which shipped with installer)
You need to upgrade existing project and do the following:

1. Find in the source code of platform-independent module or in the AppModule code for settings initialization and change it by example below.
   You have the code:

   void Application_LoggedOn(object sender, LogonEventArgs e)
   {
       var application = sender as XafApplication;
       if (application == null) return;
       if (SettingsAccessor.Instance != null) return;
       SettingsAccessor.Instance = new NorthwindSettingsAccessor(application);
       if (SecuritySystem.CurrentUser != null)
           SettingsAccessor.Instance.CurrentSlice = SettingsAccessor.Instance.GetSlice(((InheritedUser)SecuritySystem.CurrentUser).Department, SecuritySystem.CurrentUser);
   }

   It should looks like this:

   void Application_LoggedOn(object sender, LogonEventArgs e)
   {
      var application = sender as XafApplication;
      if (application == null) return;
      if (SettingsAccessor.Instance != null) return;
      SettingsAccessor.Instance = new NorthwindSettingsAccessor();
      SettingsAccessor.Instance.Setup(application);
      if (SecuritySystem.CurrentUser != null)
          SettingsAccessor.Instance.ObjectSpace.AppSettings().CurrentSlice(((InheritedUser) SecuritySystem.CurrentUser).Department, SecuritySystem.CurrentUser);
   }

2. If you implemented your own SettingsAccessor you also need to make changes in it. Now the description of layers structure implements in the Setup method.
   Here is the code before.

   public class NorthwindSettingsAccessor : SettingsAccessor
   {
         public NorthwindSettingsAccessor(XafApplication application) : base(application)
         {
             this.RootSlice = new NorthwindSettingsDefaultValueSlice();
             this.SliceTypes = new[]
             {
                 typeof (NorthwindSettingsDepartment),
                 typeof (NorthwindSettingsInheritedUser),
             };
        }
   }

   Here is the code after.

   public class NorthwindSettingsAccessor : SettingsAccessor
   {
       public override void Setup(XafApplication application)
       {
          base.Setup(application);
          this.CreateRootSlice<NorthwindSettingsDefaultValueSlice>();
          this.SliceTypes = new[]
          {
               typeof (NorthwindSettingsDepartment),
               typeof (NorthwindSettingsInheritedUser),
          };
       }
   }

• public virtual IDataMinerOperation CreateDataMinerInstance() -> public IDataMinerOperation CreateDataMinerInstance(IObjectSpace, XafariReportParametersBase)
• public static IDataMinerOperation CreateDataMinerInstance(string) -> public static IDataMinerOperation CreateDataMinerInstance(string, IObjectSpace, XafariReportParametersBase)
• public static IDataMinerOperation CreateDataMinerInstance(IModelXafariReport) -> public static IDataMinerOperation CreateDataMinerInstance(IModelXafariReport, IObjectSpace, XafariReportParametersBase)
• public static XafariReportDataSourceBase CreateDataSourceInstance(IModelXafariReport) -> public static XafariReportDataBase CreateDataSourceInstance(IModelXafariReport)

Now class XtraReport is used to build report.

Use Xafari.Security.XafariSecurityManager.Instance instead. The method XafariSecurityManager.Instance.FindRole(IObjectSpace objectSpace, string roleName) has been added.

• Xafari.Server.IMessageHandler.OnCompleted has been renamed to Completed
• Xafari.Server.IMessageHandler.OnStartedThread has been renamed to ThreadStarted
• Xafari.Server.IMessageHandler.OnStoppedThread has been renamed to ThreadStopped

Example:

void IXFRegistrator.RegisterXF(Xafari.EntityFactory entityFactory)
{
    // Entity
    this.RegisterEntity<Entity1>();
    this.RegisterEntity<RefToEntity1>();

    // Entity & Extension
    this.RegisterEntity<XEntity1_Ext1>()
        .RegisterEntity<Ext1ListItem>()
        .RegisterEntity<Entity2>()
        .RegisterExtension<Entity1, XEntity1_Ext1>(a => a.Ext1(), b => b.Entity1())
        .RegisterExtension<Entity1, XEntity1_Ext2>(a => a.Ext2(), b => b.Entity1())
        .RegisterExtension<Entity1, XEntity1_Ext3>(a => a.Ext3(), b => b.Entity1());
}