diff --git a/ClickForensics.Quartz.Manager/ClickForensics.Quartz.Manager.csproj b/ClickForensics.Quartz.Manager/ClickForensics.Quartz.Manager.csproj index c54a775..13792dd 100644 --- a/ClickForensics.Quartz.Manager/ClickForensics.Quartz.Manager.csproj +++ b/ClickForensics.Quartz.Manager/ClickForensics.Quartz.Manager.csproj @@ -51,19 +51,16 @@ 4 - - ..\packages\Quartz.2.0.1\lib\net40\C5.dll - - + False - ..\packages\Common.Logging.2.0.0\lib\2.0\Common.Logging.dll + ..\packages\Common.Logging.2.1.2\lib\net40\Common.Logging.dll ..\packages\log4net.1.2.10\lib\2.0\log4net.dll - + False - ..\packages\Quartz.2.0.1\lib\net40\Quartz.dll + ..\packages\Quartz.2.2\lib\net40\Quartz.dll @@ -169,6 +166,9 @@ True + + Designer + SettingsSingleFileGenerator diff --git a/ClickForensics.Quartz.Manager/job_scheduling_data_2_0.xsd b/ClickForensics.Quartz.Manager/job_scheduling_data_2_0.xsd new file mode 100644 index 0000000..64ab996 --- /dev/null +++ b/ClickForensics.Quartz.Manager/job_scheduling_data_2_0.xsd @@ -0,0 +1,361 @@ + + + + + + + Root level node + + + + + + Commands to be executed before scheduling the jobs and triggers in this file. + + + + + Directives to be followed while scheduling the jobs and triggers in this file. + + + + + + + + + + + + + + Version of the XML Schema instance + + + + + + + + + + Delete all jobs, if any, in the identified group. "*" can be used to identify all groups. Will also result in deleting all triggers related to the jobs. + + + + + Delete all triggers, if any, in the identified group. "*" can be used to identify all groups. Will also result in deletion of related jobs that are non-durable. + + + + + Delete the identified job if it exists (will also result in deleting all triggers related to it). + + + + + + + + + + + Delete the identified trigger if it exists (will also result in deletion of related jobs that are non-durable). + + + + + + + + + + + + + + + + Whether the existing scheduling data (with same identifiers) will be overwritten. If false, and ignore-duplicates is not false, and jobs or triggers with the same names already exist as those in the file, an error will occur. + + + + + If true (and overwrite-existing-data is false) then any job/triggers encountered in this file that have names that already exist in the scheduler will be ignored, and no error will be produced. + + + + + If true trigger's start time is calculated based on earlier run time instead of fixed value. Trigger's start time must be undefined for this to work. + + + + + + + + Define a JobDetail + + + + + + + + + + + + + + + + + Define a JobDataMap + + + + + + + + + Define a JobDataMap entry + + + + + + + + + + Define a Trigger + + + + + + + + + + + Common Trigger definitions + + + + + + + + + + + + + + + + + + + + + + + Define a SimpleTrigger + + + + + + + + + + + + + + + + + Define a CronTrigger + + + + + + + + + + + + + + + Define a DateIntervalTrigger + + + + + + + + + + + + + + + + Cron expression (see JavaDoc for examples) + + Special thanks to Chris Thatcher (thatcher@butterfly.net) for the regular expression! + + Regular expressions are not my strong point but I believe this is complete, + with the caveat that order for expressions like 3-0 is not legal but will pass, + and month and day names must be capitalized. + If you want to examine the correctness look for the [\s] to denote the + seperation of individual regular expressions. This is how I break them up visually + to examine them: + + SECONDS: + ( + ((([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?,)*([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?) + | (([\*]|[0-9]|[0-5][0-9])/([0-9]|[0-5][0-9])) + | ([\?]) + | ([\*]) + ) [\s] + MINUTES: + ( + ((([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?,)*([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?) + | (([\*]|[0-9]|[0-5][0-9])/([0-9]|[0-5][0-9])) + | ([\?]) + | ([\*]) + ) [\s] + HOURS: + ( + ((([0-9]|[0-1][0-9]|[2][0-3])(-([0-9]|[0-1][0-9]|[2][0-3]))?,)*([0-9]|[0-1][0-9]|[2][0-3])(-([0-9]|[0-1][0-9]|[2][0-3]))?) + | (([\*]|[0-9]|[0-1][0-9]|[2][0-3])/([0-9]|[0-1][0-9]|[2][0-3])) + | ([\?]) + | ([\*]) + ) [\s] + DAY OF MONTH: + ( + ((([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(-([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1]))?,)*([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(-([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1]))?(C)?) + | (([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])/([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(C)?) + | (L(-[0-9])?) + | (L(-[1-2][0-9])?) + | (L(-[3][0-1])?) + | (LW) + | ([1-9]W) + | ([1-3][0-9]W) + | ([\?]) + | ([\*]) + )[\s] + MONTH: + ( + ((([1-9]|0[1-9]|1[0-2])(-([1-9]|0[1-9]|1[0-2]))?,)*([1-9]|0[1-9]|1[0-2])(-([1-9]|0[1-9]|1[0-2]))?) + | (([1-9]|0[1-9]|1[0-2])/([1-9]|0[1-9]|1[0-2])) + | (((JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)(-(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC))?,)*(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)(-(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC))?) + | ((JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)/(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)) + | ([\?]) + | ([\*]) + )[\s] + DAY OF WEEK: + ( + (([1-7](-([1-7]))?,)*([1-7])(-([1-7]))?) + | ([1-7]/([1-7])) + | (((MON|TUE|WED|THU|FRI|SAT|SUN)(-(MON|TUE|WED|THU|FRI|SAT|SUN))?,)*(MON|TUE|WED|THU|FRI|SAT|SUN)(-(MON|TUE|WED|THU|FRI|SAT|SUN))?(C)?) + | ((MON|TUE|WED|THU|FRI|SAT|SUN)/(MON|TUE|WED|THU|FRI|SAT|SUN)(C)?) + | (([1-7]|(MON|TUE|WED|THU|FRI|SAT|SUN))(L|LW)?) + | (([1-7]|MON|TUE|WED|THU|FRI|SAT|SUN)#([1-7])?) + | ([\?]) + | ([\*]) + ) + YEAR (OPTIONAL): + ( + [\s]? + ([\*])? + | ((19[7-9][0-9])|(20[0-9][0-9]))? + | (((19[7-9][0-9])|(20[0-9][0-9]))/((19[7-9][0-9])|(20[0-9][0-9])))? + | ((((19[7-9][0-9])|(20[0-9][0-9]))(-((19[7-9][0-9])|(20[0-9][0-9])))?,)*((19[7-9][0-9])|(20[0-9][0-9]))(-((19[7-9][0-9])|(20[0-9][0-9])))?)? + ) + + + + + + + + + + Number of times to repeat the Trigger (-1 for indefinite) + + + + + + + + + + Simple Trigger Misfire Instructions + + + + + + + + + + + + + + Cron Trigger Misfire Instructions + + + + + + + + + + + Date Interval Trigger Misfire Instructions + + + + + + + + + + + Interval Units + + + + + + + + + + + + + \ No newline at end of file diff --git a/ClickForensics.Quartz.Manager/packages.config b/ClickForensics.Quartz.Manager/packages.config index 4369105..94e8c3d 100644 --- a/ClickForensics.Quartz.Manager/packages.config +++ b/ClickForensics.Quartz.Manager/packages.config @@ -1,6 +1,6 @@  - + - + \ No newline at end of file diff --git a/packages/Common.Logging.2.0.0/Common.Logging.2.0.0.nupkg b/packages/Common.Logging.2.0.0/Common.Logging.2.0.0.nupkg deleted file mode 100644 index 7ad90ee..0000000 Binary files a/packages/Common.Logging.2.0.0/Common.Logging.2.0.0.nupkg and /dev/null differ diff --git a/packages/Common.Logging.2.0.0/lib/2.0/Common.Logging.dll b/packages/Common.Logging.2.0.0/lib/2.0/Common.Logging.dll deleted file mode 100644 index 5c1feac..0000000 Binary files a/packages/Common.Logging.2.0.0/lib/2.0/Common.Logging.dll and /dev/null differ diff --git a/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nupkg b/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nupkg new file mode 100644 index 0000000..80ffdfd Binary files /dev/null and b/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nupkg differ diff --git a/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nuspec b/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nuspec new file mode 100644 index 0000000..39f5300 --- /dev/null +++ b/packages/Common.Logging.2.1.2/Common.Logging.2.1.2.nuspec @@ -0,0 +1,13 @@ + + + + Common.Logging + 2.1.2 + Aleksandar Seovic, Mark Pollack, Erich Eichinger, Stephen Bohlen + Aleksandar Seovic, Mark Pollack, Erich Eichinger, Stephen Bohlen + http://netcommon.sourceforge.net/ + false + Common.Logging library introduces a simple abstraction to allow you to select a specific logging implementation at runtime. + en-US + + \ No newline at end of file diff --git a/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.dll b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.dll new file mode 100644 index 0000000..0c35fd3 Binary files /dev/null and b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.dll differ diff --git a/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.pdb b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.pdb new file mode 100644 index 0000000..d26b618 Binary files /dev/null and b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.pdb differ diff --git a/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.xml b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.xml new file mode 100644 index 0000000..66da79a --- /dev/null +++ b/packages/Common.Logging.2.1.2/lib/net35/Common.Logging.xml @@ -0,0 +1,3304 @@ + + + + Common.Logging + + + + + This assembly contains the core functionality of the Common.Logging framework. + In particular, checkout and for usage information. + + + + + Provides base implementation suitable for almost all logger adapters + + Erich Eichinger + + + + A simple logging interface abstracting logging APIs. + + + + Implementations should defer calling a message's until the message really needs + to be logged to avoid performance penalties. + + + Each log method offers to pass in a instead of the actual message. + Using this style has the advantage to defer possibly expensive message argument evaluation and formatting (and formatting arguments!) until the message gets + actually logged. If the message is not logged at all (e.g. due to settings), + you won't have to pay the peformance penalty of creating the message. + + + + The example below demonstrates using callback style for creating the message, where the call to the + and the underlying only happens, if level is enabled: + + Log.Debug( m=>m("result is {0}", random.NextDouble()) ); + Log.Debug(delegate(m) { m("result is {0}", random.NextDouble()); }); + + + + Mark Pollack + Bruno Baia + Erich Eichinger + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Holds the method for writing a message to the log system. + + + + + Creates a new logger instance using for + writing log events to the underlying log system. + + + + + + Override this method to use a different method than + for writing log events to the underlying log system. + + + Usually you don't need to override thise method. The default implementation returns + null to indicate that the default handler should be + used. + + + + + Actually sends the message to the underlying log system. + + the level of this log event. + the message to log + the exception to log (may be null) + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Debug of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Debug. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Info of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Info. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Warn of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Warn. + + + + Log a message with the level. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Error of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Error. + + + + Log a message with the level. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Fatal of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Fatal. + + + + Log a message with the level. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Format message on demand. + + + + + Initializes a new instance of the class. + + The format message callback. + + + + Initializes a new instance of the class. + + The format provider. + The format message callback. + + + + Calls and returns result. + + + + + + Format string on demand. + + + + + Initializes a new instance of the class. + + The format provider. + The message. + The args. + + + + Runs on supplied arguemnts. + + string + + + + Represents a method responsible for writing a message to the log system. + + + + + An implementation of that caches loggers handed out by this factory. + + + Implementors just need to override . + + Erich Eichinger + + + + LoggerFactoryAdapter interface is used internally by LogManager + Only developers wishing to write new Common.Logging adapters need to + worry about this interface. + + Gilles Bayon + + + + Get a ILog instance by type. + + The type to use for the logger + + + + + Get a ILog instance by name. + + The name of the logger + + + + + Creates a new instance, the logger cache being case-sensitive. + + + + + Creates a new instance, the logger cache being . + + + + + + Purges all loggers from cache + + + + + Create the specified named logger instance + + + Derived factories need to implement this method to create the + actual logger instance. + + + + + Get a ILog instance by . + + Usually the of the current class. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + Get a ILog instance by name. + + Usually a 's Name or FullName property. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + Get or create a ILog instance by name. + + Usually a 's Name or FullName property. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + A logger created by that + sends all log events to the owning adapter's + + Erich Eichinger + + + + Abstract class providing a standard implementation of simple loggers. + + Erich Eichinger + + + + Creates and initializes a the simple logger. + + The name, usually type name of the calling class, of the logger. + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + Include level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Appends the formatted message to the specified . + + the that receíves the formatted message. + + + + + + + Determines if the given log level is currently enabled. + + + + + + + The name of the logger. + + + + + Include the current log level in the log message. + + + + + Include the current time in the log message. + + + + + Include the instance name in the log message. + + + + + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + + + + + The date and time format to use in the log message. + + + + + Determines Whether is set. + + + + + Returns if the current is greater than or + equal to . If it is, all messages will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, all messages will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + , , , and + will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + , , and + will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + and will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + will be sent to . + + + + + The adapter that created this logger instance. + + + + + Clears all captured events + + + + + Resets the to null. + + + + + Holds the list of logged events. + + + To access this collection in a multithreaded application, put a lock on the list instance. + + + + + instances send their captured log events to this method. + + + + + Create a new logger instance. + + + + + Create a new and send it to + + + + + + + + Holds the last log event received from any of this adapter's loggers. + + + + + A logging event captured by + + Erich Eichinger + + + + The logger that logged this event + + + + + The level used to log this event + + + + + The raw message object + + + + + A logged exception + + + + + Create a new event instance + + + + + Retrieves the formatted message text + + + + + An adapter, who's loggers capture all log events and send them to . + Retrieve the list of log events from . + + + This logger factory is mainly for debugging and test purposes. + + This is an example how you might use this adapter for testing: + + // configure for capturing + CapturingLoggerFactoryAdapter adapter = new CapturingLoggerFactoryAdapter(); + LogManager.Adapter = adapter; + + // reset capture state + adapter.Clear(); + // log something + ILog log = LogManager.GetCurrentClassLogger(); + log.DebugFormat("Current Time:{0}", DateTime.Now); + + // check logged data + Assert.AreEqual(1, adapter.LoggerEvents.Count); + Assert.AreEqual(LogLevel.Debug, adapter.LastEvent.Level); + + + + Erich Eichinger + + + + Clears all captured events + + + + + Resets the to null. + + + + + Holds the list of logged events. + + + To access this collection in a multithreaded application, put a lock on the list instance. + + + + + instances send their captured log events to this method. + + + + + Get a instance for the given type. + + + + + Get a instance for the given name. + + + + + Holds the last log event received from any of this adapter's loggers. + + + + + A implementation sending all System.Diagnostics.Trace output to + the Common.Logging infrastructure. + + + This listener captures all output sent by calls to System.Diagnostics.Trace and + and and sends it to an instance.
+ The instance to be used is obtained by calling + . The name of the logger is created by passing + this listener's and any source or category passed + into this listener (see or for example). + + + The snippet below shows how to add and configure this listener to your app.config: + + <system.diagnostics> + <sharedListeners> + <add name="Diagnostics" + type="Common.Logging.Simple.CommonLoggingTraceListener, Common.Logging" + initializeData="DefaultTraceEventType=Information; LoggerNameFormat={listenerName}.{sourceName}"> + <filter type="System.Diagnostics.EventTypeFilter" initializeData="Information"/> + </add> + </sharedListeners> + <trace> + <listeners> + <add name="Diagnostics" /> + </listeners> + </trace> + </system.diagnostics> + + + Erich Eichinger + + + + Creates a new instance with the default name "Diagnostics" and "Trace". + + + + + Creates a new instance initialized with properties from the . string. + + + is a semicolon separated string of name/value pairs, where each pair has + the form key=value. E.g. + "Name=MyLoggerName;LogLevel=Debug" + + a semicolon separated list of name/value pairs. + + + + Creates a new instance initialized with the specified properties. + + name/value configuration properties. + + + + Logs the given message to the Common.Logging infrastructure. + + the eventType + the name or category name passed into e.g. . + the id of this event + the message format + the message arguments + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Sets the default to use for logging + all events emitted by .Write(...) and + .WriteLine(...) methods. + + + This listener captures all output sent by calls to and + sends it to an instance using the specified + on . + + + + + Format to use for creating the logger name. Defaults to "{listenerName}.{sourceName}". + + + Available placeholders are: + + {listenerName}: the configured name of this listener instance. + {sourceName}: the trace source name an event originates from (see e.g. . + + + + + + The exception that is thrown when a configuration system error has occurred with Common.Logging + + Mark Pollack + + + Creates a new instance of the ObjectsException class. + + + + Creates a new instance of the ConfigurationException class. with the specified message. + + + A message about the exception. + + + + + Creates a new instance of the ConfigurationException class with the specified message + and root cause. + + + A message about the exception. + + + The root exception that is being wrapped. + + + + + Creates a new instance of the ConfigurationException class. + + + The + that holds the serialized object data about the exception being thrown. + + + The + that contains contextual information about the source or destination. + + + + + Implementation of that uses the standard .NET + configuration APIs, ConfigurationSettings in 1.x and ConfigurationManager in 2.0 + + Mark Pollack + + + + Interface for basic operations to read .NET application configuration information. + + Provides a simple abstraction to handle BCL API differences between .NET 1.x and 2.0. Also + useful for testing scenarios. + Mark Pollack + + + + Parses the configuration section and returns the resulting object. + + +

+ Primary purpose of this method is to allow us to parse and + load configuration sections using the same API regardless + of the .NET framework version. +

+ + Name of the configuration section. + Object created by a corresponding . + + + + + Parses the configuration section and returns the resulting object. + + Name of the configuration section. + + Object created by a corresponding . + + +

+ Primary purpose of this method is to allow us to parse and + load configuration sections using the same API regardless + of the .NET framework version. +

+ + + + + + This namespace contains convenience base classes for implementing your own s. + + + + + Various utility methods for using during factory and logger instance configuration + + Erich Eichinger + + + + Initialize all members before any of this class' methods can be accessed (avoids beforeFieldInit) + + + + + Adds the parser to the list of known type parsers. + + + .NET intrinsic types are pre-registerd: short, int, long, float, double, decimal, bool + + + + + Retrieves the named value from the specified . + + may be null + the value's key + if is not null, the value returned by values[name]. null otherwise. + + + + Retrieves the named value from the specified . + + may be null + the value's key + the default value, if not found + if is not null, the value returned by values[name]. null otherwise. + + + + Returns the first nonnull, nonempty value among its arguments. + + + Returns null, if the initial list was null or empty. + + + + + + Returns the first nonnull, nonempty value among its arguments. + + + Also + + + + + Tries parsing into an enum of the type of . + + the default value to return if parsing fails + the string value to parse + the successfully parsed value, otherwise. + + + + Tries parsing into the specified return type. + + the default value to return if parsing fails + the string value to parse + the successfully parsed value, otherwise. + + + + Throws a if is null. + + + + + Throws a if is null. + + + + + Throws a if an object of type is not + assignable to type . + + + + + Throws a if an object of type is not + assignable to type . + + + + + Ensures any exception thrown by the given is wrapped with an + . + + + If already throws a ConfigurationException, it will not be wrapped. + + the action to execute + the message to be set on the thrown + args to be passed to to format the message + + + + Ensures any exception thrown by the given is wrapped with an + . + + + If already throws a ConfigurationException, it will not be wrapped. + + the action to execute + the message to be set on the thrown + args to be passed to to format the message + + + + A delegate converting a string representation into the target type + + + + + An anonymous action delegate with no arguments and no return value. + + + + + + An anonymous action delegate with no arguments and no return value. + + + + + + The type of method that is passed into e.g. + and allows the callback method to "submit" it's message to the underlying output system. + + the format argument as in + the argument list as in + + Erich Eichinger + + + + Used in an application's configuration file (App.Config or Web.Config) to configure the logging subsystem. + + + An example configuration section that writes log messages to the Console using the + built-in Console Logger. + + <configuration> + <configSections> + <sectionGroup name="common"> + <section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" /> + </sectionGroup> + </configSections> + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="showLogName" value="true" /> + <arg key="showDataTime" value="true" /> + <arg key="level" value="ALL" /> + <arg key="dateTimeFormat" value="yyyy/MM/dd HH:mm:ss:fff" /> + </factoryAdapter> + </logging> + </common> + </configuration> + + + + + + Ensure static fields get initialized before any class member + can be accessed (avoids beforeFieldInit) + + + + + Constructor + + + + + Retrieves the of the logger the use by looking at the logFactoryAdapter element + of the logging configuration element. + + + + A object containing the specified type that implements + along with zero or more properties that will be + passed to the logger factory adapter's constructor as an . + + + + + Verifies that the logFactoryAdapter element appears once in the configuration section. + + settings of a parent section - atm this must always be null + Additional information about the configuration process. + The configuration section to apply an XPath query too. + + A object containing the specified logFactoryAdapter type + along with user supplied configuration properties. + + + + + Verifies that the logFactoryAdapter element appears once in the configuration section. + + The parent of the current item. + Additional information about the configuration process. + The configuration section to apply an XPath query too. + + A object containing the specified logFactoryAdapter type + along with user supplied configuration properties. + + + + + The 7 possible logging levels + + Gilles Bayon + + + + All logging levels + + + + + A trace logging level + + + + + A debug logging level + + + + + A info logging level + + + + + A warn logging level + + + + + An error logging level + + + + + A fatal logging level + + + + + Do not log anything. + + + + + Use the LogManager's or + methods to obtain instances for logging. + + + For configuring the underlying log system using application configuration, see the example + at . + For configuring programmatically, see the example section below. + + + The example below shows the typical use of LogManager to obtain a reference to a logger + and log an exception: + + + ILog log = LogManager.GetLogger(this.GetType()); + ... + try + { + /* .... */ + } + catch(Exception ex) + { + log.ErrorFormat("Hi {0}", ex, "dude"); + } + + + The example below shows programmatic configuration of the underlying log system: + + + // create properties + NameValueCollection properties = new NameValueCollection(); + properties["showDateTime"] = "true"; + + // set Adapter + Common.Logging.LogManager.Adapter = new + Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter(properties); + + + + + + + + Gilles Bayon + + + + The name of the default configuration section to read settings from. + + + You can always change the source of your configuration settings by setting another instance + on . + + + + + Performs static 1-time init of LogManager by calling + + + + + Reset the infrastructure to its default settings. This means, that configuration settings + will be re-read from section <common/logging> of your app.config. + + + This is mainly used for unit testing, you wouldn't normally use this in your applications.
+ Note: instances already handed out from this LogManager are not(!) affected. + Resetting LogManager only affects new instances being handed out. + + + + + Reset the infrastructure to its default settings. This means, that configuration settings + will be re-read from section <common/logging> of your app.config. + + + This is mainly used for unit testing, you wouldn't normally use this in your applications.
+ Note: instances already handed out from this LogManager are not(!) affected. + Resetting LogManager only affects new instances being handed out. + + + the instance to obtain settings for + re-initializing the LogManager. + + + + + Gets the logger by calling + on the currently configured using the type of the calling class. + + + This method needs to inspect the in order to determine the calling + class. This of course comes with a performance penalty, thus you shouldn't call it too + often in your application. + + + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified type. + + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified type. + + The type. + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified name. + + The name. + the logger instance obtained from the current + + + + Builds the logger factory adapter. + + a factory adapter instance. Is never null. + + + + Builds a instance from the given + using . + + + the instance. Is never null + + + + Gets the configuration reader used to initialize the LogManager. + + Primarily used for testing purposes but maybe useful to obtain configuration + information from some place other than the .NET application configuration file. + The configuration reader. + + + + Gets or sets the adapter. + + The adapter. + + + + Container used to hold configuration information from config file. + + Gilles Bayon + + + + + + + The type + that will be used for creating + + + Additional user supplied properties that are passed to the + 's constructor. + + + + + The type that will be used for creating + instances. + + + + + Additional user supplied properties that are passed to the 's constructor. + + + + + This namespace contains all core classes making up the Common.Logging framework. + + + + + This namespace contains out-of-the-box adapters to intrinsic systems, namely + , and the + all output suppressing . + For unit testing, you may also want to have a look at + that allows to easily inspect logged messages. + To route messages logged through the infrastructure back into + Common.Logging, you can use + + + + + This namespace contains various utility classes. + + + + +

Overview

+ + There are a variety of logging implementations for .NET currently in use, log4net, Enterprise + Library Logging, NLog, to name the most popular. The downside of having differerent implementation + is that they do not share a common interface and therefore impose a particular logging + implementation on the users of your library. To solve this dependency problem the Common.Logging + library introduces a simple abstraction to allow you to select a specific logging implementation at + runtime. + + + The library is based on work done by the developers of IBatis.NET and it's usage is inspired by + log4net. Many thanks to the developers of those projects! + +

Usage

+ + The core logging library Common.Logging provides the base logging interface as + well as the global that you use to instrument your code: + + + ILog log = LogManager.GetLogger(this.GetType()); + + log.DebugFormat("Hi {0}", "dude"); + + + To output the information logged, you need to tell Common.Logging, what underlying logging system + to use. Common.Logging already includes simple console and trace based logger implementations + usable out of the box. Adding the following configuration snippet to your app.config causes + Common.Logging to output all information to the console: + + + <configuration> + <configSections> + <sectionGroup name="common"> + <section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="DEBUG" /> + </factoryAdapter> + </logging> + </common> + </configuration> + +

Customizing

+ + In the case you want to integrate your own logging system that is not supported by Common.Logging yet, it is easily + possible to implement your own plugin by implementing . + For convenience there is a base implementation available that usually + makes implementing your own adapter a breeze. + +

<system.diagnostics> Integration

+ + If your code already uses the .NET framework's built-in System.Diagnostics.Trace + system, you can use to redirect all trace output to the + Common.Logging infrastructure. + + + + + + Base factory implementation for creating simple instances. + + Default settings are LogLevel.All, showDateTime = true, showLogName = true, and no DateTimeFormat. + The keys in the NameValueCollection to configure this adapter are the following + + level + showDateTime + showLogName + dateTimeFormat + + + Here is an example how to implement your own logging adapter: + + public class ConsoleOutLogger : AbstractSimpleLogger + { + public ConsoleOutLogger(string logName, LogLevel logLevel, bool showLevel, bool showDateTime, + bool showLogName, string dateTimeFormat) + : base(logName, logLevel, showLevel, showDateTime, showLogName, dateTimeFormat) + { + } + + protected override void WriteInternal(LogLevel level, object message, Exception e) + { + // Use a StringBuilder for better performance + StringBuilder sb = new StringBuilder(); + FormatOutput(sb, level, message, e); + + // Print to the appropriate destination + Console.Out.WriteLine(sb.ToString()); + } + } + + public class ConsoleOutLoggerFactoryAdapter : AbstractSimpleLoggerFactoryAdapter + { + public ConsoleOutLoggerFactoryAdapter(NameValueCollection properties) + : base(properties) + { } + + protected override ILog CreateLogger(string name, LogLevel level, bool showLevel, bool + showDateTime, bool showLogName, string dateTimeFormat) + { + ILog log = new ConsoleOutLogger(name, level, showLevel, showDateTime, showLogName, + dateTimeFormat); + return log; + } + } + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Create the specified logger instance + + + + + Derived factories need to implement this method to create the + actual logger instance. + + a new logger instance. Must never be null! + + + + The default to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + Sends log messages to . + + Gilles Bayon + + + + Creates and initializes a logger that writes messages to . + + The name, usually type name of the calling class, of the logger. + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + Include the current log level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Do the actual logging by constructing the log message using a then + sending the output to . + + The of the message. + The log message. + An optional associated with the message. + + + + Factory for creating instances that write data to . + + + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class using default + settings. + + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Creates a new instance. + + + + + Silently ignores all log messages. + + Gilles Bayon + Erich Eichinger + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Factory for creating instances that silently ignores + logging requests. + + + This logger adapter is the default used by Common.Logging if unconfigured. Using this logger adapter is the most efficient + way to suppress any logging output. + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.NoOpLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + Gilles Bayon + + + + Constructor + + + + + Constructor + + + + + Get a ILog instance by type + + + + + + + Get a ILog instance by type name + + + + + + + Logger sending everything to the trace output stream using . + + + Beware not to use in combination with this logger as + this would result in an endless loop for obvious reasons! + + + + Gilles Bayon + Erich Eichinger + + + + Creates a new TraceLogger instance. + + whether to use or for logging. + the name of this logger + the default log level to use + Include the current log level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Determines if the given log level is currently enabled. + checks if is true. + + + + + Do the actual logging. + + + + + + + + Called after deserialization completed. + + + + + Used to defer message formatting until it is really needed. + + + This class also improves performance when multiple + s are configured. + + + + + Factory for creating instances that send + everything to the output stream. + + + Beware not to use in combination with this logger factory + as this would result in an endless loop for obvious reasons! + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.TraceLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class using default settings. + + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Creates a new instance. + + + + + Whether to use .TraceXXXX(string,object[]) methods for logging + or . + + + + + Indicates classes or members to be ignored by NCover + + + Note, the name is chosen, because TestDriven.NET uses it as //ea argument to "Test With... Coverage" + + Erich Eichinger + + + diff --git a/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.dll b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.dll new file mode 100644 index 0000000..d5a9c97 Binary files /dev/null and b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.dll differ diff --git a/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.pdb b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.pdb new file mode 100644 index 0000000..c0a1bda Binary files /dev/null and b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.pdb differ diff --git a/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.xml b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.xml new file mode 100644 index 0000000..66da79a --- /dev/null +++ b/packages/Common.Logging.2.1.2/lib/net40/Common.Logging.xml @@ -0,0 +1,3304 @@ + + + + Common.Logging + + + + + This assembly contains the core functionality of the Common.Logging framework. + In particular, checkout and for usage information. + + + + + Provides base implementation suitable for almost all logger adapters + + Erich Eichinger + + + + A simple logging interface abstracting logging APIs. + + + + Implementations should defer calling a message's until the message really needs + to be logged to avoid performance penalties. + + + Each log method offers to pass in a instead of the actual message. + Using this style has the advantage to defer possibly expensive message argument evaluation and formatting (and formatting arguments!) until the message gets + actually logged. If the message is not logged at all (e.g. due to settings), + you won't have to pay the peformance penalty of creating the message. + + + + The example below demonstrates using callback style for creating the message, where the call to the + and the underlying only happens, if level is enabled: + + Log.Debug( m=>m("result is {0}", random.NextDouble()) ); + Log.Debug(delegate(m) { m("result is {0}", random.NextDouble()); }); + + + + Mark Pollack + Bruno Baia + Erich Eichinger + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Checks if this logger is enabled for the level. + + + + + Holds the method for writing a message to the log system. + + + + + Creates a new logger instance using for + writing log events to the underlying log system. + + + + + + Override this method to use a different method than + for writing log events to the underlying log system. + + + Usually you don't need to override thise method. The default implementation returns + null to indicate that the default handler should be + used. + + + + + Actually sends the message to the underlying log system. + + the level of this log event. + the message to log + the exception to log (may be null) + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack trace of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack trace. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Debug of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Debug. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Info of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Info. + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Warn of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Warn. + + + + Log a message with the level. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Error of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Error. + + + + Log a message with the level. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Log a message object with the level. + + The message object to log. + + + + Log a message object with the level including + the stack Fatal of the passed + as a parameter. + + The message object to log. + The exception to log, including its stack Fatal. + + + + Log a message with the level. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + + + + + Log a message with the level. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + The exception to log. + + + + + Log a message with the level. + + The format of the message object to log. + the list of format arguments + + + + Log a message with the level. + + The format of the message object to log. + The exception to log. + the list of format arguments + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Log a message with the level using a callback to obtain the message + + + Using this method avoids the cost of creating a message and evaluating message arguments + that probably won't be logged due to loglevel settings. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Checks if this logger is enabled for the level. + + + Override this in your derived class to comply with the underlying logging system + + + + + Format message on demand. + + + + + Initializes a new instance of the class. + + The format message callback. + + + + Initializes a new instance of the class. + + The format provider. + The format message callback. + + + + Calls and returns result. + + + + + + Format string on demand. + + + + + Initializes a new instance of the class. + + The format provider. + The message. + The args. + + + + Runs on supplied arguemnts. + + string + + + + Represents a method responsible for writing a message to the log system. + + + + + An implementation of that caches loggers handed out by this factory. + + + Implementors just need to override . + + Erich Eichinger + + + + LoggerFactoryAdapter interface is used internally by LogManager + Only developers wishing to write new Common.Logging adapters need to + worry about this interface. + + Gilles Bayon + + + + Get a ILog instance by type. + + The type to use for the logger + + + + + Get a ILog instance by name. + + The name of the logger + + + + + Creates a new instance, the logger cache being case-sensitive. + + + + + Creates a new instance, the logger cache being . + + + + + + Purges all loggers from cache + + + + + Create the specified named logger instance + + + Derived factories need to implement this method to create the + actual logger instance. + + + + + Get a ILog instance by . + + Usually the of the current class. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + Get a ILog instance by name. + + Usually a 's Name or FullName property. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + Get or create a ILog instance by name. + + Usually a 's Name or FullName property. + + An ILog instance either obtained from the internal cache or created by a call to . + + + + + A logger created by that + sends all log events to the owning adapter's + + Erich Eichinger + + + + Abstract class providing a standard implementation of simple loggers. + + Erich Eichinger + + + + Creates and initializes a the simple logger. + + The name, usually type name of the calling class, of the logger. + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + Include level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Appends the formatted message to the specified . + + the that receíves the formatted message. + + + + + + + Determines if the given log level is currently enabled. + + + + + + + The name of the logger. + + + + + Include the current log level in the log message. + + + + + Include the current time in the log message. + + + + + Include the instance name in the log message. + + + + + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + + + + + The date and time format to use in the log message. + + + + + Determines Whether is set. + + + + + Returns if the current is greater than or + equal to . If it is, all messages will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, all messages will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + , , , and + will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + , , and + will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + and will be sent to . + + + + + Returns if the current is greater than or + equal to . If it is, only messages with a of + will be sent to . + + + + + The adapter that created this logger instance. + + + + + Clears all captured events + + + + + Resets the to null. + + + + + Holds the list of logged events. + + + To access this collection in a multithreaded application, put a lock on the list instance. + + + + + instances send their captured log events to this method. + + + + + Create a new logger instance. + + + + + Create a new and send it to + + + + + + + + Holds the last log event received from any of this adapter's loggers. + + + + + A logging event captured by + + Erich Eichinger + + + + The logger that logged this event + + + + + The level used to log this event + + + + + The raw message object + + + + + A logged exception + + + + + Create a new event instance + + + + + Retrieves the formatted message text + + + + + An adapter, who's loggers capture all log events and send them to . + Retrieve the list of log events from . + + + This logger factory is mainly for debugging and test purposes. + + This is an example how you might use this adapter for testing: + + // configure for capturing + CapturingLoggerFactoryAdapter adapter = new CapturingLoggerFactoryAdapter(); + LogManager.Adapter = adapter; + + // reset capture state + adapter.Clear(); + // log something + ILog log = LogManager.GetCurrentClassLogger(); + log.DebugFormat("Current Time:{0}", DateTime.Now); + + // check logged data + Assert.AreEqual(1, adapter.LoggerEvents.Count); + Assert.AreEqual(LogLevel.Debug, adapter.LastEvent.Level); + + + + Erich Eichinger + + + + Clears all captured events + + + + + Resets the to null. + + + + + Holds the list of logged events. + + + To access this collection in a multithreaded application, put a lock on the list instance. + + + + + instances send their captured log events to this method. + + + + + Get a instance for the given type. + + + + + Get a instance for the given name. + + + + + Holds the last log event received from any of this adapter's loggers. + + + + + A implementation sending all System.Diagnostics.Trace output to + the Common.Logging infrastructure. + + + This listener captures all output sent by calls to System.Diagnostics.Trace and + and and sends it to an instance.
+ The instance to be used is obtained by calling + . The name of the logger is created by passing + this listener's and any source or category passed + into this listener (see or for example). + + + The snippet below shows how to add and configure this listener to your app.config: + + <system.diagnostics> + <sharedListeners> + <add name="Diagnostics" + type="Common.Logging.Simple.CommonLoggingTraceListener, Common.Logging" + initializeData="DefaultTraceEventType=Information; LoggerNameFormat={listenerName}.{sourceName}"> + <filter type="System.Diagnostics.EventTypeFilter" initializeData="Information"/> + </add> + </sharedListeners> + <trace> + <listeners> + <add name="Diagnostics" /> + </listeners> + </trace> + </system.diagnostics> + + + Erich Eichinger + + + + Creates a new instance with the default name "Diagnostics" and "Trace". + + + + + Creates a new instance initialized with properties from the . string. + + + is a semicolon separated string of name/value pairs, where each pair has + the form key=value. E.g. + "Name=MyLoggerName;LogLevel=Debug" + + a semicolon separated list of name/value pairs. + + + + Creates a new instance initialized with the specified properties. + + name/value configuration properties. + + + + Logs the given message to the Common.Logging infrastructure. + + the eventType + the name or category name passed into e.g. . + the id of this event + the message format + the message arguments + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by . + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Writes message to logger provided by + + + + + Sets the default to use for logging + all events emitted by .Write(...) and + .WriteLine(...) methods. + + + This listener captures all output sent by calls to and + sends it to an instance using the specified + on . + + + + + Format to use for creating the logger name. Defaults to "{listenerName}.{sourceName}". + + + Available placeholders are: + + {listenerName}: the configured name of this listener instance. + {sourceName}: the trace source name an event originates from (see e.g. . + + + + + + The exception that is thrown when a configuration system error has occurred with Common.Logging + + Mark Pollack + + + Creates a new instance of the ObjectsException class. + + + + Creates a new instance of the ConfigurationException class. with the specified message. + + + A message about the exception. + + + + + Creates a new instance of the ConfigurationException class with the specified message + and root cause. + + + A message about the exception. + + + The root exception that is being wrapped. + + + + + Creates a new instance of the ConfigurationException class. + + + The + that holds the serialized object data about the exception being thrown. + + + The + that contains contextual information about the source or destination. + + + + + Implementation of that uses the standard .NET + configuration APIs, ConfigurationSettings in 1.x and ConfigurationManager in 2.0 + + Mark Pollack + + + + Interface for basic operations to read .NET application configuration information. + + Provides a simple abstraction to handle BCL API differences between .NET 1.x and 2.0. Also + useful for testing scenarios. + Mark Pollack + + + + Parses the configuration section and returns the resulting object. + + +

+ Primary purpose of this method is to allow us to parse and + load configuration sections using the same API regardless + of the .NET framework version. +

+ + Name of the configuration section. + Object created by a corresponding . + + + + + Parses the configuration section and returns the resulting object. + + Name of the configuration section. + + Object created by a corresponding . + + +

+ Primary purpose of this method is to allow us to parse and + load configuration sections using the same API regardless + of the .NET framework version. +

+ + + + + + This namespace contains convenience base classes for implementing your own s. + + + + + Various utility methods for using during factory and logger instance configuration + + Erich Eichinger + + + + Initialize all members before any of this class' methods can be accessed (avoids beforeFieldInit) + + + + + Adds the parser to the list of known type parsers. + + + .NET intrinsic types are pre-registerd: short, int, long, float, double, decimal, bool + + + + + Retrieves the named value from the specified . + + may be null + the value's key + if is not null, the value returned by values[name]. null otherwise. + + + + Retrieves the named value from the specified . + + may be null + the value's key + the default value, if not found + if is not null, the value returned by values[name]. null otherwise. + + + + Returns the first nonnull, nonempty value among its arguments. + + + Returns null, if the initial list was null or empty. + + + + + + Returns the first nonnull, nonempty value among its arguments. + + + Also + + + + + Tries parsing into an enum of the type of . + + the default value to return if parsing fails + the string value to parse + the successfully parsed value, otherwise. + + + + Tries parsing into the specified return type. + + the default value to return if parsing fails + the string value to parse + the successfully parsed value, otherwise. + + + + Throws a if is null. + + + + + Throws a if is null. + + + + + Throws a if an object of type is not + assignable to type . + + + + + Throws a if an object of type is not + assignable to type . + + + + + Ensures any exception thrown by the given is wrapped with an + . + + + If already throws a ConfigurationException, it will not be wrapped. + + the action to execute + the message to be set on the thrown + args to be passed to to format the message + + + + Ensures any exception thrown by the given is wrapped with an + . + + + If already throws a ConfigurationException, it will not be wrapped. + + the action to execute + the message to be set on the thrown + args to be passed to to format the message + + + + A delegate converting a string representation into the target type + + + + + An anonymous action delegate with no arguments and no return value. + + + + + + An anonymous action delegate with no arguments and no return value. + + + + + + The type of method that is passed into e.g. + and allows the callback method to "submit" it's message to the underlying output system. + + the format argument as in + the argument list as in + + Erich Eichinger + + + + Used in an application's configuration file (App.Config or Web.Config) to configure the logging subsystem. + + + An example configuration section that writes log messages to the Console using the + built-in Console Logger. + + <configuration> + <configSections> + <sectionGroup name="common"> + <section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" /> + </sectionGroup> + </configSections> + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="showLogName" value="true" /> + <arg key="showDataTime" value="true" /> + <arg key="level" value="ALL" /> + <arg key="dateTimeFormat" value="yyyy/MM/dd HH:mm:ss:fff" /> + </factoryAdapter> + </logging> + </common> + </configuration> + + + + + + Ensure static fields get initialized before any class member + can be accessed (avoids beforeFieldInit) + + + + + Constructor + + + + + Retrieves the of the logger the use by looking at the logFactoryAdapter element + of the logging configuration element. + + + + A object containing the specified type that implements + along with zero or more properties that will be + passed to the logger factory adapter's constructor as an . + + + + + Verifies that the logFactoryAdapter element appears once in the configuration section. + + settings of a parent section - atm this must always be null + Additional information about the configuration process. + The configuration section to apply an XPath query too. + + A object containing the specified logFactoryAdapter type + along with user supplied configuration properties. + + + + + Verifies that the logFactoryAdapter element appears once in the configuration section. + + The parent of the current item. + Additional information about the configuration process. + The configuration section to apply an XPath query too. + + A object containing the specified logFactoryAdapter type + along with user supplied configuration properties. + + + + + The 7 possible logging levels + + Gilles Bayon + + + + All logging levels + + + + + A trace logging level + + + + + A debug logging level + + + + + A info logging level + + + + + A warn logging level + + + + + An error logging level + + + + + A fatal logging level + + + + + Do not log anything. + + + + + Use the LogManager's or + methods to obtain instances for logging. + + + For configuring the underlying log system using application configuration, see the example + at . + For configuring programmatically, see the example section below. + + + The example below shows the typical use of LogManager to obtain a reference to a logger + and log an exception: + + + ILog log = LogManager.GetLogger(this.GetType()); + ... + try + { + /* .... */ + } + catch(Exception ex) + { + log.ErrorFormat("Hi {0}", ex, "dude"); + } + + + The example below shows programmatic configuration of the underlying log system: + + + // create properties + NameValueCollection properties = new NameValueCollection(); + properties["showDateTime"] = "true"; + + // set Adapter + Common.Logging.LogManager.Adapter = new + Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter(properties); + + + + + + + + Gilles Bayon + + + + The name of the default configuration section to read settings from. + + + You can always change the source of your configuration settings by setting another instance + on . + + + + + Performs static 1-time init of LogManager by calling + + + + + Reset the infrastructure to its default settings. This means, that configuration settings + will be re-read from section <common/logging> of your app.config. + + + This is mainly used for unit testing, you wouldn't normally use this in your applications.
+ Note: instances already handed out from this LogManager are not(!) affected. + Resetting LogManager only affects new instances being handed out. + + + + + Reset the infrastructure to its default settings. This means, that configuration settings + will be re-read from section <common/logging> of your app.config. + + + This is mainly used for unit testing, you wouldn't normally use this in your applications.
+ Note: instances already handed out from this LogManager are not(!) affected. + Resetting LogManager only affects new instances being handed out. + + + the instance to obtain settings for + re-initializing the LogManager. + + + + + Gets the logger by calling + on the currently configured using the type of the calling class. + + + This method needs to inspect the in order to determine the calling + class. This of course comes with a performance penalty, thus you shouldn't call it too + often in your application. + + + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified type. + + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified type. + + The type. + the logger instance obtained from the current + + + + Gets the logger by calling + on the currently configured using the specified name. + + The name. + the logger instance obtained from the current + + + + Builds the logger factory adapter. + + a factory adapter instance. Is never null. + + + + Builds a instance from the given + using . + + + the instance. Is never null + + + + Gets the configuration reader used to initialize the LogManager. + + Primarily used for testing purposes but maybe useful to obtain configuration + information from some place other than the .NET application configuration file. + The configuration reader. + + + + Gets or sets the adapter. + + The adapter. + + + + Container used to hold configuration information from config file. + + Gilles Bayon + + + + + + + The type + that will be used for creating + + + Additional user supplied properties that are passed to the + 's constructor. + + + + + The type that will be used for creating + instances. + + + + + Additional user supplied properties that are passed to the 's constructor. + + + + + This namespace contains all core classes making up the Common.Logging framework. + + + + + This namespace contains out-of-the-box adapters to intrinsic systems, namely + , and the + all output suppressing . + For unit testing, you may also want to have a look at + that allows to easily inspect logged messages. + To route messages logged through the infrastructure back into + Common.Logging, you can use + + + + + This namespace contains various utility classes. + + + + +

Overview

+ + There are a variety of logging implementations for .NET currently in use, log4net, Enterprise + Library Logging, NLog, to name the most popular. The downside of having differerent implementation + is that they do not share a common interface and therefore impose a particular logging + implementation on the users of your library. To solve this dependency problem the Common.Logging + library introduces a simple abstraction to allow you to select a specific logging implementation at + runtime. + + + The library is based on work done by the developers of IBatis.NET and it's usage is inspired by + log4net. Many thanks to the developers of those projects! + +

Usage

+ + The core logging library Common.Logging provides the base logging interface as + well as the global that you use to instrument your code: + + + ILog log = LogManager.GetLogger(this.GetType()); + + log.DebugFormat("Hi {0}", "dude"); + + + To output the information logged, you need to tell Common.Logging, what underlying logging system + to use. Common.Logging already includes simple console and trace based logger implementations + usable out of the box. Adding the following configuration snippet to your app.config causes + Common.Logging to output all information to the console: + + + <configuration> + <configSections> + <sectionGroup name="common"> + <section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="DEBUG" /> + </factoryAdapter> + </logging> + </common> + </configuration> + +

Customizing

+ + In the case you want to integrate your own logging system that is not supported by Common.Logging yet, it is easily + possible to implement your own plugin by implementing . + For convenience there is a base implementation available that usually + makes implementing your own adapter a breeze. + +

<system.diagnostics> Integration

+ + If your code already uses the .NET framework's built-in System.Diagnostics.Trace + system, you can use to redirect all trace output to the + Common.Logging infrastructure. + + + + + + Base factory implementation for creating simple instances. + + Default settings are LogLevel.All, showDateTime = true, showLogName = true, and no DateTimeFormat. + The keys in the NameValueCollection to configure this adapter are the following + + level + showDateTime + showLogName + dateTimeFormat + + + Here is an example how to implement your own logging adapter: + + public class ConsoleOutLogger : AbstractSimpleLogger + { + public ConsoleOutLogger(string logName, LogLevel logLevel, bool showLevel, bool showDateTime, + bool showLogName, string dateTimeFormat) + : base(logName, logLevel, showLevel, showDateTime, showLogName, dateTimeFormat) + { + } + + protected override void WriteInternal(LogLevel level, object message, Exception e) + { + // Use a StringBuilder for better performance + StringBuilder sb = new StringBuilder(); + FormatOutput(sb, level, message, e); + + // Print to the appropriate destination + Console.Out.WriteLine(sb.ToString()); + } + } + + public class ConsoleOutLoggerFactoryAdapter : AbstractSimpleLoggerFactoryAdapter + { + public ConsoleOutLoggerFactoryAdapter(NameValueCollection properties) + : base(properties) + { } + + protected override ILog CreateLogger(string name, LogLevel level, bool showLevel, bool + showDateTime, bool showLogName, string dateTimeFormat) + { + ILog log = new ConsoleOutLogger(name, level, showLevel, showDateTime, showLogName, + dateTimeFormat); + return log; + } + } + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Create the specified logger instance + + + + + Derived factories need to implement this method to create the + actual logger instance. + + a new logger instance. Must never be null! + + + + The default to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + The default setting to use when creating new instances. + + + + + Sends log messages to . + + Gilles Bayon + + + + Creates and initializes a logger that writes messages to . + + The name, usually type name of the calling class, of the logger. + The current logging threshold. Messages recieved that are beneath this threshold will not be logged. + Include the current log level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Do the actual logging by constructing the log message using a then + sending the output to . + + The of the message. + The log message. + An optional associated with the message. + + + + Factory for creating instances that write data to . + + + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.ConsoleOutLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class using default + settings. + + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Creates a new instance. + + + + + Silently ignores all log messages. + + Gilles Bayon + Erich Eichinger + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack trace. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Debug. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting information. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Info. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Warnrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Warn. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Errorrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Error. + + + + Ignores message. + + + + + + Ignores message. + + + + + + + Ignores message. + + The format of the message object to log. + + + + + Ignores message. + + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + the list of message format arguments + + + + Ignores message. + + An that supplies culture-specific formatting Fatalrmation. + The format of the message object to log. + The exception to log. + the list of message format arguments + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + + + + Ignores message. + + An that supplies culture-specific formatting information. + A callback used by the logger to obtain the message if log level is matched + The exception to log, including its stack Fatal. + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Always returns . + + + + + Factory for creating instances that silently ignores + logging requests. + + + This logger adapter is the default used by Common.Logging if unconfigured. Using this logger adapter is the most efficient + way to suppress any logging output. + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.NoOpLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + Gilles Bayon + + + + Constructor + + + + + Constructor + + + + + Get a ILog instance by type + + + + + + + Get a ILog instance by type name + + + + + + + Logger sending everything to the trace output stream using . + + + Beware not to use in combination with this logger as + this would result in an endless loop for obvious reasons! + + + + Gilles Bayon + Erich Eichinger + + + + Creates a new TraceLogger instance. + + whether to use or for logging. + the name of this logger + the default log level to use + Include the current log level in the log message. + Include the current time in the log message. + Include the instance name in the log message. + The date and time format to use in the log message. + + + + Determines if the given log level is currently enabled. + checks if is true. + + + + + Do the actual logging. + + + + + + + + Called after deserialization completed. + + + + + Used to defer message formatting until it is really needed. + + + This class also improves performance when multiple + s are configured. + + + + + Factory for creating instances that send + everything to the output stream. + + + Beware not to use in combination with this logger factory + as this would result in an endless loop for obvious reasons! + + Below is an example how to configure this adapter: + + <configuration> + + <configSections> + <sectionGroup name="common"> + <section name="logging" + type="Common.Logging.ConfigurationSectionHandler, Common.Logging" + requirePermission="false" /> + </sectionGroup> + </configSections> + + <common> + <logging> + <factoryAdapter type="Common.Logging.Simple.TraceLoggerFactoryAdapter, Common.Logging"> + <arg key="level" value="ALL" /> + </factoryAdapter> + </logging> + </common> + + </configuration> + + + + + + + Gilles Bayon + Mark Pollack + Erich Eichinger + + + + Initializes a new instance of the class using default settings. + + + + + Initializes a new instance of the class. + + + Looks for level, showDateTime, showLogName, dateTimeFormat items from + for use when the GetLogger methods are called. + for more information on how to use the + standard .NET application configuraiton file (App.config/Web.config) + to configure this adapter. + + The name value collection, typically specified by the user in + a configuration section named common/logging. + + + + Initializes a new instance of the class with + default settings for the loggers created by this factory. + + + + + Creates a new instance. + + + + + Whether to use .TraceXXXX(string,object[]) methods for logging + or . + + + + + Indicates classes or members to be ignored by NCover + + + Note, the name is chosen, because TestDriven.NET uses it as //ea argument to "Test With... Coverage" + + Erich Eichinger + + + diff --git a/packages/Quartz.2.0.1/Quartz.2.0.1.nupkg b/packages/Quartz.2.0.1/Quartz.2.0.1.nupkg deleted file mode 100644 index f64f3be..0000000 Binary files a/packages/Quartz.2.0.1/Quartz.2.0.1.nupkg and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35-client/C5.dll b/packages/Quartz.2.0.1/lib/net35-client/C5.dll deleted file mode 100644 index 2130d1f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35-client/C5.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35-client/Quartz.dll b/packages/Quartz.2.0.1/lib/net35-client/Quartz.dll deleted file mode 100644 index a324bd5..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35-client/Quartz.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35-client/Quartz.pdb b/packages/Quartz.2.0.1/lib/net35-client/Quartz.pdb deleted file mode 100644 index ae11611..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35-client/Quartz.pdb and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35/C5.dll b/packages/Quartz.2.0.1/lib/net35/C5.dll deleted file mode 100644 index 2130d1f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35/C5.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35/Quartz.dll b/packages/Quartz.2.0.1/lib/net35/Quartz.dll deleted file mode 100644 index c7d9e64..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35/Quartz.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net35/Quartz.pdb b/packages/Quartz.2.0.1/lib/net35/Quartz.pdb deleted file mode 100644 index e95389f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net35/Quartz.pdb and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40-client/C5.dll b/packages/Quartz.2.0.1/lib/net40-client/C5.dll deleted file mode 100644 index 2130d1f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40-client/C5.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40-client/Quartz.dll b/packages/Quartz.2.0.1/lib/net40-client/Quartz.dll deleted file mode 100644 index f04797f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40-client/Quartz.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40-client/Quartz.pdb b/packages/Quartz.2.0.1/lib/net40-client/Quartz.pdb deleted file mode 100644 index 7dd4a17..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40-client/Quartz.pdb and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40/C5.dll b/packages/Quartz.2.0.1/lib/net40/C5.dll deleted file mode 100644 index 2130d1f..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40/C5.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40/Quartz.dll b/packages/Quartz.2.0.1/lib/net40/Quartz.dll deleted file mode 100644 index 9b35e47..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40/Quartz.dll and /dev/null differ diff --git a/packages/Quartz.2.0.1/lib/net40/Quartz.pdb b/packages/Quartz.2.0.1/lib/net40/Quartz.pdb deleted file mode 100644 index 5fee49e..0000000 Binary files a/packages/Quartz.2.0.1/lib/net40/Quartz.pdb and /dev/null differ diff --git a/packages/Quartz.2.2/Quartz.2.2.nupkg b/packages/Quartz.2.2/Quartz.2.2.nupkg new file mode 100644 index 0000000..9556eb0 Binary files /dev/null and b/packages/Quartz.2.2/Quartz.2.2.nupkg differ diff --git a/packages/Quartz.2.2/Quartz.2.2.nuspec b/packages/Quartz.2.2/Quartz.2.2.nuspec new file mode 100644 index 0000000..a67b078 --- /dev/null +++ b/packages/Quartz.2.2/Quartz.2.2.nuspec @@ -0,0 +1,58 @@ + + + + Quartz + 2.2 + Quartz.NET + Marko Lahma + Marko Lahma + http://www.quartz-scheduler.net/ + false + Quartz.NET Scheduling Framework for .NET Platform + This release contains important bug fixes, new functionality and minor breaking changes. + +UPGRADING + +Database schema upgrade is needed from 2.x series to 2.2: + + * SQL Server: alter table QRTZ_FIRED_TRIGGERS add SCHED_TIME [BIGINT] NOT NULL; + * MySQL: alter table QRTZ_FIRED_TRIGGERS add SCHED_TIME BIGINT(19) NOT NULL + * Oracle: alter table QRTZ_FIRED_TRIGGERS add SCHED_TIME NUMBER(19) NOT NULL + * this adds a new column SCHED_TIME to table QRTZ_FIRED_TRIGGERS + +BREAKING CHANGES + + * database schema needs upgrade + * add SchedulerStarting() method to ISchedulerListener interface + * make the scheduler's TypeLoadHelper available to plugins when they are initialized + * dbFailureRetryInterval parameter was removed from DirectSchedulerFactory APIs + +NEW FEATURES + + * ability to override worker thread names (when using SimpleThreadPool) + * add new IScheduler method: ScheduleJob(IJobDetail job, ISet trigger) to schedule multiple triggers for a job all at once + * allow 'triggerless' initial storing of non-durable jobs. + * improvements for job recovery information + * package job_scheduling_data_2_0.xsd to nuget package's content folder + * allow scheduler exported with remoting to be used from local machine only + * support for Oracle managed ODP driver + +FIXES + + * job ending with exception and trigger not going to fire again, trigger is incorrectly not removed from job store + * XML schema supports multiple schedule elements but processor does not + * DailyTimeIntervalTriggerPersistenceDelegate does not handle empty time interval properly + * DailyTimeIntervalScheduleBuilder.EndingDailyAfterCount(...) doesn't pass validation + * trace throwing exception + * bug in QuartzSchedulerThread.GetRandomizedIdleWaitTime() + * can't delete or replace job without the referenced class + +MISC + +* Performance improvements, including improvements to some select statements in AdoJobStore + en-US + + + + + \ No newline at end of file diff --git a/packages/Quartz.2.2/content/job_scheduling_data_2_0.xsd b/packages/Quartz.2.2/content/job_scheduling_data_2_0.xsd new file mode 100644 index 0000000..64ab996 --- /dev/null +++ b/packages/Quartz.2.2/content/job_scheduling_data_2_0.xsd @@ -0,0 +1,361 @@ + + + + + + + Root level node + + + + + + Commands to be executed before scheduling the jobs and triggers in this file. + + + + + Directives to be followed while scheduling the jobs and triggers in this file. + + + + + + + + + + + + + + Version of the XML Schema instance + + + + + + + + + + Delete all jobs, if any, in the identified group. "*" can be used to identify all groups. Will also result in deleting all triggers related to the jobs. + + + + + Delete all triggers, if any, in the identified group. "*" can be used to identify all groups. Will also result in deletion of related jobs that are non-durable. + + + + + Delete the identified job if it exists (will also result in deleting all triggers related to it). + + + + + + + + + + + Delete the identified trigger if it exists (will also result in deletion of related jobs that are non-durable). + + + + + + + + + + + + + + + + Whether the existing scheduling data (with same identifiers) will be overwritten. If false, and ignore-duplicates is not false, and jobs or triggers with the same names already exist as those in the file, an error will occur. + + + + + If true (and overwrite-existing-data is false) then any job/triggers encountered in this file that have names that already exist in the scheduler will be ignored, and no error will be produced. + + + + + If true trigger's start time is calculated based on earlier run time instead of fixed value. Trigger's start time must be undefined for this to work. + + + + + + + + Define a JobDetail + + + + + + + + + + + + + + + + + Define a JobDataMap + + + + + + + + + Define a JobDataMap entry + + + + + + + + + + Define a Trigger + + + + + + + + + + + Common Trigger definitions + + + + + + + + + + + + + + + + + + + + + + + Define a SimpleTrigger + + + + + + + + + + + + + + + + + Define a CronTrigger + + + + + + + + + + + + + + + Define a DateIntervalTrigger + + + + + + + + + + + + + + + + Cron expression (see JavaDoc for examples) + + Special thanks to Chris Thatcher (thatcher@butterfly.net) for the regular expression! + + Regular expressions are not my strong point but I believe this is complete, + with the caveat that order for expressions like 3-0 is not legal but will pass, + and month and day names must be capitalized. + If you want to examine the correctness look for the [\s] to denote the + seperation of individual regular expressions. This is how I break them up visually + to examine them: + + SECONDS: + ( + ((([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?,)*([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?) + | (([\*]|[0-9]|[0-5][0-9])/([0-9]|[0-5][0-9])) + | ([\?]) + | ([\*]) + ) [\s] + MINUTES: + ( + ((([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?,)*([0-9]|[0-5][0-9])(-([0-9]|[0-5][0-9]))?) + | (([\*]|[0-9]|[0-5][0-9])/([0-9]|[0-5][0-9])) + | ([\?]) + | ([\*]) + ) [\s] + HOURS: + ( + ((([0-9]|[0-1][0-9]|[2][0-3])(-([0-9]|[0-1][0-9]|[2][0-3]))?,)*([0-9]|[0-1][0-9]|[2][0-3])(-([0-9]|[0-1][0-9]|[2][0-3]))?) + | (([\*]|[0-9]|[0-1][0-9]|[2][0-3])/([0-9]|[0-1][0-9]|[2][0-3])) + | ([\?]) + | ([\*]) + ) [\s] + DAY OF MONTH: + ( + ((([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(-([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1]))?,)*([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(-([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1]))?(C)?) + | (([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])/([1-9]|[0][1-9]|[1-2][0-9]|[3][0-1])(C)?) + | (L(-[0-9])?) + | (L(-[1-2][0-9])?) + | (L(-[3][0-1])?) + | (LW) + | ([1-9]W) + | ([1-3][0-9]W) + | ([\?]) + | ([\*]) + )[\s] + MONTH: + ( + ((([1-9]|0[1-9]|1[0-2])(-([1-9]|0[1-9]|1[0-2]))?,)*([1-9]|0[1-9]|1[0-2])(-([1-9]|0[1-9]|1[0-2]))?) + | (([1-9]|0[1-9]|1[0-2])/([1-9]|0[1-9]|1[0-2])) + | (((JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)(-(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC))?,)*(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)(-(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC))?) + | ((JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)/(JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)) + | ([\?]) + | ([\*]) + )[\s] + DAY OF WEEK: + ( + (([1-7](-([1-7]))?,)*([1-7])(-([1-7]))?) + | ([1-7]/([1-7])) + | (((MON|TUE|WED|THU|FRI|SAT|SUN)(-(MON|TUE|WED|THU|FRI|SAT|SUN))?,)*(MON|TUE|WED|THU|FRI|SAT|SUN)(-(MON|TUE|WED|THU|FRI|SAT|SUN))?(C)?) + | ((MON|TUE|WED|THU|FRI|SAT|SUN)/(MON|TUE|WED|THU|FRI|SAT|SUN)(C)?) + | (([1-7]|(MON|TUE|WED|THU|FRI|SAT|SUN))(L|LW)?) + | (([1-7]|MON|TUE|WED|THU|FRI|SAT|SUN)#([1-7])?) + | ([\?]) + | ([\*]) + ) + YEAR (OPTIONAL): + ( + [\s]? + ([\*])? + | ((19[7-9][0-9])|(20[0-9][0-9]))? + | (((19[7-9][0-9])|(20[0-9][0-9]))/((19[7-9][0-9])|(20[0-9][0-9])))? + | ((((19[7-9][0-9])|(20[0-9][0-9]))(-((19[7-9][0-9])|(20[0-9][0-9])))?,)*((19[7-9][0-9])|(20[0-9][0-9]))(-((19[7-9][0-9])|(20[0-9][0-9])))?)? + ) + + + + + + + + + + Number of times to repeat the Trigger (-1 for indefinite) + + + + + + + + + + Simple Trigger Misfire Instructions + + + + + + + + + + + + + + Cron Trigger Misfire Instructions + + + + + + + + + + + Date Interval Trigger Misfire Instructions + + + + + + + + + + + Interval Units + + + + + + + + + + + + + \ No newline at end of file diff --git a/packages/Quartz.2.2/lib/net35-client/Quartz.dll b/packages/Quartz.2.2/lib/net35-client/Quartz.dll new file mode 100644 index 0000000..39465a3 Binary files /dev/null and b/packages/Quartz.2.2/lib/net35-client/Quartz.dll differ diff --git a/packages/Quartz.2.2/lib/net35-client/Quartz.pdb b/packages/Quartz.2.2/lib/net35-client/Quartz.pdb new file mode 100644 index 0000000..2cbc9e8 Binary files /dev/null and b/packages/Quartz.2.2/lib/net35-client/Quartz.pdb differ diff --git a/packages/Quartz.2.0.1/lib/net40/Quartz.xml b/packages/Quartz.2.2/lib/net35-client/Quartz.xml similarity index 94% rename from packages/Quartz.2.0.1/lib/net40/Quartz.xml rename to packages/Quartz.2.2/lib/net35-client/Quartz.xml index de320e2..9ee197f 100644 --- a/packages/Quartz.2.0.1/lib/net40/Quartz.xml +++ b/packages/Quartz.2.2/lib/net35-client/Quartz.xml @@ -42,6 +42,13 @@ + + + Initializes a new instance of the class. + + The internal set to wrap. + internalSet + Simple C5 wrapper for common interface. @@ -270,6 +277,11 @@ that it has started. + + + Called by the to inform the listener that it is starting. + + Called by the to inform the listener @@ -313,7 +325,7 @@ The instance that should be made available within the . - + @@ -348,24 +360,6 @@ Passivates this instance. - - - Completes the trigger retry loop. - - The trigger. - The job detail. - The inst code. - - - - - Vetoeds the job retry loop. - - The trigger. - The job detail. - The inst code. - - Default concrete implementation of . @@ -653,7 +647,7 @@ true if the identified listener was found in the list, andremoved. - + Create a with the given configuration properties. @@ -1594,7 +1588,7 @@ Signals the main processing loop to pause at the next possible point. - + Signals the main processing loop to pause at the next possible point. @@ -1616,18 +1610,6 @@ The main processing loop of the . - - - Trigger retry loop that is executed on error condition. - - The bndle. - - - - Releases the trigger retry loop. - - The trigger. - Gets the log. @@ -1646,12 +1628,6 @@ true if paused; otherwise, false. - - - Gets or sets the db failure retry interval. - - The db failure retry interval. - An interface to be used by instances in order to @@ -1685,6 +1661,11 @@ Signals the scheduling change. + + + Informs scheduler listeners about an exception that has occurred. + + Notifies the scheduler about misfired trigger. @@ -1834,6 +1815,11 @@ Marko Lahma + + + Initializes the db provider implementation. + + Returns a new command object for executing SQL statments/Stored Procedures @@ -1873,12 +1859,10 @@ Connection string used to create connections. - + - Registers DB metadata information for given provider name. + Parse metadata once in static constructor. - - @@ -1887,6 +1871,13 @@ Name of the db provider. The connection string. + + + Registers DB metadata information for given provider name. + + + + Returns a new command object for executing SQL statments/Stored Procedures @@ -2144,25 +2135,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - - Determine whether the calling thread owns a lock on the identified - resource. - - Whether this Semaphore implementation requires a database connection for its lock management operations. - - + @@ -2205,20 +2189,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - + Determine whether the calling thread owns a lock on the identified resource. - @@ -2318,6 +2300,11 @@ The fire timestamp. + + + Gets or sets the scheduled fire timestamp. + + Gets or sets a value indicating whether job disallows concurrent execution. @@ -2770,12 +2757,12 @@ Select the job to which the trigger is associated. - The DB Connection - The key identifying the trigger. - The load helper. - - The object associated with the given trigger - + + + + Select the job to which the trigger is associated. Allow option to load actual job class or not. When case of + remove, we do not need to load the type, which in many cases, it's no longer exists. + @@ -3870,14 +3857,14 @@ Delete a job and its listeners. - + Delete a trigger, its listeners, and its Simple/Cron/BLOB sub-table entry. - + @@ -4290,7 +4277,7 @@ if set to true opens a new transaction. JobPersistenceException thrown if a SQLException occurs when the - + Execute the given callback in a transaction. Depending on the JobStore, the surrounding transaction may be assumed to be already present @@ -4299,27 +4286,8 @@ This method just forwards to ExecuteInLock() with a null lockName. - - - - - Execute the given callback having acquired the given lock. - Depending on the JobStore, the surrounding transaction may be - assumed to be already present (managed). This version is just a - handy wrapper around executeInLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a transaction. - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having acquired the given lock. Depending on the JobStore, the surrounding transaction may be @@ -4334,24 +4302,7 @@ The callback to excute after having acquired the given lock. - - - Execute the given callback having optionally acquired the given lock. - This uses the non-managed transaction connection. This version is just a - handy wrapper around executeInNonManagedTXLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a non-managed transaction. - - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having optionally acquired the given lock. This uses the non-managed transaction connection. @@ -4364,12 +4315,18 @@ The callback to excute after having acquired the given lock. + Get or set the datasource name. + + + Get or set the database connection manager. + + Gets the log. @@ -4430,14 +4387,21 @@ Whether or not to obtain locks when inserting new jobs/triggers. - Defaults to , which is safest - some db's (such as - MS SQLServer) seem to require this to avoid deadlocks under high load, - while others seem to do fine without. + + Defaults to , which is safest - some db's (such as + MS SQLServer) seem to require this to avoid deadlocks under high load, + while others seem to do fine without. Settings this to false means + isolation guarantees between job scheduling and trigger acquisition are + entirely enforced by the database. Depending on the database and it's + configuration this may cause unusual scheduling behaviors. + + Setting this property to will provide a significant performance increase during the addition of new jobs and triggers. + @@ -4612,15 +4576,15 @@ - + Execute the given callback having optionally acquired the given lock. Because CMT assumes that the connection is already part of a managed transaction, it does not attempt to commit or rollback the enclosing transaction. - - + + @@ -4630,6 +4594,11 @@ Callback to execute. + + + Instructs this job store whether connections should be automatically opened. + + is meant to be used in a standalone environment. @@ -4654,7 +4623,7 @@ - + Execute the given callback having optionally aquired the given lock. For , because it manages its own transactions @@ -5132,15 +5101,6 @@ the key of the job the number of triggers for the given job - - - Select the job to which the trigger is associated. - - the DB Connection - the key of the trigger - The load helper. - The object associated with the given trigger - Select the triggers for a job @@ -5633,12 +5593,12 @@ True if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - + Determine whether the calling thread owns a lock on the identified resource. @@ -5656,9 +5616,9 @@ its lock management operations. - + - + @@ -5695,6 +5655,11 @@ James House Marko Lahma (.NET) + + + Initializes a new instance of the class. + + Initializes a new instance of the class. @@ -6883,7 +6848,7 @@ - + James House @@ -6926,13 +6891,21 @@ - + James House Sharada Jambula Marko Lahma (.NET) + + + Get a that is configured to produce a + trigger identical to this one. + + + + Get a that is configured to produce a @@ -7640,7 +7613,7 @@ - + 2.0 James House Marko Lahma (.NET) @@ -7893,15 +7866,6 @@ valid for submission into a . - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - Get the time at which the should occur. @@ -8744,11 +8708,6 @@ Zemian Deng saltnlight5@gmail.com Nuno Maia (.NET) - - - - - Get the the number of times for interval this trigger should repeat, @@ -8793,6 +8752,14 @@ Get the number of times the has already fired. + + + Gets the time zone within which time calculations related to this trigger will be performed. + + + If null, the system default TimeZone will be used. + + Used to indicate the 'repeat count' of the trigger is indefinite. Or in @@ -8859,7 +8826,7 @@ , , and . The number of milliseconds to pause between the repeat firing. - + Create a that will occur at the given time, fire the identified job and repeat at the the given @@ -9562,7 +9529,7 @@ the default value, which is currently 30000 ms. The db failure retry interval. - + Creates a scheduler using the specified thread pool and job store and binds it for remote access. @@ -9574,10 +9541,26 @@ The type of job store The idle wait time. You can specify TimeSpan.Zero for - the default value, which is currently 30000 ms. - The db failure retry interval. + the default value, which is currently 30000 ms. + The maximum batch size of triggers, when acquiring them + The time window for which it is allowed to "pre-acquire" triggers to fire + + + + Creates a scheduler using the specified thread pool and job store and + binds it for remote access. + + The name for the scheduler. + The instance ID for the scheduler. + The thread pool for executing jobs + Thread executor. + The type of job store + + The idle wait time. You can specify TimeSpan.Zero for + the default value, which is currently 30000 ms. The maximum batch size of triggers, when acquiring them The time window for which it is allowed to "pre-acquire" triggers to fire + The scheduler exporter to use @@ -9710,7 +9693,7 @@ - + Whether the associated Job class carries the . @@ -9742,7 +9725,7 @@ Create a with the given name, default group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9752,7 +9735,7 @@ Create a with the given name, and group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9764,7 +9747,7 @@ the given settings of all the other properties. The name. - if , Scheduler.DefaultGroup will be used. + if , SchedulerConstants.DefaultGroup will be used. Type of the job. if set to true, job will be durable. if set to true, job will request recovery. @@ -9907,7 +9890,7 @@ Whether the associated Job class carries the attribute. - + Whether the associated Job class carries the attribute. @@ -10009,6 +9992,19 @@ situation, this method will return . + + + Returns the of the originally scheduled and now recovering job. + + + When recovering a previously failed job execution this property returns the identity + of the originally firing trigger. This recovering job will have been scheduled for + the same firing time as the original job, and so is available via the + property. The original firing time of the job can be + accessed via the + element of this job's . + + Gets the refire count. @@ -10495,8 +10491,7 @@ Halts the 's firing of s, - and cleans up all resources associated with the Scheduler. Equivalent to - . + and cleans up all resources associated with the Scheduler. Equivalent to Shutdown(false). The scheduler cannot be re-started. @@ -10534,7 +10529,7 @@ identified by the 's settings. - + Schedule all of the given jobs with the related set of triggers. @@ -10544,6 +10539,19 @@ parameter is not set to true then an exception will be thrown. + + + Schedule the given job with the related set of triggers. + + + If any of the given job or triggers already exist (or more + specifically, if the keys are not unique) and the replace + parameter is not set to true then an exception will be thrown. + + + + + Remove the indicated from the scheduler. @@ -10595,6 +10603,20 @@ SchedulerException will be thrown. + + + Add the given to the Scheduler - with no associated + . The will be 'dormant' until + it is scheduled with a , or + is called for it. + + + With the parameter + set to true, a non-durable job can be stored. Once it is + scheduled, it will resume normal non-durable behavior (i.e. be deleted + once there are no remaining associated triggers). + + Delete the identified from the Scheduler - and any @@ -11089,6 +11111,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11465,6 +11492,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11958,7 +11990,7 @@ James House Marko Lahma (.NET) - + An array of objects that were updated/added since the last scan of the directory @@ -13254,20 +13286,11 @@ Data to deserialize object from. - + - that names the scheduler instance using - just the machine hostname. + Helper base class for host name lookup requiring instance id generators. - - This class is useful when you know that your scheduler instance will be the - only one running on a particular machine. Each time the scheduler is - restarted, it will get the same instance id as long as the machine is not - renamed. - - Marko Lahma (.NET) - - + Marko Lahma @@ -13289,6 +13312,28 @@ The clusterwide unique instance id. + + + Generate the instance id for a + + The clusterwide unique instance id. + + + + + that names the scheduler instance using + just the machine hostname. + + + This class is useful when you know that your scheduler instance will be the + only one running on a particular machine. Each time the scheduler is + restarted, it will get the same instance id as long as the machine is not + renamed. + + Marko Lahma (.NET) + + + Generate the instance id for a @@ -13370,6 +13415,11 @@ the newly instantiated Job + + + Allows the the job factory to destroy/cleanup the job if needed. + + Called by the scheduler at the time of the trigger firing, in order to @@ -13390,6 +13440,12 @@ the newly instantiated Job SchedulerException if there is a problem instantiating the Job. + + + Allows the the job factory to destroy/cleanup the job if needed. + No-op when using SimpleJobFactory. + + Called by the scheduler at the time of the trigger firing, in order to @@ -14064,7 +14120,6 @@ Sets the channel type when registering remoting. - @@ -14074,6 +14129,12 @@ . + + + A Boolean value (true or false) that specifies whether to refuse requests from other computers. + Specifying true allows only remoting calls from the local computer. The default is false. + + A implementation that creates @@ -14649,6 +14710,38 @@ Mohammad Rezaei Marko Lahma (.NET) + + + Manages a collection of IDbProviders, and provides transparent access + to their database. + + + + + Shuts down database connections from the data source with the given name, + if applicable for the underlying provider. + + + + + Get a database connection from the data source with the given name. + + + + + Returns meta data for data source with the given name. + + + + + Gets db provider for data source with the given name. + + + + + Adds a connection provider to data source with the given name. + + Private constructor @@ -14672,7 +14765,6 @@ Shuts down database connections from the DataSource with the given name, if applicable for the underlying provider. - a database connection @@ -14722,6 +14814,12 @@ A new object that is a copy of this instance. + + + Gets the value behind the specified key. + + The key. + When implemented by a class, removes all elements from the . @@ -14881,7 +14979,6 @@ Gets or sets the with the specified key. - @@ -15213,7 +15310,7 @@ The name. - + Gets the int array property. @@ -15310,7 +15407,27 @@ The underlying properties. - + + + Environment access helpers that fail gracefully if under medium trust. + + + + + Retrieves the value of an environment variable from the current process. + + + + + Retrieves all environment variable names and their values from the current process. + + + + + Return whether we are currently running under Mono runtime. + + + Extension methods for . @@ -15465,6 +15582,29 @@ Retrieve the identified value from the . + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + TimeZoneInfo.ConvertTime is not supported under mono + + + + + @@ -15630,6 +15770,9 @@ + + + @@ -15719,6 +15862,7 @@ Chris Bonham James House Marko Lahma (.NET) + Christian Krumm (.NET Bugfix) @@ -15784,6 +15928,14 @@ The system id. The sched. + + + Process the xml file in the given location, and schedule all of the + jobs defined within it. + + stream to read XML data from. + The sched. + Schedules the given sets of jobs and triggers. @@ -15830,6 +15982,15 @@ + + + If true (and is true) then any + job/triggers encountered in this file that already exist is scheduler + will be updated with start time relative to old trigger. Effectively + new trigger's last fire time will be updated to old trigger's last fire time + and trigger's next fire time will updated to be next from this last fire time. + + Gets the log. @@ -17077,6 +17238,14 @@ + + + TimeZone in which to base the schedule. + + the time-zone for the schedule + the updated CalendarIntervalScheduleBuilder + + Extension methods that attach to . @@ -17493,8 +17662,8 @@ body of the job's periodically check some flag to see if an interruption has been requested, and if the flag is set, somehow abort the performance of the rest of the job's work. An example of - interrupting a job can be found in the java source for the class - . It is legal to use + interrupting a job can be found in the source for the class Example7's DumbInterruptableJob + It is legal to use some combination of and synchronization within and in order to have the method block until the @@ -17716,7 +17885,8 @@ orphaned (no s point to it). - If not explicitly set, the default value is . + If not explicitly set, the default value is + - this method sets the value to true. the updated JobBuilder @@ -17777,13 +17947,20 @@ - Set the JobDetail's , adding any values to it - that were already set on this JobBuilder using any of the - other 'usingJobData' methods. + Add all the data from the given to the + 's . the updated JobBuilder + + + Replace the 's with the + given . + + + + Holds state information for instances. @@ -17871,17 +18048,30 @@ 's data map. - + - Retrieve the identified value from the . + Adds the given value as a string version to the + 's data map. - + + + Adds the given value as a string version to the + 's data map. + + + + + Adds the given value as a string version to the + 's data map. + + + Retrieve the identified value from the . - + Retrieve the identified value from the . @@ -17897,11 +18087,6 @@ . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17917,11 +18102,6 @@ Retrieve the identified value from the . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17932,14 +18112,24 @@ Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . @@ -17947,20 +18137,25 @@ Retrieve the identified value from the . - + Gets the date time. The key. - + - Gets the value behind the specified key. + Gets the date time offset. The key. + + + Retrieve the identified value from the . + + An exception that can be thrown by a @@ -18239,26 +18434,6 @@ but it does not want to be fired now. - - - misfire instructions for NthIncludedDayTrigger - - - - - Instructs the that upon a mis-fire situation, the - wants to be fired now by the - - - - - - Instructs the that upon a mis-fire situation, the - wants to have - nextFireTime updated to the next time in the schedule after - the current time, but it does not want to be fired now. - - Misfire instructions for DateIntervalTrigger @@ -18301,468 +18476,6 @@ but it does not want to be fired now. - - - A trigger which fires on the Nth day of every interval type - , or - that is not excluded by the associated - calendar. - - - When determining what the Nth day of the month or year - is, will skip excluded days on the - associated calendar. This would commonly be used in an Nth - business day situation, in which the user wishes to fire a particular job on - the Nth business day (i.e. the 5th business day of - every month). Each also has an associated - which indicates at what time of day the trigger is - to fire. - - All s default to a monthly interval type - (fires on the Nth day of every month) with N = 1 (first - non-excluded day) and set to 12:00 PM (noon). These - values can be changed using the , , and - methods. Users may also want to note the - and - methods. - - - Take, for example, the following calendar: - - - July August September - Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa - 1 W 1 2 3 4 5 W 1 2 W - W H 5 6 7 8 W W 8 9 10 11 12 W W H 6 7 8 9 W - W 11 12 13 14 15 W W 15 16 17 18 19 W W 12 13 14 15 16 W - W 18 19 20 21 22 W W 22 23 24 25 26 W W 19 20 21 22 23 W - W 25 26 27 28 29 W W 29 30 31 W 26 27 28 29 30 - W - - Where W's represent weekend days, and H's represent holidays, all of which - are excluded on a calendar associated with an - with n=5 and - intervalType=IntervalTypeMonthly. In this case, the trigger - would fire on the 8th of July (because of the July 4 holiday), - the 5th of August, and the 8th of September (because - of Labor Day). - - Aaron Craven - Marko Lahma (.NET) - - - - Indicates a monthly trigger type (fires on the Nth included - day of every month). - - - - indicates a yearly trigger type (fires on the Nth included - day of every year). - - - - - Indicates a weekly trigger type (fires on the Nth included - day of every week). When using this interval type, care must be taken - not to think of the value of as an analog to - . Such a comparison can only - be drawn when there are no calendars associated with the trigger. To - illustrate, consider an with - n = 3 which is associated with a Calendar excluding - non-weekdays. The trigger would fire on the 3rd - included day of the week, which would be 4th - actual day of the week. - - - - - Create an with no specified name, - group, or . This will result initially in a - default monthly trigger that fires on the first day of every month at - 12:00 PM (n = 1, - intervalType=, - fireAtTime="12:00"). - - - Note that and , must be - called before the can be placed into - a . - - - - - Create an with the given name and - default group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - - - - Create an with the given name and - group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - the group for the - - - - - Create an with the given name and - group and the specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime="12:00"). - - The name for the . - The group for the . - The name of the job to associate with the . - The group containing the job to associate with the . - - - - Returns the next UTC time at which the - will fire. If the trigger will not fire again, will be - returned. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - The returned value is not guaranteed to be valid until after - the trigger has been added to the scheduler. - - - the next fire time for the trigger - - - - - Returns the previous UTC time at which the - fired. If the trigger has not yet - fired, will be returned. - - the previous fire time for the trigger - - - - Returns the first time the will fire - after the specified date. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - Therefore, for triggers with intervalType = - , if the trigger - will not fire within 12 - weeks after the given date/time, will be returned. For - triggers with intervalType = - - , if the trigger will not fire within 12 - months after the given date/time, will be returned. - For triggers with intervalType = - - , if the trigger will not fire within 12 - years after the given date/time, will be returned. In - all cases, if the trigger will not fire before , - will be returned. - - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - - the first time the trigger will fire following the specified date - - - - - Called when the has decided to 'fire' the trigger - (Execute the associated ), in order to give the - a chance to update itself for its next triggering - (if any). - - - - - Called by the scheduler at the time a is first - added to the scheduler, in order to have the - compute its first fire time, based on any associated calendar. - - After this method has been called, - should return a valid answer. - - - - the first time at which the will be fired - by the scheduler, which is also the same value - will return (until after the first - firing of the ). - - - - - Called after the has executed the - associated with the in order - to get the final instruction code from the trigger. - - - The that was used by the - 's method. - - - The thrown by the - , if any (may be ) - - one of the Trigger.INSTRUCTION_XXX constants. - - - - - Used by the to determine whether or not it is - possible for this to fire again. - ' - - - If the returned value is then the - may remove the from the - - - - - A boolean indicator of whether the trigger could potentially fire - again. - - - - - Indicates whether is a valid misfire - instruction for this . - - Whether is valid. - - - Updates the 's state based on the - MisfireInstruction that was selected when the - was created -

- If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY, - then the instruction will be interpreted as - . -

- - a new or updated calendar to use for the trigger - - - - - Updates the 's state based on the - given new version of the associated . - - A new or updated calendar to use for the trigger - the amount of time that must - be between "now" and the time the next - firing of the trigger is supposed to occur. - - - - - Calculates the first time an with - intervalType = IntervalTypeWeekly will fire - after the specified date. See for more - information. - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Calculates the first UTC time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified date - - - - Calculates the first time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - - - Gets or sets the day of the interval on which the - should fire. If the Nth - day of the interval does not exist (i.e. the 32nd of a - month), the trigger simply will never fire. N may not be less than 1. - - - - - Returns the interval type for the . - - - Sets the interval type for the . If - , the trigger will fire on the - Nth included day of every month. If - , the trigger will fire on the - Nth included day of every year. If - , the trigger will fire on the - Nth included day of every week. - - - - - - - - Returns the fire time for the as a - string with the format "HH:MM[:SS]", with HH representing the - 24-hour clock hour of the fire time. Seconds are optional and their - inclusion depends on whether or not they were provided to - . - - - - - Returns the for the - . - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType" />. - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - method. The default cutoff is 12 - of the intervals specified by intervalType". - - - In most cases, the default value of this setting (12) is sufficient (it - is highly unlikely, for example, that you will need to look at more than - 12 months of dates to ensure that your trigger will never fire again). - However, this setting is included to allow for the rare exceptions where - this might not be true. - - - For example, if your trigger is associated with a calendar that excludes - a great many dates in the next 12 months, and hardly any following that, - it is possible (if is large enough) that you could run - into this situation. - - - - - - Returns the last UTC time the will fire. - If the trigger will not fire at any point between - and , will be returned. - - the last time the trigger will fire. - - - - Tells whether this Trigger instance can handle events - in millisecond precision. - - - - - - Sets or gets the time zone in which the will be resolved. - If no time zone is provided, then the default time zone will be used. - - - - - - - Gets or sets the trigger's calendar week rule. - - The trigger calendar week rule. - - - - Gets or sets the trigger's calendar first day of week rule. - - The trigger calendar first day of week. - An exception that is thrown to indicate that an attempt to store a new @@ -18907,15 +18620,31 @@ - + - A constant key that can be used to retrieve the - scheduled fire time of the original from a recovery + A constant key that can be used to retrieve the + fire time of the original from a recovery trigger's data map in the case of a job recovering after a failed scheduler instance. + + Note that this is the time the original firing actually occurred, + which may be different from the scheduled fire time - as a trigger doesn't + always fire exactly on time. + + + + A constant JobDataMap key that can be used to retrieve the scheduled + fire time of the original Trigger from a recovery trigger's data + map in the case of a job recovering after a failed scheduler instance. + + + Note that this is the time the original firing was scheduled for, which may + be different from the actual firing time - as a trigger doesn't always fire exactly on time. + + Holds context/environment data that can be made available to Jobs as they diff --git a/packages/Quartz.2.2/lib/net35/Quartz.dll b/packages/Quartz.2.2/lib/net35/Quartz.dll new file mode 100644 index 0000000..29a3cd0 Binary files /dev/null and b/packages/Quartz.2.2/lib/net35/Quartz.dll differ diff --git a/packages/Quartz.2.2/lib/net35/Quartz.pdb b/packages/Quartz.2.2/lib/net35/Quartz.pdb new file mode 100644 index 0000000..c8f0604 Binary files /dev/null and b/packages/Quartz.2.2/lib/net35/Quartz.pdb differ diff --git a/packages/Quartz.2.0.1/lib/net35-client/Quartz.xml b/packages/Quartz.2.2/lib/net35/Quartz.xml similarity index 94% rename from packages/Quartz.2.0.1/lib/net35-client/Quartz.xml rename to packages/Quartz.2.2/lib/net35/Quartz.xml index de320e2..9ee197f 100644 --- a/packages/Quartz.2.0.1/lib/net35-client/Quartz.xml +++ b/packages/Quartz.2.2/lib/net35/Quartz.xml @@ -42,6 +42,13 @@ + + + Initializes a new instance of the class. + + The internal set to wrap. + internalSet + Simple C5 wrapper for common interface. @@ -270,6 +277,11 @@ that it has started. + + + Called by the to inform the listener that it is starting. + + Called by the to inform the listener @@ -313,7 +325,7 @@ The instance that should be made available within the . - + @@ -348,24 +360,6 @@ Passivates this instance. - - - Completes the trigger retry loop. - - The trigger. - The job detail. - The inst code. - - - - - Vetoeds the job retry loop. - - The trigger. - The job detail. - The inst code. - - Default concrete implementation of . @@ -653,7 +647,7 @@ true if the identified listener was found in the list, andremoved. - + Create a with the given configuration properties. @@ -1594,7 +1588,7 @@ Signals the main processing loop to pause at the next possible point. - + Signals the main processing loop to pause at the next possible point. @@ -1616,18 +1610,6 @@ The main processing loop of the . - - - Trigger retry loop that is executed on error condition. - - The bndle. - - - - Releases the trigger retry loop. - - The trigger. - Gets the log. @@ -1646,12 +1628,6 @@ true if paused; otherwise, false. - - - Gets or sets the db failure retry interval. - - The db failure retry interval. - An interface to be used by instances in order to @@ -1685,6 +1661,11 @@ Signals the scheduling change. + + + Informs scheduler listeners about an exception that has occurred. + + Notifies the scheduler about misfired trigger. @@ -1834,6 +1815,11 @@ Marko Lahma + + + Initializes the db provider implementation. + + Returns a new command object for executing SQL statments/Stored Procedures @@ -1873,12 +1859,10 @@ Connection string used to create connections. - + - Registers DB metadata information for given provider name. + Parse metadata once in static constructor. - - @@ -1887,6 +1871,13 @@ Name of the db provider. The connection string. + + + Registers DB metadata information for given provider name. + + + + Returns a new command object for executing SQL statments/Stored Procedures @@ -2144,25 +2135,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - - Determine whether the calling thread owns a lock on the identified - resource. - - Whether this Semaphore implementation requires a database connection for its lock management operations. - - + @@ -2205,20 +2189,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - + Determine whether the calling thread owns a lock on the identified resource. - @@ -2318,6 +2300,11 @@ The fire timestamp. + + + Gets or sets the scheduled fire timestamp. + + Gets or sets a value indicating whether job disallows concurrent execution. @@ -2770,12 +2757,12 @@ Select the job to which the trigger is associated. - The DB Connection - The key identifying the trigger. - The load helper. - - The object associated with the given trigger - + + + + Select the job to which the trigger is associated. Allow option to load actual job class or not. When case of + remove, we do not need to load the type, which in many cases, it's no longer exists. + @@ -3870,14 +3857,14 @@ Delete a job and its listeners. - + Delete a trigger, its listeners, and its Simple/Cron/BLOB sub-table entry. - + @@ -4290,7 +4277,7 @@ if set to true opens a new transaction. JobPersistenceException thrown if a SQLException occurs when the - + Execute the given callback in a transaction. Depending on the JobStore, the surrounding transaction may be assumed to be already present @@ -4299,27 +4286,8 @@ This method just forwards to ExecuteInLock() with a null lockName. - - - - - Execute the given callback having acquired the given lock. - Depending on the JobStore, the surrounding transaction may be - assumed to be already present (managed). This version is just a - handy wrapper around executeInLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a transaction. - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having acquired the given lock. Depending on the JobStore, the surrounding transaction may be @@ -4334,24 +4302,7 @@ The callback to excute after having acquired the given lock. - - - Execute the given callback having optionally acquired the given lock. - This uses the non-managed transaction connection. This version is just a - handy wrapper around executeInNonManagedTXLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a non-managed transaction. - - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having optionally acquired the given lock. This uses the non-managed transaction connection. @@ -4364,12 +4315,18 @@ The callback to excute after having acquired the given lock. + Get or set the datasource name. + + + Get or set the database connection manager. + + Gets the log. @@ -4430,14 +4387,21 @@ Whether or not to obtain locks when inserting new jobs/triggers. - Defaults to , which is safest - some db's (such as - MS SQLServer) seem to require this to avoid deadlocks under high load, - while others seem to do fine without. + + Defaults to , which is safest - some db's (such as + MS SQLServer) seem to require this to avoid deadlocks under high load, + while others seem to do fine without. Settings this to false means + isolation guarantees between job scheduling and trigger acquisition are + entirely enforced by the database. Depending on the database and it's + configuration this may cause unusual scheduling behaviors. + + Setting this property to will provide a significant performance increase during the addition of new jobs and triggers. + @@ -4612,15 +4576,15 @@ - + Execute the given callback having optionally acquired the given lock. Because CMT assumes that the connection is already part of a managed transaction, it does not attempt to commit or rollback the enclosing transaction. - - + + @@ -4630,6 +4594,11 @@ Callback to execute. + + + Instructs this job store whether connections should be automatically opened. + + is meant to be used in a standalone environment. @@ -4654,7 +4623,7 @@ - + Execute the given callback having optionally aquired the given lock. For , because it manages its own transactions @@ -5132,15 +5101,6 @@ the key of the job the number of triggers for the given job - - - Select the job to which the trigger is associated. - - the DB Connection - the key of the trigger - The load helper. - The object associated with the given trigger - Select the triggers for a job @@ -5633,12 +5593,12 @@ True if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - + Determine whether the calling thread owns a lock on the identified resource. @@ -5656,9 +5616,9 @@ its lock management operations. - + - + @@ -5695,6 +5655,11 @@ James House Marko Lahma (.NET) + + + Initializes a new instance of the class. + + Initializes a new instance of the class. @@ -6883,7 +6848,7 @@ - + James House @@ -6926,13 +6891,21 @@ - + James House Sharada Jambula Marko Lahma (.NET) + + + Get a that is configured to produce a + trigger identical to this one. + + + + Get a that is configured to produce a @@ -7640,7 +7613,7 @@ - + 2.0 James House Marko Lahma (.NET) @@ -7893,15 +7866,6 @@ valid for submission into a . - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - Get the time at which the should occur. @@ -8744,11 +8708,6 @@ Zemian Deng saltnlight5@gmail.com Nuno Maia (.NET) - - - - - Get the the number of times for interval this trigger should repeat, @@ -8793,6 +8752,14 @@ Get the number of times the has already fired. + + + Gets the time zone within which time calculations related to this trigger will be performed. + + + If null, the system default TimeZone will be used. + + Used to indicate the 'repeat count' of the trigger is indefinite. Or in @@ -8859,7 +8826,7 @@ , , and . The number of milliseconds to pause between the repeat firing. - + Create a that will occur at the given time, fire the identified job and repeat at the the given @@ -9562,7 +9529,7 @@ the default value, which is currently 30000 ms. The db failure retry interval. - + Creates a scheduler using the specified thread pool and job store and binds it for remote access. @@ -9574,10 +9541,26 @@ The type of job store The idle wait time. You can specify TimeSpan.Zero for - the default value, which is currently 30000 ms. - The db failure retry interval. + the default value, which is currently 30000 ms. + The maximum batch size of triggers, when acquiring them + The time window for which it is allowed to "pre-acquire" triggers to fire + + + + Creates a scheduler using the specified thread pool and job store and + binds it for remote access. + + The name for the scheduler. + The instance ID for the scheduler. + The thread pool for executing jobs + Thread executor. + The type of job store + + The idle wait time. You can specify TimeSpan.Zero for + the default value, which is currently 30000 ms. The maximum batch size of triggers, when acquiring them The time window for which it is allowed to "pre-acquire" triggers to fire + The scheduler exporter to use @@ -9710,7 +9693,7 @@ - + Whether the associated Job class carries the . @@ -9742,7 +9725,7 @@ Create a with the given name, default group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9752,7 +9735,7 @@ Create a with the given name, and group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9764,7 +9747,7 @@ the given settings of all the other properties. The name. - if , Scheduler.DefaultGroup will be used. + if , SchedulerConstants.DefaultGroup will be used. Type of the job. if set to true, job will be durable. if set to true, job will request recovery. @@ -9907,7 +9890,7 @@ Whether the associated Job class carries the attribute. - + Whether the associated Job class carries the attribute. @@ -10009,6 +9992,19 @@ situation, this method will return . + + + Returns the of the originally scheduled and now recovering job. + + + When recovering a previously failed job execution this property returns the identity + of the originally firing trigger. This recovering job will have been scheduled for + the same firing time as the original job, and so is available via the + property. The original firing time of the job can be + accessed via the + element of this job's . + + Gets the refire count. @@ -10495,8 +10491,7 @@ Halts the 's firing of s, - and cleans up all resources associated with the Scheduler. Equivalent to - . + and cleans up all resources associated with the Scheduler. Equivalent to Shutdown(false). The scheduler cannot be re-started. @@ -10534,7 +10529,7 @@ identified by the 's settings. - + Schedule all of the given jobs with the related set of triggers. @@ -10544,6 +10539,19 @@ parameter is not set to true then an exception will be thrown. + + + Schedule the given job with the related set of triggers. + + + If any of the given job or triggers already exist (or more + specifically, if the keys are not unique) and the replace + parameter is not set to true then an exception will be thrown. + + + + + Remove the indicated from the scheduler. @@ -10595,6 +10603,20 @@ SchedulerException will be thrown. + + + Add the given to the Scheduler - with no associated + . The will be 'dormant' until + it is scheduled with a , or + is called for it. + + + With the parameter + set to true, a non-durable job can be stored. Once it is + scheduled, it will resume normal non-durable behavior (i.e. be deleted + once there are no remaining associated triggers). + + Delete the identified from the Scheduler - and any @@ -11089,6 +11111,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11465,6 +11492,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11958,7 +11990,7 @@ James House Marko Lahma (.NET) - + An array of objects that were updated/added since the last scan of the directory @@ -13254,20 +13286,11 @@ Data to deserialize object from. - + - that names the scheduler instance using - just the machine hostname. + Helper base class for host name lookup requiring instance id generators. - - This class is useful when you know that your scheduler instance will be the - only one running on a particular machine. Each time the scheduler is - restarted, it will get the same instance id as long as the machine is not - renamed. - - Marko Lahma (.NET) - - + Marko Lahma @@ -13289,6 +13312,28 @@ The clusterwide unique instance id. + + + Generate the instance id for a + + The clusterwide unique instance id. + + + + + that names the scheduler instance using + just the machine hostname. + + + This class is useful when you know that your scheduler instance will be the + only one running on a particular machine. Each time the scheduler is + restarted, it will get the same instance id as long as the machine is not + renamed. + + Marko Lahma (.NET) + + + Generate the instance id for a @@ -13370,6 +13415,11 @@ the newly instantiated Job + + + Allows the the job factory to destroy/cleanup the job if needed. + + Called by the scheduler at the time of the trigger firing, in order to @@ -13390,6 +13440,12 @@ the newly instantiated Job SchedulerException if there is a problem instantiating the Job. + + + Allows the the job factory to destroy/cleanup the job if needed. + No-op when using SimpleJobFactory. + + Called by the scheduler at the time of the trigger firing, in order to @@ -14064,7 +14120,6 @@ Sets the channel type when registering remoting. - @@ -14074,6 +14129,12 @@ . + + + A Boolean value (true or false) that specifies whether to refuse requests from other computers. + Specifying true allows only remoting calls from the local computer. The default is false. + + A implementation that creates @@ -14649,6 +14710,38 @@ Mohammad Rezaei Marko Lahma (.NET) + + + Manages a collection of IDbProviders, and provides transparent access + to their database. + + + + + Shuts down database connections from the data source with the given name, + if applicable for the underlying provider. + + + + + Get a database connection from the data source with the given name. + + + + + Returns meta data for data source with the given name. + + + + + Gets db provider for data source with the given name. + + + + + Adds a connection provider to data source with the given name. + + Private constructor @@ -14672,7 +14765,6 @@ Shuts down database connections from the DataSource with the given name, if applicable for the underlying provider. - a database connection @@ -14722,6 +14814,12 @@ A new object that is a copy of this instance. + + + Gets the value behind the specified key. + + The key. + When implemented by a class, removes all elements from the . @@ -14881,7 +14979,6 @@ Gets or sets the with the specified key. - @@ -15213,7 +15310,7 @@ The name. - + Gets the int array property. @@ -15310,7 +15407,27 @@ The underlying properties. - + + + Environment access helpers that fail gracefully if under medium trust. + + + + + Retrieves the value of an environment variable from the current process. + + + + + Retrieves all environment variable names and their values from the current process. + + + + + Return whether we are currently running under Mono runtime. + + + Extension methods for . @@ -15465,6 +15582,29 @@ Retrieve the identified value from the . + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + TimeZoneInfo.ConvertTime is not supported under mono + + + + + @@ -15630,6 +15770,9 @@ + + + @@ -15719,6 +15862,7 @@ Chris Bonham James House Marko Lahma (.NET) + Christian Krumm (.NET Bugfix) @@ -15784,6 +15928,14 @@ The system id. The sched. + + + Process the xml file in the given location, and schedule all of the + jobs defined within it. + + stream to read XML data from. + The sched. + Schedules the given sets of jobs and triggers. @@ -15830,6 +15982,15 @@ + + + If true (and is true) then any + job/triggers encountered in this file that already exist is scheduler + will be updated with start time relative to old trigger. Effectively + new trigger's last fire time will be updated to old trigger's last fire time + and trigger's next fire time will updated to be next from this last fire time. + + Gets the log. @@ -17077,6 +17238,14 @@ + + + TimeZone in which to base the schedule. + + the time-zone for the schedule + the updated CalendarIntervalScheduleBuilder + + Extension methods that attach to . @@ -17493,8 +17662,8 @@ body of the job's periodically check some flag to see if an interruption has been requested, and if the flag is set, somehow abort the performance of the rest of the job's work. An example of - interrupting a job can be found in the java source for the class - . It is legal to use + interrupting a job can be found in the source for the class Example7's DumbInterruptableJob + It is legal to use some combination of and synchronization within and in order to have the method block until the @@ -17716,7 +17885,8 @@ orphaned (no s point to it). - If not explicitly set, the default value is . + If not explicitly set, the default value is + - this method sets the value to true. the updated JobBuilder @@ -17777,13 +17947,20 @@ - Set the JobDetail's , adding any values to it - that were already set on this JobBuilder using any of the - other 'usingJobData' methods. + Add all the data from the given to the + 's . the updated JobBuilder + + + Replace the 's with the + given . + + + + Holds state information for instances. @@ -17871,17 +18048,30 @@ 's data map. - + - Retrieve the identified value from the . + Adds the given value as a string version to the + 's data map. - + + + Adds the given value as a string version to the + 's data map. + + + + + Adds the given value as a string version to the + 's data map. + + + Retrieve the identified value from the . - + Retrieve the identified value from the . @@ -17897,11 +18087,6 @@ . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17917,11 +18102,6 @@ Retrieve the identified value from the . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17932,14 +18112,24 @@ Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . @@ -17947,20 +18137,25 @@ Retrieve the identified value from the . - + Gets the date time. The key. - + - Gets the value behind the specified key. + Gets the date time offset. The key. + + + Retrieve the identified value from the . + + An exception that can be thrown by a @@ -18239,26 +18434,6 @@ but it does not want to be fired now. - - - misfire instructions for NthIncludedDayTrigger - - - - - Instructs the that upon a mis-fire situation, the - wants to be fired now by the - - - - - - Instructs the that upon a mis-fire situation, the - wants to have - nextFireTime updated to the next time in the schedule after - the current time, but it does not want to be fired now. - - Misfire instructions for DateIntervalTrigger @@ -18301,468 +18476,6 @@ but it does not want to be fired now. - - - A trigger which fires on the Nth day of every interval type - , or - that is not excluded by the associated - calendar. - - - When determining what the Nth day of the month or year - is, will skip excluded days on the - associated calendar. This would commonly be used in an Nth - business day situation, in which the user wishes to fire a particular job on - the Nth business day (i.e. the 5th business day of - every month). Each also has an associated - which indicates at what time of day the trigger is - to fire. - - All s default to a monthly interval type - (fires on the Nth day of every month) with N = 1 (first - non-excluded day) and set to 12:00 PM (noon). These - values can be changed using the , , and - methods. Users may also want to note the - and - methods. - - - Take, for example, the following calendar: - - - July August September - Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa - 1 W 1 2 3 4 5 W 1 2 W - W H 5 6 7 8 W W 8 9 10 11 12 W W H 6 7 8 9 W - W 11 12 13 14 15 W W 15 16 17 18 19 W W 12 13 14 15 16 W - W 18 19 20 21 22 W W 22 23 24 25 26 W W 19 20 21 22 23 W - W 25 26 27 28 29 W W 29 30 31 W 26 27 28 29 30 - W - - Where W's represent weekend days, and H's represent holidays, all of which - are excluded on a calendar associated with an - with n=5 and - intervalType=IntervalTypeMonthly. In this case, the trigger - would fire on the 8th of July (because of the July 4 holiday), - the 5th of August, and the 8th of September (because - of Labor Day). - - Aaron Craven - Marko Lahma (.NET) - - - - Indicates a monthly trigger type (fires on the Nth included - day of every month). - - - - indicates a yearly trigger type (fires on the Nth included - day of every year). - - - - - Indicates a weekly trigger type (fires on the Nth included - day of every week). When using this interval type, care must be taken - not to think of the value of as an analog to - . Such a comparison can only - be drawn when there are no calendars associated with the trigger. To - illustrate, consider an with - n = 3 which is associated with a Calendar excluding - non-weekdays. The trigger would fire on the 3rd - included day of the week, which would be 4th - actual day of the week. - - - - - Create an with no specified name, - group, or . This will result initially in a - default monthly trigger that fires on the first day of every month at - 12:00 PM (n = 1, - intervalType=, - fireAtTime="12:00"). - - - Note that and , must be - called before the can be placed into - a . - - - - - Create an with the given name and - default group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - - - - Create an with the given name and - group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - the group for the - - - - - Create an with the given name and - group and the specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime="12:00"). - - The name for the . - The group for the . - The name of the job to associate with the . - The group containing the job to associate with the . - - - - Returns the next UTC time at which the - will fire. If the trigger will not fire again, will be - returned. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - The returned value is not guaranteed to be valid until after - the trigger has been added to the scheduler. - - - the next fire time for the trigger - - - - - Returns the previous UTC time at which the - fired. If the trigger has not yet - fired, will be returned. - - the previous fire time for the trigger - - - - Returns the first time the will fire - after the specified date. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - Therefore, for triggers with intervalType = - , if the trigger - will not fire within 12 - weeks after the given date/time, will be returned. For - triggers with intervalType = - - , if the trigger will not fire within 12 - months after the given date/time, will be returned. - For triggers with intervalType = - - , if the trigger will not fire within 12 - years after the given date/time, will be returned. In - all cases, if the trigger will not fire before , - will be returned. - - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - - the first time the trigger will fire following the specified date - - - - - Called when the has decided to 'fire' the trigger - (Execute the associated ), in order to give the - a chance to update itself for its next triggering - (if any). - - - - - Called by the scheduler at the time a is first - added to the scheduler, in order to have the - compute its first fire time, based on any associated calendar. - - After this method has been called, - should return a valid answer. - - - - the first time at which the will be fired - by the scheduler, which is also the same value - will return (until after the first - firing of the ). - - - - - Called after the has executed the - associated with the in order - to get the final instruction code from the trigger. - - - The that was used by the - 's method. - - - The thrown by the - , if any (may be ) - - one of the Trigger.INSTRUCTION_XXX constants. - - - - - Used by the to determine whether or not it is - possible for this to fire again. - ' - - - If the returned value is then the - may remove the from the - - - - - A boolean indicator of whether the trigger could potentially fire - again. - - - - - Indicates whether is a valid misfire - instruction for this . - - Whether is valid. - - - Updates the 's state based on the - MisfireInstruction that was selected when the - was created -

- If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY, - then the instruction will be interpreted as - . -

- - a new or updated calendar to use for the trigger - - - - - Updates the 's state based on the - given new version of the associated . - - A new or updated calendar to use for the trigger - the amount of time that must - be between "now" and the time the next - firing of the trigger is supposed to occur. - - - - - Calculates the first time an with - intervalType = IntervalTypeWeekly will fire - after the specified date. See for more - information. - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Calculates the first UTC time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified date - - - - Calculates the first time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - - - Gets or sets the day of the interval on which the - should fire. If the Nth - day of the interval does not exist (i.e. the 32nd of a - month), the trigger simply will never fire. N may not be less than 1. - - - - - Returns the interval type for the . - - - Sets the interval type for the . If - , the trigger will fire on the - Nth included day of every month. If - , the trigger will fire on the - Nth included day of every year. If - , the trigger will fire on the - Nth included day of every week. - - - - - - - - Returns the fire time for the as a - string with the format "HH:MM[:SS]", with HH representing the - 24-hour clock hour of the fire time. Seconds are optional and their - inclusion depends on whether or not they were provided to - . - - - - - Returns the for the - . - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType" />. - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - method. The default cutoff is 12 - of the intervals specified by intervalType". - - - In most cases, the default value of this setting (12) is sufficient (it - is highly unlikely, for example, that you will need to look at more than - 12 months of dates to ensure that your trigger will never fire again). - However, this setting is included to allow for the rare exceptions where - this might not be true. - - - For example, if your trigger is associated with a calendar that excludes - a great many dates in the next 12 months, and hardly any following that, - it is possible (if is large enough) that you could run - into this situation. - - - - - - Returns the last UTC time the will fire. - If the trigger will not fire at any point between - and , will be returned. - - the last time the trigger will fire. - - - - Tells whether this Trigger instance can handle events - in millisecond precision. - - - - - - Sets or gets the time zone in which the will be resolved. - If no time zone is provided, then the default time zone will be used. - - - - - - - Gets or sets the trigger's calendar week rule. - - The trigger calendar week rule. - - - - Gets or sets the trigger's calendar first day of week rule. - - The trigger calendar first day of week. - An exception that is thrown to indicate that an attempt to store a new @@ -18907,15 +18620,31 @@ - + - A constant key that can be used to retrieve the - scheduled fire time of the original from a recovery + A constant key that can be used to retrieve the + fire time of the original from a recovery trigger's data map in the case of a job recovering after a failed scheduler instance. + + Note that this is the time the original firing actually occurred, + which may be different from the scheduled fire time - as a trigger doesn't + always fire exactly on time. + + + + A constant JobDataMap key that can be used to retrieve the scheduled + fire time of the original Trigger from a recovery trigger's data + map in the case of a job recovering after a failed scheduler instance. + + + Note that this is the time the original firing was scheduled for, which may + be different from the actual firing time - as a trigger doesn't always fire exactly on time. + + Holds context/environment data that can be made available to Jobs as they diff --git a/packages/Quartz.2.2/lib/net40-client/Quartz.dll b/packages/Quartz.2.2/lib/net40-client/Quartz.dll new file mode 100644 index 0000000..7f332ee Binary files /dev/null and b/packages/Quartz.2.2/lib/net40-client/Quartz.dll differ diff --git a/packages/Quartz.2.2/lib/net40-client/Quartz.pdb b/packages/Quartz.2.2/lib/net40-client/Quartz.pdb new file mode 100644 index 0000000..58b0541 Binary files /dev/null and b/packages/Quartz.2.2/lib/net40-client/Quartz.pdb differ diff --git a/packages/Quartz.2.0.1/lib/net40-client/Quartz.xml b/packages/Quartz.2.2/lib/net40-client/Quartz.xml similarity index 94% rename from packages/Quartz.2.0.1/lib/net40-client/Quartz.xml rename to packages/Quartz.2.2/lib/net40-client/Quartz.xml index de320e2..9ee197f 100644 --- a/packages/Quartz.2.0.1/lib/net40-client/Quartz.xml +++ b/packages/Quartz.2.2/lib/net40-client/Quartz.xml @@ -42,6 +42,13 @@ + + + Initializes a new instance of the class. + + The internal set to wrap. + internalSet + Simple C5 wrapper for common interface. @@ -270,6 +277,11 @@ that it has started. + + + Called by the to inform the listener that it is starting. + + Called by the to inform the listener @@ -313,7 +325,7 @@ The instance that should be made available within the . - + @@ -348,24 +360,6 @@ Passivates this instance. - - - Completes the trigger retry loop. - - The trigger. - The job detail. - The inst code. - - - - - Vetoeds the job retry loop. - - The trigger. - The job detail. - The inst code. - - Default concrete implementation of . @@ -653,7 +647,7 @@ true if the identified listener was found in the list, andremoved. - + Create a with the given configuration properties. @@ -1594,7 +1588,7 @@ Signals the main processing loop to pause at the next possible point. - + Signals the main processing loop to pause at the next possible point. @@ -1616,18 +1610,6 @@ The main processing loop of the . - - - Trigger retry loop that is executed on error condition. - - The bndle. - - - - Releases the trigger retry loop. - - The trigger. - Gets the log. @@ -1646,12 +1628,6 @@ true if paused; otherwise, false. - - - Gets or sets the db failure retry interval. - - The db failure retry interval. - An interface to be used by instances in order to @@ -1685,6 +1661,11 @@ Signals the scheduling change. + + + Informs scheduler listeners about an exception that has occurred. + + Notifies the scheduler about misfired trigger. @@ -1834,6 +1815,11 @@ Marko Lahma + + + Initializes the db provider implementation. + + Returns a new command object for executing SQL statments/Stored Procedures @@ -1873,12 +1859,10 @@ Connection string used to create connections. - + - Registers DB metadata information for given provider name. + Parse metadata once in static constructor. - - @@ -1887,6 +1871,13 @@ Name of the db provider. The connection string. + + + Registers DB metadata information for given provider name. + + + + Returns a new command object for executing SQL statments/Stored Procedures @@ -2144,25 +2135,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - - Determine whether the calling thread owns a lock on the identified - resource. - - Whether this Semaphore implementation requires a database connection for its lock management operations. - - + @@ -2205,20 +2189,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - + Determine whether the calling thread owns a lock on the identified resource. - @@ -2318,6 +2300,11 @@ The fire timestamp. + + + Gets or sets the scheduled fire timestamp. + + Gets or sets a value indicating whether job disallows concurrent execution. @@ -2770,12 +2757,12 @@ Select the job to which the trigger is associated. - The DB Connection - The key identifying the trigger. - The load helper. - - The object associated with the given trigger - + + + + Select the job to which the trigger is associated. Allow option to load actual job class or not. When case of + remove, we do not need to load the type, which in many cases, it's no longer exists. + @@ -3870,14 +3857,14 @@ Delete a job and its listeners. - + Delete a trigger, its listeners, and its Simple/Cron/BLOB sub-table entry. - + @@ -4290,7 +4277,7 @@ if set to true opens a new transaction. JobPersistenceException thrown if a SQLException occurs when the - + Execute the given callback in a transaction. Depending on the JobStore, the surrounding transaction may be assumed to be already present @@ -4299,27 +4286,8 @@ This method just forwards to ExecuteInLock() with a null lockName. - - - - - Execute the given callback having acquired the given lock. - Depending on the JobStore, the surrounding transaction may be - assumed to be already present (managed). This version is just a - handy wrapper around executeInLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a transaction. - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having acquired the given lock. Depending on the JobStore, the surrounding transaction may be @@ -4334,24 +4302,7 @@ The callback to excute after having acquired the given lock. - - - Execute the given callback having optionally acquired the given lock. - This uses the non-managed transaction connection. This version is just a - handy wrapper around executeInNonManagedTXLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a non-managed transaction. - - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having optionally acquired the given lock. This uses the non-managed transaction connection. @@ -4364,12 +4315,18 @@ The callback to excute after having acquired the given lock. + Get or set the datasource name. + + + Get or set the database connection manager. + + Gets the log. @@ -4430,14 +4387,21 @@ Whether or not to obtain locks when inserting new jobs/triggers. - Defaults to , which is safest - some db's (such as - MS SQLServer) seem to require this to avoid deadlocks under high load, - while others seem to do fine without. + + Defaults to , which is safest - some db's (such as + MS SQLServer) seem to require this to avoid deadlocks under high load, + while others seem to do fine without. Settings this to false means + isolation guarantees between job scheduling and trigger acquisition are + entirely enforced by the database. Depending on the database and it's + configuration this may cause unusual scheduling behaviors. + + Setting this property to will provide a significant performance increase during the addition of new jobs and triggers. + @@ -4612,15 +4576,15 @@ - + Execute the given callback having optionally acquired the given lock. Because CMT assumes that the connection is already part of a managed transaction, it does not attempt to commit or rollback the enclosing transaction. - - + + @@ -4630,6 +4594,11 @@ Callback to execute. + + + Instructs this job store whether connections should be automatically opened. + + is meant to be used in a standalone environment. @@ -4654,7 +4623,7 @@ - + Execute the given callback having optionally aquired the given lock. For , because it manages its own transactions @@ -5132,15 +5101,6 @@ the key of the job the number of triggers for the given job - - - Select the job to which the trigger is associated. - - the DB Connection - the key of the trigger - The load helper. - The object associated with the given trigger - Select the triggers for a job @@ -5633,12 +5593,12 @@ True if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - + Determine whether the calling thread owns a lock on the identified resource. @@ -5656,9 +5616,9 @@ its lock management operations. - + - + @@ -5695,6 +5655,11 @@ James House Marko Lahma (.NET) + + + Initializes a new instance of the class. + + Initializes a new instance of the class. @@ -6883,7 +6848,7 @@ - + James House @@ -6926,13 +6891,21 @@ - + James House Sharada Jambula Marko Lahma (.NET) + + + Get a that is configured to produce a + trigger identical to this one. + + + + Get a that is configured to produce a @@ -7640,7 +7613,7 @@ - + 2.0 James House Marko Lahma (.NET) @@ -7893,15 +7866,6 @@ valid for submission into a . - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - Get the time at which the should occur. @@ -8744,11 +8708,6 @@ Zemian Deng saltnlight5@gmail.com Nuno Maia (.NET) - - - - - Get the the number of times for interval this trigger should repeat, @@ -8793,6 +8752,14 @@ Get the number of times the has already fired. + + + Gets the time zone within which time calculations related to this trigger will be performed. + + + If null, the system default TimeZone will be used. + + Used to indicate the 'repeat count' of the trigger is indefinite. Or in @@ -8859,7 +8826,7 @@ , , and . The number of milliseconds to pause between the repeat firing. - + Create a that will occur at the given time, fire the identified job and repeat at the the given @@ -9562,7 +9529,7 @@ the default value, which is currently 30000 ms. The db failure retry interval. - + Creates a scheduler using the specified thread pool and job store and binds it for remote access. @@ -9574,10 +9541,26 @@ The type of job store The idle wait time. You can specify TimeSpan.Zero for - the default value, which is currently 30000 ms. - The db failure retry interval. + the default value, which is currently 30000 ms. + The maximum batch size of triggers, when acquiring them + The time window for which it is allowed to "pre-acquire" triggers to fire + + + + Creates a scheduler using the specified thread pool and job store and + binds it for remote access. + + The name for the scheduler. + The instance ID for the scheduler. + The thread pool for executing jobs + Thread executor. + The type of job store + + The idle wait time. You can specify TimeSpan.Zero for + the default value, which is currently 30000 ms. The maximum batch size of triggers, when acquiring them The time window for which it is allowed to "pre-acquire" triggers to fire + The scheduler exporter to use @@ -9710,7 +9693,7 @@ - + Whether the associated Job class carries the . @@ -9742,7 +9725,7 @@ Create a with the given name, default group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9752,7 +9735,7 @@ Create a with the given name, and group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9764,7 +9747,7 @@ the given settings of all the other properties. The name. - if , Scheduler.DefaultGroup will be used. + if , SchedulerConstants.DefaultGroup will be used. Type of the job. if set to true, job will be durable. if set to true, job will request recovery. @@ -9907,7 +9890,7 @@ Whether the associated Job class carries the attribute. - + Whether the associated Job class carries the attribute. @@ -10009,6 +9992,19 @@ situation, this method will return . + + + Returns the of the originally scheduled and now recovering job. + + + When recovering a previously failed job execution this property returns the identity + of the originally firing trigger. This recovering job will have been scheduled for + the same firing time as the original job, and so is available via the + property. The original firing time of the job can be + accessed via the + element of this job's . + + Gets the refire count. @@ -10495,8 +10491,7 @@ Halts the 's firing of s, - and cleans up all resources associated with the Scheduler. Equivalent to - . + and cleans up all resources associated with the Scheduler. Equivalent to Shutdown(false). The scheduler cannot be re-started. @@ -10534,7 +10529,7 @@ identified by the 's settings. - + Schedule all of the given jobs with the related set of triggers. @@ -10544,6 +10539,19 @@ parameter is not set to true then an exception will be thrown. + + + Schedule the given job with the related set of triggers. + + + If any of the given job or triggers already exist (or more + specifically, if the keys are not unique) and the replace + parameter is not set to true then an exception will be thrown. + + + + + Remove the indicated from the scheduler. @@ -10595,6 +10603,20 @@ SchedulerException will be thrown. + + + Add the given to the Scheduler - with no associated + . The will be 'dormant' until + it is scheduled with a , or + is called for it. + + + With the parameter + set to true, a non-durable job can be stored. Once it is + scheduled, it will resume normal non-durable behavior (i.e. be deleted + once there are no remaining associated triggers). + + Delete the identified from the Scheduler - and any @@ -11089,6 +11111,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11465,6 +11492,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11958,7 +11990,7 @@ James House Marko Lahma (.NET) - + An array of objects that were updated/added since the last scan of the directory @@ -13254,20 +13286,11 @@ Data to deserialize object from. - + - that names the scheduler instance using - just the machine hostname. + Helper base class for host name lookup requiring instance id generators. - - This class is useful when you know that your scheduler instance will be the - only one running on a particular machine. Each time the scheduler is - restarted, it will get the same instance id as long as the machine is not - renamed. - - Marko Lahma (.NET) - - + Marko Lahma @@ -13289,6 +13312,28 @@ The clusterwide unique instance id. + + + Generate the instance id for a + + The clusterwide unique instance id. + + + + + that names the scheduler instance using + just the machine hostname. + + + This class is useful when you know that your scheduler instance will be the + only one running on a particular machine. Each time the scheduler is + restarted, it will get the same instance id as long as the machine is not + renamed. + + Marko Lahma (.NET) + + + Generate the instance id for a @@ -13370,6 +13415,11 @@ the newly instantiated Job + + + Allows the the job factory to destroy/cleanup the job if needed. + + Called by the scheduler at the time of the trigger firing, in order to @@ -13390,6 +13440,12 @@ the newly instantiated Job SchedulerException if there is a problem instantiating the Job. + + + Allows the the job factory to destroy/cleanup the job if needed. + No-op when using SimpleJobFactory. + + Called by the scheduler at the time of the trigger firing, in order to @@ -14064,7 +14120,6 @@ Sets the channel type when registering remoting. - @@ -14074,6 +14129,12 @@ . + + + A Boolean value (true or false) that specifies whether to refuse requests from other computers. + Specifying true allows only remoting calls from the local computer. The default is false. + + A implementation that creates @@ -14649,6 +14710,38 @@ Mohammad Rezaei Marko Lahma (.NET) + + + Manages a collection of IDbProviders, and provides transparent access + to their database. + + + + + Shuts down database connections from the data source with the given name, + if applicable for the underlying provider. + + + + + Get a database connection from the data source with the given name. + + + + + Returns meta data for data source with the given name. + + + + + Gets db provider for data source with the given name. + + + + + Adds a connection provider to data source with the given name. + + Private constructor @@ -14672,7 +14765,6 @@ Shuts down database connections from the DataSource with the given name, if applicable for the underlying provider. - a database connection @@ -14722,6 +14814,12 @@ A new object that is a copy of this instance. + + + Gets the value behind the specified key. + + The key. + When implemented by a class, removes all elements from the . @@ -14881,7 +14979,6 @@ Gets or sets the with the specified key. - @@ -15213,7 +15310,7 @@ The name. - + Gets the int array property. @@ -15310,7 +15407,27 @@ The underlying properties. - + + + Environment access helpers that fail gracefully if under medium trust. + + + + + Retrieves the value of an environment variable from the current process. + + + + + Retrieves all environment variable names and their values from the current process. + + + + + Return whether we are currently running under Mono runtime. + + + Extension methods for . @@ -15465,6 +15582,29 @@ Retrieve the identified value from the . + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + TimeZoneInfo.ConvertTime is not supported under mono + + + + + @@ -15630,6 +15770,9 @@ + + + @@ -15719,6 +15862,7 @@ Chris Bonham James House Marko Lahma (.NET) + Christian Krumm (.NET Bugfix) @@ -15784,6 +15928,14 @@ The system id. The sched. + + + Process the xml file in the given location, and schedule all of the + jobs defined within it. + + stream to read XML data from. + The sched. + Schedules the given sets of jobs and triggers. @@ -15830,6 +15982,15 @@ + + + If true (and is true) then any + job/triggers encountered in this file that already exist is scheduler + will be updated with start time relative to old trigger. Effectively + new trigger's last fire time will be updated to old trigger's last fire time + and trigger's next fire time will updated to be next from this last fire time. + + Gets the log. @@ -17077,6 +17238,14 @@ + + + TimeZone in which to base the schedule. + + the time-zone for the schedule + the updated CalendarIntervalScheduleBuilder + + Extension methods that attach to . @@ -17493,8 +17662,8 @@ body of the job's periodically check some flag to see if an interruption has been requested, and if the flag is set, somehow abort the performance of the rest of the job's work. An example of - interrupting a job can be found in the java source for the class - . It is legal to use + interrupting a job can be found in the source for the class Example7's DumbInterruptableJob + It is legal to use some combination of and synchronization within and in order to have the method block until the @@ -17716,7 +17885,8 @@ orphaned (no s point to it). - If not explicitly set, the default value is . + If not explicitly set, the default value is + - this method sets the value to true. the updated JobBuilder @@ -17777,13 +17947,20 @@ - Set the JobDetail's , adding any values to it - that were already set on this JobBuilder using any of the - other 'usingJobData' methods. + Add all the data from the given to the + 's . the updated JobBuilder + + + Replace the 's with the + given . + + + + Holds state information for instances. @@ -17871,17 +18048,30 @@ 's data map. - + - Retrieve the identified value from the . + Adds the given value as a string version to the + 's data map. - + + + Adds the given value as a string version to the + 's data map. + + + + + Adds the given value as a string version to the + 's data map. + + + Retrieve the identified value from the . - + Retrieve the identified value from the . @@ -17897,11 +18087,6 @@ . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17917,11 +18102,6 @@ Retrieve the identified value from the . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17932,14 +18112,24 @@ Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . @@ -17947,20 +18137,25 @@ Retrieve the identified value from the . - + Gets the date time. The key. - + - Gets the value behind the specified key. + Gets the date time offset. The key. + + + Retrieve the identified value from the . + + An exception that can be thrown by a @@ -18239,26 +18434,6 @@ but it does not want to be fired now. - - - misfire instructions for NthIncludedDayTrigger - - - - - Instructs the that upon a mis-fire situation, the - wants to be fired now by the - - - - - - Instructs the that upon a mis-fire situation, the - wants to have - nextFireTime updated to the next time in the schedule after - the current time, but it does not want to be fired now. - - Misfire instructions for DateIntervalTrigger @@ -18301,468 +18476,6 @@ but it does not want to be fired now. - - - A trigger which fires on the Nth day of every interval type - , or - that is not excluded by the associated - calendar. - - - When determining what the Nth day of the month or year - is, will skip excluded days on the - associated calendar. This would commonly be used in an Nth - business day situation, in which the user wishes to fire a particular job on - the Nth business day (i.e. the 5th business day of - every month). Each also has an associated - which indicates at what time of day the trigger is - to fire. - - All s default to a monthly interval type - (fires on the Nth day of every month) with N = 1 (first - non-excluded day) and set to 12:00 PM (noon). These - values can be changed using the , , and - methods. Users may also want to note the - and - methods. - - - Take, for example, the following calendar: - - - July August September - Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa - 1 W 1 2 3 4 5 W 1 2 W - W H 5 6 7 8 W W 8 9 10 11 12 W W H 6 7 8 9 W - W 11 12 13 14 15 W W 15 16 17 18 19 W W 12 13 14 15 16 W - W 18 19 20 21 22 W W 22 23 24 25 26 W W 19 20 21 22 23 W - W 25 26 27 28 29 W W 29 30 31 W 26 27 28 29 30 - W - - Where W's represent weekend days, and H's represent holidays, all of which - are excluded on a calendar associated with an - with n=5 and - intervalType=IntervalTypeMonthly. In this case, the trigger - would fire on the 8th of July (because of the July 4 holiday), - the 5th of August, and the 8th of September (because - of Labor Day). - - Aaron Craven - Marko Lahma (.NET) - - - - Indicates a monthly trigger type (fires on the Nth included - day of every month). - - - - indicates a yearly trigger type (fires on the Nth included - day of every year). - - - - - Indicates a weekly trigger type (fires on the Nth included - day of every week). When using this interval type, care must be taken - not to think of the value of as an analog to - . Such a comparison can only - be drawn when there are no calendars associated with the trigger. To - illustrate, consider an with - n = 3 which is associated with a Calendar excluding - non-weekdays. The trigger would fire on the 3rd - included day of the week, which would be 4th - actual day of the week. - - - - - Create an with no specified name, - group, or . This will result initially in a - default monthly trigger that fires on the first day of every month at - 12:00 PM (n = 1, - intervalType=, - fireAtTime="12:00"). - - - Note that and , must be - called before the can be placed into - a . - - - - - Create an with the given name and - default group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - - - - Create an with the given name and - group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - the group for the - - - - - Create an with the given name and - group and the specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime="12:00"). - - The name for the . - The group for the . - The name of the job to associate with the . - The group containing the job to associate with the . - - - - Returns the next UTC time at which the - will fire. If the trigger will not fire again, will be - returned. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - The returned value is not guaranteed to be valid until after - the trigger has been added to the scheduler. - - - the next fire time for the trigger - - - - - Returns the previous UTC time at which the - fired. If the trigger has not yet - fired, will be returned. - - the previous fire time for the trigger - - - - Returns the first time the will fire - after the specified date. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - Therefore, for triggers with intervalType = - , if the trigger - will not fire within 12 - weeks after the given date/time, will be returned. For - triggers with intervalType = - - , if the trigger will not fire within 12 - months after the given date/time, will be returned. - For triggers with intervalType = - - , if the trigger will not fire within 12 - years after the given date/time, will be returned. In - all cases, if the trigger will not fire before , - will be returned. - - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - - the first time the trigger will fire following the specified date - - - - - Called when the has decided to 'fire' the trigger - (Execute the associated ), in order to give the - a chance to update itself for its next triggering - (if any). - - - - - Called by the scheduler at the time a is first - added to the scheduler, in order to have the - compute its first fire time, based on any associated calendar. - - After this method has been called, - should return a valid answer. - - - - the first time at which the will be fired - by the scheduler, which is also the same value - will return (until after the first - firing of the ). - - - - - Called after the has executed the - associated with the in order - to get the final instruction code from the trigger. - - - The that was used by the - 's method. - - - The thrown by the - , if any (may be ) - - one of the Trigger.INSTRUCTION_XXX constants. - - - - - Used by the to determine whether or not it is - possible for this to fire again. - ' - - - If the returned value is then the - may remove the from the - - - - - A boolean indicator of whether the trigger could potentially fire - again. - - - - - Indicates whether is a valid misfire - instruction for this . - - Whether is valid. - - - Updates the 's state based on the - MisfireInstruction that was selected when the - was created -

- If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY, - then the instruction will be interpreted as - . -

- - a new or updated calendar to use for the trigger - - - - - Updates the 's state based on the - given new version of the associated . - - A new or updated calendar to use for the trigger - the amount of time that must - be between "now" and the time the next - firing of the trigger is supposed to occur. - - - - - Calculates the first time an with - intervalType = IntervalTypeWeekly will fire - after the specified date. See for more - information. - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Calculates the first UTC time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified date - - - - Calculates the first time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - - - Gets or sets the day of the interval on which the - should fire. If the Nth - day of the interval does not exist (i.e. the 32nd of a - month), the trigger simply will never fire. N may not be less than 1. - - - - - Returns the interval type for the . - - - Sets the interval type for the . If - , the trigger will fire on the - Nth included day of every month. If - , the trigger will fire on the - Nth included day of every year. If - , the trigger will fire on the - Nth included day of every week. - - - - - - - - Returns the fire time for the as a - string with the format "HH:MM[:SS]", with HH representing the - 24-hour clock hour of the fire time. Seconds are optional and their - inclusion depends on whether or not they were provided to - . - - - - - Returns the for the - . - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType" />. - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - method. The default cutoff is 12 - of the intervals specified by intervalType". - - - In most cases, the default value of this setting (12) is sufficient (it - is highly unlikely, for example, that you will need to look at more than - 12 months of dates to ensure that your trigger will never fire again). - However, this setting is included to allow for the rare exceptions where - this might not be true. - - - For example, if your trigger is associated with a calendar that excludes - a great many dates in the next 12 months, and hardly any following that, - it is possible (if is large enough) that you could run - into this situation. - - - - - - Returns the last UTC time the will fire. - If the trigger will not fire at any point between - and , will be returned. - - the last time the trigger will fire. - - - - Tells whether this Trigger instance can handle events - in millisecond precision. - - - - - - Sets or gets the time zone in which the will be resolved. - If no time zone is provided, then the default time zone will be used. - - - - - - - Gets or sets the trigger's calendar week rule. - - The trigger calendar week rule. - - - - Gets or sets the trigger's calendar first day of week rule. - - The trigger calendar first day of week. - An exception that is thrown to indicate that an attempt to store a new @@ -18907,15 +18620,31 @@ - + - A constant key that can be used to retrieve the - scheduled fire time of the original from a recovery + A constant key that can be used to retrieve the + fire time of the original from a recovery trigger's data map in the case of a job recovering after a failed scheduler instance. + + Note that this is the time the original firing actually occurred, + which may be different from the scheduled fire time - as a trigger doesn't + always fire exactly on time. + + + + A constant JobDataMap key that can be used to retrieve the scheduled + fire time of the original Trigger from a recovery trigger's data + map in the case of a job recovering after a failed scheduler instance. + + + Note that this is the time the original firing was scheduled for, which may + be different from the actual firing time - as a trigger doesn't always fire exactly on time. + + Holds context/environment data that can be made available to Jobs as they diff --git a/packages/Quartz.2.2/lib/net40/Quartz.dll b/packages/Quartz.2.2/lib/net40/Quartz.dll new file mode 100644 index 0000000..284f56e Binary files /dev/null and b/packages/Quartz.2.2/lib/net40/Quartz.dll differ diff --git a/packages/Quartz.2.2/lib/net40/Quartz.pdb b/packages/Quartz.2.2/lib/net40/Quartz.pdb new file mode 100644 index 0000000..8f8c3e0 Binary files /dev/null and b/packages/Quartz.2.2/lib/net40/Quartz.pdb differ diff --git a/packages/Quartz.2.0.1/lib/net35/Quartz.xml b/packages/Quartz.2.2/lib/net40/Quartz.xml similarity index 94% rename from packages/Quartz.2.0.1/lib/net35/Quartz.xml rename to packages/Quartz.2.2/lib/net40/Quartz.xml index de320e2..9ee197f 100644 --- a/packages/Quartz.2.0.1/lib/net35/Quartz.xml +++ b/packages/Quartz.2.2/lib/net40/Quartz.xml @@ -42,6 +42,13 @@ + + + Initializes a new instance of the class. + + The internal set to wrap. + internalSet + Simple C5 wrapper for common interface. @@ -270,6 +277,11 @@ that it has started. + + + Called by the to inform the listener that it is starting. + + Called by the to inform the listener @@ -313,7 +325,7 @@ The instance that should be made available within the . - + @@ -348,24 +360,6 @@ Passivates this instance. - - - Completes the trigger retry loop. - - The trigger. - The job detail. - The inst code. - - - - - Vetoeds the job retry loop. - - The trigger. - The job detail. - The inst code. - - Default concrete implementation of . @@ -653,7 +647,7 @@ true if the identified listener was found in the list, andremoved. - + Create a with the given configuration properties. @@ -1594,7 +1588,7 @@ Signals the main processing loop to pause at the next possible point. - + Signals the main processing loop to pause at the next possible point. @@ -1616,18 +1610,6 @@ The main processing loop of the . - - - Trigger retry loop that is executed on error condition. - - The bndle. - - - - Releases the trigger retry loop. - - The trigger. - Gets the log. @@ -1646,12 +1628,6 @@ true if paused; otherwise, false. - - - Gets or sets the db failure retry interval. - - The db failure retry interval. - An interface to be used by instances in order to @@ -1685,6 +1661,11 @@ Signals the scheduling change. + + + Informs scheduler listeners about an exception that has occurred. + + Notifies the scheduler about misfired trigger. @@ -1834,6 +1815,11 @@ Marko Lahma + + + Initializes the db provider implementation. + + Returns a new command object for executing SQL statments/Stored Procedures @@ -1873,12 +1859,10 @@ Connection string used to create connections. - + - Registers DB metadata information for given provider name. + Parse metadata once in static constructor. - - @@ -1887,6 +1871,13 @@ Name of the db provider. The connection string. + + + Registers DB metadata information for given provider name. + + + + Returns a new command object for executing SQL statments/Stored Procedures @@ -2144,25 +2135,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - - Determine whether the calling thread owns a lock on the identified - resource. - - Whether this Semaphore implementation requires a database connection for its lock management operations. - - + @@ -2205,20 +2189,18 @@ true if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - - + Determine whether the calling thread owns a lock on the identified resource. - @@ -2318,6 +2300,11 @@ The fire timestamp. + + + Gets or sets the scheduled fire timestamp. + + Gets or sets a value indicating whether job disallows concurrent execution. @@ -2770,12 +2757,12 @@ Select the job to which the trigger is associated. - The DB Connection - The key identifying the trigger. - The load helper. - - The object associated with the given trigger - + + + + Select the job to which the trigger is associated. Allow option to load actual job class or not. When case of + remove, we do not need to load the type, which in many cases, it's no longer exists. + @@ -3870,14 +3857,14 @@ Delete a job and its listeners. - + Delete a trigger, its listeners, and its Simple/Cron/BLOB sub-table entry. - + @@ -4290,7 +4277,7 @@ if set to true opens a new transaction. JobPersistenceException thrown if a SQLException occurs when the - + Execute the given callback in a transaction. Depending on the JobStore, the surrounding transaction may be assumed to be already present @@ -4299,27 +4286,8 @@ This method just forwards to ExecuteInLock() with a null lockName. - - - - - Execute the given callback having acquired the given lock. - Depending on the JobStore, the surrounding transaction may be - assumed to be already present (managed). This version is just a - handy wrapper around executeInLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a transaction. - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having acquired the given lock. Depending on the JobStore, the surrounding transaction may be @@ -4334,24 +4302,7 @@ The callback to excute after having acquired the given lock. - - - Execute the given callback having optionally acquired the given lock. - This uses the non-managed transaction connection. This version is just a - handy wrapper around executeInNonManagedTXLock that doesn't require a return - value. - - - The name of the lock to acquire, for example - "TRIGGER_ACCESS". If null, then no lock is acquired, but the - lockCallback is still executed in a non-managed transaction. - - - - The callback to excute after having acquired the given lock. - - - + Execute the given callback having optionally acquired the given lock. This uses the non-managed transaction connection. @@ -4364,12 +4315,18 @@ The callback to excute after having acquired the given lock. + Get or set the datasource name. + + + Get or set the database connection manager. + + Gets the log. @@ -4430,14 +4387,21 @@ Whether or not to obtain locks when inserting new jobs/triggers. - Defaults to , which is safest - some db's (such as - MS SQLServer) seem to require this to avoid deadlocks under high load, - while others seem to do fine without. + + Defaults to , which is safest - some db's (such as + MS SQLServer) seem to require this to avoid deadlocks under high load, + while others seem to do fine without. Settings this to false means + isolation guarantees between job scheduling and trigger acquisition are + entirely enforced by the database. Depending on the database and it's + configuration this may cause unusual scheduling behaviors. + + Setting this property to will provide a significant performance increase during the addition of new jobs and triggers. + @@ -4612,15 +4576,15 @@ - + Execute the given callback having optionally acquired the given lock. Because CMT assumes that the connection is already part of a managed transaction, it does not attempt to commit or rollback the enclosing transaction. - - + + @@ -4630,6 +4594,11 @@ Callback to execute. + + + Instructs this job store whether connections should be automatically opened. + + is meant to be used in a standalone environment. @@ -4654,7 +4623,7 @@ - + Execute the given callback having optionally aquired the given lock. For , because it manages its own transactions @@ -5132,15 +5101,6 @@ the key of the job the number of triggers for the given job - - - Select the job to which the trigger is associated. - - the DB Connection - the key of the trigger - The load helper. - The object associated with the given trigger - Select the triggers for a job @@ -5633,12 +5593,12 @@ True if the lock was obtained. - + Release the lock on the identified resource if it is held by the calling thread. - + Determine whether the calling thread owns a lock on the identified resource. @@ -5656,9 +5616,9 @@ its lock management operations. - + - + @@ -5695,6 +5655,11 @@ James House Marko Lahma (.NET) + + + Initializes a new instance of the class. + + Initializes a new instance of the class. @@ -6883,7 +6848,7 @@ - + James House @@ -6926,13 +6891,21 @@ - + James House Sharada Jambula Marko Lahma (.NET) + + + Get a that is configured to produce a + trigger identical to this one. + + + + Get a that is configured to produce a @@ -7640,7 +7613,7 @@ - + 2.0 James House Marko Lahma (.NET) @@ -7893,15 +7866,6 @@ valid for submission into a . - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - Get the time at which the should occur. @@ -8744,11 +8708,6 @@ Zemian Deng saltnlight5@gmail.com Nuno Maia (.NET) - - - - - Get the the number of times for interval this trigger should repeat, @@ -8793,6 +8752,14 @@ Get the number of times the has already fired. + + + Gets the time zone within which time calculations related to this trigger will be performed. + + + If null, the system default TimeZone will be used. + + Used to indicate the 'repeat count' of the trigger is indefinite. Or in @@ -8859,7 +8826,7 @@ , , and . The number of milliseconds to pause between the repeat firing. - + Create a that will occur at the given time, fire the identified job and repeat at the the given @@ -9562,7 +9529,7 @@ the default value, which is currently 30000 ms. The db failure retry interval. - + Creates a scheduler using the specified thread pool and job store and binds it for remote access. @@ -9574,10 +9541,26 @@ The type of job store The idle wait time. You can specify TimeSpan.Zero for - the default value, which is currently 30000 ms. - The db failure retry interval. + the default value, which is currently 30000 ms. + The maximum batch size of triggers, when acquiring them + The time window for which it is allowed to "pre-acquire" triggers to fire + + + + Creates a scheduler using the specified thread pool and job store and + binds it for remote access. + + The name for the scheduler. + The instance ID for the scheduler. + The thread pool for executing jobs + Thread executor. + The type of job store + + The idle wait time. You can specify TimeSpan.Zero for + the default value, which is currently 30000 ms. The maximum batch size of triggers, when acquiring them The time window for which it is allowed to "pre-acquire" triggers to fire + The scheduler exporter to use @@ -9710,7 +9693,7 @@ - + Whether the associated Job class carries the . @@ -9742,7 +9725,7 @@ Create a with the given name, default group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9752,7 +9735,7 @@ Create a with the given name, and group, and the default settings of all the other properties. - If , Scheduler.DefaultGroup will be used. + If , SchedulerConstants.DefaultGroup will be used. If name is null or empty, or the group is an empty string. @@ -9764,7 +9747,7 @@ the given settings of all the other properties. The name. - if , Scheduler.DefaultGroup will be used. + if , SchedulerConstants.DefaultGroup will be used. Type of the job. if set to true, job will be durable. if set to true, job will request recovery. @@ -9907,7 +9890,7 @@ Whether the associated Job class carries the attribute. - + Whether the associated Job class carries the attribute. @@ -10009,6 +9992,19 @@ situation, this method will return . + + + Returns the of the originally scheduled and now recovering job. + + + When recovering a previously failed job execution this property returns the identity + of the originally firing trigger. This recovering job will have been scheduled for + the same firing time as the original job, and so is available via the + property. The original firing time of the job can be + accessed via the + element of this job's . + + Gets the refire count. @@ -10495,8 +10491,7 @@ Halts the 's firing of s, - and cleans up all resources associated with the Scheduler. Equivalent to - . + and cleans up all resources associated with the Scheduler. Equivalent to Shutdown(false). The scheduler cannot be re-started. @@ -10534,7 +10529,7 @@ identified by the 's settings. - + Schedule all of the given jobs with the related set of triggers. @@ -10544,6 +10539,19 @@ parameter is not set to true then an exception will be thrown. + + + Schedule the given job with the related set of triggers. + + + If any of the given job or triggers already exist (or more + specifically, if the keys are not unique) and the replace + parameter is not set to true then an exception will be thrown. + + + + + Remove the indicated from the scheduler. @@ -10595,6 +10603,20 @@ SchedulerException will be thrown. + + + Add the given to the Scheduler - with no associated + . The will be 'dormant' until + it is scheduled with a , or + is called for it. + + + With the parameter + set to true, a non-durable job can be stored. Once it is + scheduled, it will resume normal non-durable behavior (i.e. be deleted + once there are no remaining associated triggers). + + Delete the identified from the Scheduler - and any @@ -11089,6 +11111,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11465,6 +11492,11 @@ Calls the equivalent method on the 'proxied' . + + + Calls the equivalent method on the 'proxied' . + + Calls the equivalent method on the 'proxied' . @@ -11958,7 +11990,7 @@ James House Marko Lahma (.NET) - + An array of objects that were updated/added since the last scan of the directory @@ -13254,20 +13286,11 @@ Data to deserialize object from. - + - that names the scheduler instance using - just the machine hostname. + Helper base class for host name lookup requiring instance id generators. - - This class is useful when you know that your scheduler instance will be the - only one running on a particular machine. Each time the scheduler is - restarted, it will get the same instance id as long as the machine is not - renamed. - - Marko Lahma (.NET) - - + Marko Lahma @@ -13289,6 +13312,28 @@ The clusterwide unique instance id. + + + Generate the instance id for a + + The clusterwide unique instance id. + + + + + that names the scheduler instance using + just the machine hostname. + + + This class is useful when you know that your scheduler instance will be the + only one running on a particular machine. Each time the scheduler is + restarted, it will get the same instance id as long as the machine is not + renamed. + + Marko Lahma (.NET) + + + Generate the instance id for a @@ -13370,6 +13415,11 @@ the newly instantiated Job + + + Allows the the job factory to destroy/cleanup the job if needed. + + Called by the scheduler at the time of the trigger firing, in order to @@ -13390,6 +13440,12 @@ the newly instantiated Job SchedulerException if there is a problem instantiating the Job. + + + Allows the the job factory to destroy/cleanup the job if needed. + No-op when using SimpleJobFactory. + + Called by the scheduler at the time of the trigger firing, in order to @@ -14064,7 +14120,6 @@ Sets the channel type when registering remoting. - @@ -14074,6 +14129,12 @@ . + + + A Boolean value (true or false) that specifies whether to refuse requests from other computers. + Specifying true allows only remoting calls from the local computer. The default is false. + + A implementation that creates @@ -14649,6 +14710,38 @@ Mohammad Rezaei Marko Lahma (.NET) + + + Manages a collection of IDbProviders, and provides transparent access + to their database. + + + + + Shuts down database connections from the data source with the given name, + if applicable for the underlying provider. + + + + + Get a database connection from the data source with the given name. + + + + + Returns meta data for data source with the given name. + + + + + Gets db provider for data source with the given name. + + + + + Adds a connection provider to data source with the given name. + + Private constructor @@ -14672,7 +14765,6 @@ Shuts down database connections from the DataSource with the given name, if applicable for the underlying provider. - a database connection @@ -14722,6 +14814,12 @@ A new object that is a copy of this instance. + + + Gets the value behind the specified key. + + The key. + When implemented by a class, removes all elements from the . @@ -14881,7 +14979,6 @@ Gets or sets the with the specified key. - @@ -15213,7 +15310,7 @@ The name. - + Gets the int array property. @@ -15310,7 +15407,27 @@ The underlying properties. - + + + Environment access helpers that fail gracefully if under medium trust. + + + + + Retrieves the value of an environment variable from the current process. + + + + + Retrieves all environment variable names and their values from the current process. + + + + + Return whether we are currently running under Mono runtime. + + + Extension methods for . @@ -15465,6 +15582,29 @@ Retrieve the identified value from the . + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + TimeZoneInfo.ConvertTime is not supported under mono + + + + + @@ -15630,6 +15770,9 @@ + + + @@ -15719,6 +15862,7 @@ Chris Bonham James House Marko Lahma (.NET) + Christian Krumm (.NET Bugfix) @@ -15784,6 +15928,14 @@ The system id. The sched. + + + Process the xml file in the given location, and schedule all of the + jobs defined within it. + + stream to read XML data from. + The sched. + Schedules the given sets of jobs and triggers. @@ -15830,6 +15982,15 @@ + + + If true (and is true) then any + job/triggers encountered in this file that already exist is scheduler + will be updated with start time relative to old trigger. Effectively + new trigger's last fire time will be updated to old trigger's last fire time + and trigger's next fire time will updated to be next from this last fire time. + + Gets the log. @@ -17077,6 +17238,14 @@ + + + TimeZone in which to base the schedule. + + the time-zone for the schedule + the updated CalendarIntervalScheduleBuilder + + Extension methods that attach to . @@ -17493,8 +17662,8 @@ body of the job's periodically check some flag to see if an interruption has been requested, and if the flag is set, somehow abort the performance of the rest of the job's work. An example of - interrupting a job can be found in the java source for the class - . It is legal to use + interrupting a job can be found in the source for the class Example7's DumbInterruptableJob + It is legal to use some combination of and synchronization within and in order to have the method block until the @@ -17716,7 +17885,8 @@ orphaned (no s point to it). - If not explicitly set, the default value is . + If not explicitly set, the default value is + - this method sets the value to true. the updated JobBuilder @@ -17777,13 +17947,20 @@ - Set the JobDetail's , adding any values to it - that were already set on this JobBuilder using any of the - other 'usingJobData' methods. + Add all the data from the given to the + 's . the updated JobBuilder + + + Replace the 's with the + given . + + + + Holds state information for instances. @@ -17871,17 +18048,30 @@ 's data map. - + - Retrieve the identified value from the . + Adds the given value as a string version to the + 's data map. - + + + Adds the given value as a string version to the + 's data map. + + + + + Adds the given value as a string version to the + 's data map. + + + Retrieve the identified value from the . - + Retrieve the identified value from the . @@ -17897,11 +18087,6 @@ . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17917,11 +18102,6 @@ Retrieve the identified value from the . - - - Retrieve the identified value from the . - - Retrieve the identified value from the . @@ -17932,14 +18112,24 @@ Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . - + - Retrieve the identified value from the . + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . + + + + + Retrieve the identified value from the . @@ -17947,20 +18137,25 @@ Retrieve the identified value from the . - + Gets the date time. The key. - + - Gets the value behind the specified key. + Gets the date time offset. The key. + + + Retrieve the identified value from the . + + An exception that can be thrown by a @@ -18239,26 +18434,6 @@ but it does not want to be fired now. - - - misfire instructions for NthIncludedDayTrigger - - - - - Instructs the that upon a mis-fire situation, the - wants to be fired now by the - - - - - - Instructs the that upon a mis-fire situation, the - wants to have - nextFireTime updated to the next time in the schedule after - the current time, but it does not want to be fired now. - - Misfire instructions for DateIntervalTrigger @@ -18301,468 +18476,6 @@ but it does not want to be fired now. - - - A trigger which fires on the Nth day of every interval type - , or - that is not excluded by the associated - calendar. - - - When determining what the Nth day of the month or year - is, will skip excluded days on the - associated calendar. This would commonly be used in an Nth - business day situation, in which the user wishes to fire a particular job on - the Nth business day (i.e. the 5th business day of - every month). Each also has an associated - which indicates at what time of day the trigger is - to fire. - - All s default to a monthly interval type - (fires on the Nth day of every month) with N = 1 (first - non-excluded day) and set to 12:00 PM (noon). These - values can be changed using the , , and - methods. Users may also want to note the - and - methods. - - - Take, for example, the following calendar: - - - July August September - Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa - 1 W 1 2 3 4 5 W 1 2 W - W H 5 6 7 8 W W 8 9 10 11 12 W W H 6 7 8 9 W - W 11 12 13 14 15 W W 15 16 17 18 19 W W 12 13 14 15 16 W - W 18 19 20 21 22 W W 22 23 24 25 26 W W 19 20 21 22 23 W - W 25 26 27 28 29 W W 29 30 31 W 26 27 28 29 30 - W - - Where W's represent weekend days, and H's represent holidays, all of which - are excluded on a calendar associated with an - with n=5 and - intervalType=IntervalTypeMonthly. In this case, the trigger - would fire on the 8th of July (because of the July 4 holiday), - the 5th of August, and the 8th of September (because - of Labor Day). - - Aaron Craven - Marko Lahma (.NET) - - - - Indicates a monthly trigger type (fires on the Nth included - day of every month). - - - - indicates a yearly trigger type (fires on the Nth included - day of every year). - - - - - Indicates a weekly trigger type (fires on the Nth included - day of every week). When using this interval type, care must be taken - not to think of the value of as an analog to - . Such a comparison can only - be drawn when there are no calendars associated with the trigger. To - illustrate, consider an with - n = 3 which is associated with a Calendar excluding - non-weekdays. The trigger would fire on the 3rd - included day of the week, which would be 4th - actual day of the week. - - - - - Create an with no specified name, - group, or . This will result initially in a - default monthly trigger that fires on the first day of every month at - 12:00 PM (n = 1, - intervalType=, - fireAtTime="12:00"). - - - Note that and , must be - called before the can be placed into - a . - - - - - Create an with the given name and - default group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - - - - Create an with the given name and - group but no specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime=12:00"). - - Note that must - be called before the can be placed - into a . - - - the name for the - - the group for the - - - - - Create an with the given name and - group and the specified . This will result - initially in a default monthly trigger that fires on the first day of - every month at 12:00 PM (=1, - intervalType=, - fireAtTime="12:00"). - - The name for the . - The group for the . - The name of the job to associate with the . - The group containing the job to associate with the . - - - - Returns the next UTC time at which the - will fire. If the trigger will not fire again, will be - returned. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - The returned value is not guaranteed to be valid until after - the trigger has been added to the scheduler. - - - the next fire time for the trigger - - - - - Returns the previous UTC time at which the - fired. If the trigger has not yet - fired, will be returned. - - the previous fire time for the trigger - - - - Returns the first time the will fire - after the specified date. - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType. - - - Therefore, for triggers with intervalType = - , if the trigger - will not fire within 12 - weeks after the given date/time, will be returned. For - triggers with intervalType = - - , if the trigger will not fire within 12 - months after the given date/time, will be returned. - For triggers with intervalType = - - , if the trigger will not fire within 12 - years after the given date/time, will be returned. In - all cases, if the trigger will not fire before , - will be returned. - - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - - the first time the trigger will fire following the specified date - - - - - Called when the has decided to 'fire' the trigger - (Execute the associated ), in order to give the - a chance to update itself for its next triggering - (if any). - - - - - Called by the scheduler at the time a is first - added to the scheduler, in order to have the - compute its first fire time, based on any associated calendar. - - After this method has been called, - should return a valid answer. - - - - the first time at which the will be fired - by the scheduler, which is also the same value - will return (until after the first - firing of the ). - - - - - Called after the has executed the - associated with the in order - to get the final instruction code from the trigger. - - - The that was used by the - 's method. - - - The thrown by the - , if any (may be ) - - one of the Trigger.INSTRUCTION_XXX constants. - - - - - Used by the to determine whether or not it is - possible for this to fire again. - ' - - - If the returned value is then the - may remove the from the - - - - - A boolean indicator of whether the trigger could potentially fire - again. - - - - - Indicates whether is a valid misfire - instruction for this . - - Whether is valid. - - - Updates the 's state based on the - MisfireInstruction that was selected when the - was created -

- If the misfire instruction is set to MISFIRE_INSTRUCTION_SMART_POLICY, - then the instruction will be interpreted as - . -

- - a new or updated calendar to use for the trigger - - - - - Updates the 's state based on the - given new version of the associated . - - A new or updated calendar to use for the trigger - the amount of time that must - be between "now" and the time the next - firing of the trigger is supposed to occur. - - - - - Calculates the first time an with - intervalType = IntervalTypeWeekly will fire - after the specified date. See for more - information. - - The time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Calculates the first UTC time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified date - - - - Calculates the first time an with - intervalType = will fire - after the specified date. See for more - information. - - - The UTC time after which to find the nearest fire time. - This argument is treated as exclusive 舒 that is, - if afterTime is a valid fire time for the trigger, it - will not be returned as the next fire time. - - the first time the trigger will fire following the specified - date - - - - - Get a that is configured to produce a - schedule identical to this trigger's schedule. - - - - - - - Gets or sets the day of the interval on which the - should fire. If the Nth - day of the interval does not exist (i.e. the 32nd of a - month), the trigger simply will never fire. N may not be less than 1. - - - - - Returns the interval type for the . - - - Sets the interval type for the . If - , the trigger will fire on the - Nth included day of every month. If - , the trigger will fire on the - Nth included day of every year. If - , the trigger will fire on the - Nth included day of every week. - - - - - - - - Returns the fire time for the as a - string with the format "HH:MM[:SS]", with HH representing the - 24-hour clock hour of the fire time. Seconds are optional and their - inclusion depends on whether or not they were provided to - . - - - - - Returns the for the - . - - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - property. The default cutoff is 12 - of the intervals specified by intervalType" />. - - - Because of the conceptual design of , - it is not always possible to decide with certainty that the trigger - will never fire again. Therefore, it will search for the next - fire time up to a given cutoff. These cutoffs can be changed by using the - method. The default cutoff is 12 - of the intervals specified by intervalType". - - - In most cases, the default value of this setting (12) is sufficient (it - is highly unlikely, for example, that you will need to look at more than - 12 months of dates to ensure that your trigger will never fire again). - However, this setting is included to allow for the rare exceptions where - this might not be true. - - - For example, if your trigger is associated with a calendar that excludes - a great many dates in the next 12 months, and hardly any following that, - it is possible (if is large enough) that you could run - into this situation. - - - - - - Returns the last UTC time the will fire. - If the trigger will not fire at any point between - and , will be returned. - - the last time the trigger will fire. - - - - Tells whether this Trigger instance can handle events - in millisecond precision. - - - - - - Sets or gets the time zone in which the will be resolved. - If no time zone is provided, then the default time zone will be used. - - - - - - - Gets or sets the trigger's calendar week rule. - - The trigger calendar week rule. - - - - Gets or sets the trigger's calendar first day of week rule. - - The trigger calendar first day of week. - An exception that is thrown to indicate that an attempt to store a new @@ -18907,15 +18620,31 @@ - + - A constant key that can be used to retrieve the - scheduled fire time of the original from a recovery + A constant key that can be used to retrieve the + fire time of the original from a recovery trigger's data map in the case of a job recovering after a failed scheduler instance. + + Note that this is the time the original firing actually occurred, + which may be different from the scheduled fire time - as a trigger doesn't + always fire exactly on time. + + + + A constant JobDataMap key that can be used to retrieve the scheduled + fire time of the original Trigger from a recovery trigger's data + map in the case of a job recovering after a failed scheduler instance. + + + Note that this is the time the original firing was scheduled for, which may + be different from the actual firing time - as a trigger doesn't always fire exactly on time. + + Holds context/environment data that can be made available to Jobs as they