/// <summary>
/// Initializes the class. This includes loading application settings from the configuration file. The application name should be scoped within the system.
/// For non web applications, this method must be called directly from the main executable assembly and not from a supporting library.
///
/// To debug this method, create a folder called C:\AnyoneFullControl and give Everyone full control. A file will appear in that folder explaining how far
/// it got in init.
/// </summary>
/// <param name="appName"></param>
/// <param name="isClientSideProgram"></param>
/// <param name="systemLogic"></param>
/// <param name="mainDataAccessStateGetter">A method that returns the current main data-access state whenever it is requested, including during this
/// AppTools.Init call. Do not allow multiple threads to use the same state at the same time. If you pass null, the data-access subsystem will not be
/// available in the application.</param>
public static void Init(string appName, bool isClientSideProgram, SystemLogic systemLogic, Func <DataAccessState> mainDataAccessStateGetter = null)
{
var initializationLog = "Starting init";
try {
if (initialized)
{
throw new ApplicationException("This class can only be initialized once.");
}
if (systemLogic == null)
{
throw new ApplicationException("The system must have a global logic class and you must pass an instance of it to AppTools.Init.");
}
// Initialize ConfigurationStatics, including the general provider, before the exception handling block below because it's reasonable for the exception
// handling to depend on this.
ConfigurationStatics.Init(systemLogic.GetType(), appName, isClientSideProgram, ref initializationLog);
// Setting the initialized flag to true must be done before executing the secondary init block below so that exception handling works.
initialized = true;
initializationLog += Environment.NewLine + "Succeeded in primary init.";
}
catch (Exception e) {
initializationLog += Environment.NewLine + e;
StandardLibraryMethods.EmergencyLog("Initialization log", initializationLog);
throw;
}
try {
var asposeLicense = ConfigurationStatics.SystemGeneralProvider.AsposeLicenseName;
if (asposeLicense.Any())
{
new Aspose.Pdf.License().SetLicense(asposeLicense);
new Aspose.Words.License().SetLicense(asposeLicense);
}
// This initialization could be performed using reflection. There is no need for AppTools to have a dependency on these classes.
AppMemoryCache.Init();
BlobFileOps.Init();
DataAccessStatics.Init();
DataAccessState.Init(mainDataAccessStateGetter);
EncryptionOps.Init();
HtmlBlockStatics.Init();
InstallationSupportUtility.ConfigurationLogic.Init1();
UserManagementStatics.Init();
systemLogic.InitSystem();
}
catch (Exception e) {
secondaryInitFailed = true;
// Suppress all exceptions since they would prevent apps from knowing that primary initialization succeeded. EWF apps need to know this in order to
// automatically restart themselves. Other apps could find this knowledge useful as well.
try {
EmailAndLogError("An exception occurred during application initialization:", e);
}
catch {}
}
}
/// <summary>
/// Performs cleanup activities so the application can be shut down.
/// </summary>
public static void CleanUpStatics()
{
try {
globalInitializer?.CleanUpStatics();
AppMemoryCache.CleanUp();
}
catch (Exception e) {
TelemetryStatics.ReportError("An exception occurred during application cleanup:", e);
}
}
/// <summary>
/// Performs cleanup activities so the application can be shut down.
/// </summary>
public static void CleanUp()
{
assertClassInitialized();
try {
AppMemoryCache.CleanUp();
}
catch (Exception e) {
EmailAndLogError("An exception occurred during application cleanup:", e);
}
}
protected override void loadData()
{
var userIsProfiling = AppMemoryCache.UserIsProfilingRequests(AppRequestState.Instance.ProfilingUserId);
ph.AddControlsReturnThis(
new Paragraph("Profiling is currently {0}.".FormatWith(userIsProfiling ? "ON" : "OFF")),
new Paragraph(
new PostBackButton(
PostBack.CreateFull(
id: "toggle",
firstModificationMethod:
() =>
AppRequestState.AddNonTransactionalModificationMethod(
() => AppMemoryCache.SetRequestProfilingForUser(AppRequestState.Instance.ProfilingUserId, userIsProfiling ? TimeSpan.Zero : TimeSpan.FromHours(1)))),
new ButtonActionControlStyle(userIsProfiling ? "Turn Profiling OFF" : "Turn Profiling ON"),
usesSubmitBehavior: false)));
}
protected override void loadData()
{
var userIsProfiling = AppMemoryCache.UserIsProfilingRequests(AppRequestState.Instance.ProfilingUserId);
ph.AddControlsReturnThis(
new Paragraph("Profiling is currently {0}.".FormatWith(userIsProfiling ? "ON" : "OFF").ToComponents()).Append(
new Paragraph(
new EwfButton(
new StandardButtonStyle(userIsProfiling ? "Turn Profiling OFF" : "Turn Profiling ON"),
behavior: new PostBackBehavior(
postBack: PostBack.CreateFull(
id: "toggle",
firstModificationMethod: () => AppRequestState.AddNonTransactionalModificationMethod(
() => AppMemoryCache.SetRequestProfilingForUser(
AppRequestState.Instance.ProfilingUserId,
userIsProfiling ? TimeSpan.Zero : TimeSpan.FromHours(1)))))).ToCollection()))
.GetControls());
}
protected override PageContent getContent()
{
var content = new UiPageContent();
var userIsProfiling = AppMemoryCache.UserIsProfilingRequests(AppRequestState.Instance.ProfilingUserId);
content.Add(
new Paragraph("Profiling is currently {0}.".FormatWith(userIsProfiling ? "ON" : "OFF").ToComponents()).Append(
new Paragraph(
new EwfButton(
new StandardButtonStyle(userIsProfiling ? "Turn Profiling OFF" : "Turn Profiling ON"),
behavior: new PostBackBehavior(
postBack: PostBack.CreateFull(
id: "toggle",
modificationMethod: () => AppRequestState.AddNonTransactionalModificationMethod(
() => AppMemoryCache.SetRequestProfilingForUser(
AppRequestState.Instance.ProfilingUserId,
userIsProfiling ? TimeSpan.Zero : TimeSpan.FromHours(1)))))).ToCollection()))
.Materialize());
return(content);
}
/// <summary>
/// Initializes the system. This includes loading application settings from the configuration file. The application name should be scoped within the system.
/// For non web applications, this method must be called directly from the main executable assembly and not from a supporting library.
///
/// To debug this method, create a folder called C:\AnyoneFullControl and give Everyone full control. A file will appear in that folder explaining how far
/// it got in init.
/// </summary>
/// <param name="globalInitializer">The system's global initializer. Do not pass null.</param>
/// <param name="appName"></param>
/// <param name="isClientSideApp"></param>
/// <param name="assemblyFolderPath">Pass a nonempty string to override the assembly folder path, which is used to locate the installation folder. Use with
/// caution.</param>
/// <param name="mainDataAccessStateGetter">A method that returns the current main data-access state whenever it is requested, including during this
/// InitStatics call. Do not allow multiple threads to use the same state at the same time. If you pass null, the data-access subsystem will not be
/// available in the application.</param>
/// <param name="useLongDatabaseTimeouts">Pass true if the application is a background process that can tolerate slow database access.</param>
public static void InitStatics(
SystemInitializer globalInitializer, string appName, bool isClientSideApp, string assemblyFolderPath = "",
Func <DataAccessState> mainDataAccessStateGetter = null, bool useLongDatabaseTimeouts = false)
{
var initializationLog = "Starting init";
try {
if (initialized)
{
throw new ApplicationException("This class can only be initialized once.");
}
if (globalInitializer == null)
{
throw new ApplicationException("The system must have a global initializer.");
}
// Initialize these before the exception handling block below because it's reasonable for the exception handling to depend on them.
ConfigurationStatics.Init(assemblyFolderPath, globalInitializer.GetType(), appName, isClientSideApp, ref initializationLog);
EmailStatics.Init();
TelemetryStatics.Init();
// Setting the initialized flag to true must be done before executing the secondary init block below so that exception handling works.
initialized = true;
initializationLog += Environment.NewLine + "Succeeded in primary init.";
}
catch (Exception e) {
initializationLog += Environment.NewLine + e;
EwlStatics.EmergencyLog("Initialization log", initializationLog);
throw;
}
try {
CultureInfo.DefaultThreadCurrentCulture = Cultures.EnglishUnitedStates;
var asposePdfLicensePath = EwlStatics.CombinePaths(ConfigurationStatics.InstallationConfiguration.AsposeLicenseFolderPath, "Aspose.PDF.lic");
if (File.Exists(asposePdfLicensePath))
{
new Aspose.Pdf.License().SetLicense(asposePdfLicensePath);
}
var asposeWordsLicensePath = EwlStatics.CombinePaths(ConfigurationStatics.InstallationConfiguration.AsposeLicenseFolderPath, "Aspose.Words.lic");
if (File.Exists(asposeWordsLicensePath))
{
new Aspose.Words.License().SetLicense(asposeWordsLicensePath);
}
AppMemoryCache.Init();
BlobStorageStatics.Init();
DataAccessStatics.Init();
DataAccessState.Init(mainDataAccessStateGetter, useLongDatabaseTimeouts);
EncryptionOps.Init();
HtmlBlockStatics.Init();
UserManagementStatics.Init();
GlobalInitializationOps.globalInitializer = globalInitializer;
globalInitializer.InitStatics();
}
catch (Exception e) {
secondaryInitFailed = true;
// Suppress all exceptions since they would prevent apps from knowing that primary initialization succeeded. EWF apps need to know this in order to
// automatically restart themselves. Other apps could find this knowledge useful as well.
try {
TelemetryStatics.ReportError("An exception occurred during application initialization:", e);
}
catch {}
}
}
/// <summary>
/// EwfApp use only.
/// </summary>
internal void EnableUser()
{
userEnabled = true;
// Abandon the profiling session if it's not needed. The boolean expressions are in this order because we don't want to short circuit the user check if
// the installation is not live or the request is local; doing so would prevent adequate testing of the user check.
var userIsProfiling = UserAccessible && (ProfilingUserId.HasValue || ImpersonatorExists) && AppMemoryCache.UserIsProfilingRequests(ProfilingUserId);
if (!userIsProfiling && !HttpContext.Current.Request.IsLocal && ConfigurationStatics.IsLiveInstallation)
{
MiniProfiler.Stop(discardResults: true);
}
}
internal static FullResponse GetFromCache(string key, DateTimeOffset lastModificationDateAndTime, Func <FullResponse> valueCreator)
{
var cache = AppMemoryCache.GetCacheValue("ewfResponse-" + key, () => new DateAndTimeVersionedCache <FullResponse>());
return(cache.ValuesByDateAndTime.GetOrAdd(lastModificationDateAndTime, valueCreator));
}
