$Web Last Modified - Revision history

JAL at 20:29, 2 September 2014

2014-09-02T20:29:23Z

← Older revision		Revision as of 20:29, 2 September 2014
Line 12:		Line 12:

	===Syntax terms===		===Syntax terms===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>mod_time</th>		<tr><th>mod_time</th>
	<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the <var>$~~Web_Datens~~</var> function to get the current date in this format or use <var>$Web_Date2NS</var> to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.		<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the <var>$Web_DateNS</var> function to get the current date in this format or use <var>$Web_Date2NS</var> to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.
	</td></tr></table>		</td></tr></table>

	===Return codes===		===Return codes===
	<table>		<table class="thJustBold">
	<tr><th>Code</th>		<tr class="head"><th>Code</th>
	<th>Meaning</th></tr>		<th>Meaning</th></tr>

	<tr><th>1</th>		<tr><th>1</th>
	<td>URL has not been modified since browser last downloaded it. A "Not Modified" response has been sent to the browser and the connection has been closed. </td></tr>		<td>URL has not been modified since browser last downloaded it. A "Not Modified" response has been sent to the browser and the connection has been closed. </td></tr>

	<tr><th>0</th>		<tr><th>0</th>
	<td>Last-modified time has been set.		<td>Last-modified time has been set.
	The browser does not have a current version of the URL so the response data must be generated.</td></tr>		The browser does not have a current version of the URL so the response data must be generated.</td></tr>

	<tr><th>-1</th>		<tr><th>-1</th>
	<td>Not a web thread</td></tr>		<td>Not a web thread</td></tr>

	<tr><th>-4</th>		<tr><th>-4</th>
	<td>Invalid datetime value</td></tr>		<td>Invalid datetime value</td></tr>
Line 36:		Line 40:
	<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With <var>$Web_Last_Modified</var>, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.		<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With <var>$Web_Last_Modified</var>, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.
	<p>		<p>
	The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p>		The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p></li>

	<li><var>$Web_Last_Modified</var> is not cumulative. That is, the time set for the "Last-Modified" parameter will be the value passed in the last <var>$Web_Last_Modified</var> call in a web application. In addition, if the time passed to <var>$Web_Last_Modified</var> is less than the value in the "If-Modified-Since" request header parameter, it '''immediately''' sends the "Not Modified" response and closes the connection.		<li><var>$Web_Last_Modified</var> is not cumulative. That is, the time set for the "Last-Modified" parameter will be the value passed in the last <var>$Web_Last_Modified</var> call in a web application. In addition, if the time passed to <var>$Web_Last_Modified</var> is less than the value in the "If-Modified-Since" request header parameter, it '''immediately''' sends the "Not Modified" response and closes the connection.
	<p>		<p>
	These two facts together, strongly suggest that in cases where a response entity is comprised of multiple data sources, each with a possibly different time stamp, the determination of the appropriate last-modified time should be made in <var class="product">User Language</var> before invoking <var>$Web_Last_Modified</var>. In general, the last-modified time should be the most recent (maximum) of the time stamps from the data used to generate the response. </p>		These two facts together, strongly suggest that in cases where a response entity is comprised of multiple data sources, each with a possibly different time stamp, the determination of the appropriate last-modified time should be made in <var class="product">User Language</var> before invoking <var>$Web_Last_Modified</var>. In general, the last-modified time should be the most recent (maximum) of the time stamps from the data used to generate the response. </p></li>

	<li>Browsers send back the time stamp received in the "Last-Modified" parameter verbatim in the "If-Modified-Since" parameter. This eliminates any need for synchronization of the server clock and the browser clock.		<li>Browsers send back the time stamp received in the "Last-Modified" parameter verbatim in the "If-Modified-Since" parameter. This eliminates any need for synchronization of the server clock and the browser clock. </li>

	<li>A final caution: <var>$Web_Last_Modified</var> has a resolution of one second, as do the underlying HTTP parameters: "Last-Modified" and "If-Modified-Since". It is quite possible for a <var class="product">Model 204</var> record to be updated several times within a second. Casual use of time stamps in these cases (no matter what their resolution) can result in a browser being incorrectly informed that a URL has not been modified. To avoid this, it is important to ensure that time stamps on a record '''always''' increase by at least one second no matter what the actual update times. A discussion of this and other browser cache related issues is found in [[Janus Web Server application coding considerations#Understanding browser caching\|"Understanding browser caching"]].		<li>A final caution: <var>$Web_Last_Modified</var> has a resolution of one second, as do the underlying HTTP parameters: "Last-Modified" and "If-Modified-Since". It is quite possible for a <var class="product">Model 204</var> record to be updated several times within a second. Casual use of time stamps in these cases (no matter what their resolution) can result in a browser being incorrectly informed that a URL has not been modified. To avoid this, it is important to ensure that time stamps on a record '''always''' increase by at least one second no matter what the actual update times. A discussion of this and other browser cache related issues is found in [[Janus Web Server application coding considerations#Understanding browser caching\|Understanding browser caching]]. </li>
	</ul>		</ul>

	==Examples==		==Examples==
	In the following example, a customer ID has a MASTER and a BALANCE record associated with it, each with its own time stamp. If neither of these records has been updated since the last time the browser requested the URL associated with this customer ID, there is no need to re-send the response.		In the following example, a customer ID has a <code>MASTER</code> and a <code>BALANCE</code> record associated with it, each with its own time stamp. If neither of these records has been updated since the last time the browser requested the URL associated with this customer ID, there is no need to re-send the response.
	<p class="code">FM: IN CUSTOMER FIND ALL RECORDS FOR WHICH		<p class="code">FM: IN CUSTOMER FIND ALL RECORDS FOR WHICH
	CUSTID = %CUSTID		CUSTID = %CUSTID
Line 72:		Line 76:
	</p>		</p>

	In the above example, the <var class="product">~~User Language~~</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.		In the above example, the <var class="product">SOUL</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.

	If there is any doubt at all about whether an invalid value might be passed to <var>$Web_Last_Modified</var>, the IF clause above should probably be rewritten as:		If there is any doubt at all about whether an invalid value might be passed to <var>$Web_Last_Modified</var>, the IF clause above should probably be rewritten as:

JAL: /* Syntax */

2013-06-05T22:17:07Z

Syntax

← Older revision		Revision as of 22:17, 5 June 2013
Line 8:		Line 8:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Last_Modified</span>(<span class="term"> mod_time )		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Last_Modified</span>(<span class="term"> mod_time</span> )
	</p>		</p>

JALWiccan: Automatically generated page update

2013-04-12T19:56:41Z

Automatically generated page update

← Older revision		Revision as of 19:56, 12 April 2013
Line 8:		Line 8:

	==Syntax==		==Syntax==
	<p class="syntax"><span class="term">%rc</span> = $Web_Last_Modified( mod_time )		<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Last_Modified</span>(<span class="term"> mod_time )
	</p>		</p>

JALWiccan: Automatically generated page update

2013-04-10T18:18:07Z

Automatically generated page update

← Older revision		Revision as of 18:18, 10 April 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:$Web_Last_Modified}}		{{DISPLAYTITLE:$Web_Last_Modified}}
	<span class="pageSubtitle"~~><section begin="desc" /~~>Specify date/time response last updated~~<section end="desc" />~~</span>		<span class="pageSubtitle">Specify date/time response last updated</span>


Line 8:		Line 8:

	==Syntax==		==Syntax==
	<p class="syntax"~~><section begin="syntax" /~~><span class="term">%rc</span> = $Web_Last_Modified( mod_time )		<p class="syntax"><span class="term">%rc</span> = $Web_Last_Modified( mod_time )
	~~<section end="syntax" />~~</p>		</p>

	===Syntax terms===		===Syntax terms===

JAL at 20:59, 26 October 2012

2012-10-26T20:59:54Z

← Older revision		Revision as of 20:59, 26 October 2012
Line 14:		Line 14:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>mod_time</th>		<tr><th>mod_time</th>
	<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the <var>$~~WEB_DATENS~~</var> function to get the current date in this format or use $~~WEB_DATE2NS~~ to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.		<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the <var>$Web_Datens</var> function to get the current date in this format or use <var>$Web_Date2NS</var> to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.
	</td></tr></table>		</td></tr></table>

	===Return codes===		===Return codes===
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>Code</th>		<tr><th>Code</th>
	<th>Meaning</th></tr>		<th>Meaning</th></tr>
Line 34:		Line 34:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With <var>$~~WEB_LAST_MODIFIED~~</var>, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.		<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With <var>$Web_Last_Modified</var>, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.
	<p>		<p>
	The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p>		The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p>
Line 74:		Line 74:
	In the above example, the <var class="product">User Language</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.		In the above example, the <var class="product">User Language</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.

	If there is any doubt at all about whether an invalid value might be passed to <var>$~~WEB_LAST_MODIFIED~~</var>, the IF clause above should probably be rewritten as:		If there is any doubt at all about whether an invalid value might be passed to <var>$Web_Last_Modified</var>, the IF clause above should probably be rewritten as:
	<p class="code">IF $Web_Last_Modified(%LAST_MODIFIED) THEN		<p class="code">IF $Web_Last_Modified(%LAST_MODIFIED) THEN
	IF <var>$Web_Last_Modified</var> NE 1 THEN		IF <var>$Web_Last_Modified</var> NE 1 THEN

JALWiccan: 1 revision

2012-10-26T20:26:23Z

1 revision

← Older revision	Revision as of 20:26, 26 October 2012
(No difference)

JAL at 20:26, 26 October 2012

2012-10-26T20:26:21Z

← Older revision		Revision as of 20:26, 26 October 2012
Line 14:		Line 14:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>mod_time</th>		<tr><th>mod_time</th>
	<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the $WEB_DATENS function to get the current date in this format or use $WEB_DATE2NS to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.		<td>A date/time expressed in seconds since 12 AM on January 1, 1900. You can use the <var>$WEB_DATENS</var> function to get the current date in this format or use $WEB_DATE2NS to produce a date in this format from a date and time stamp in a file. This value is required and must be greater than or equal to 0.
	</td></tr></table>		</td></tr></table>

Line 34:		Line 34:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With $WEB_LAST_MODIFIED, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.		<li>Use <var>$Web_Last_Modified</var> to avoid re-generating or re-sending the same data. With <var>$WEB_LAST_MODIFIED</var>, a response is sent only if the data used to generate the response has been modified since the browser last downloaded it.
	<p>		<p>
	The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p>		The first time a browser requests a URL, <var>$Web_Last_Modified</var> simply sets a response header parameter called "Last-Modified" with the indicated time. If the browser should request the same URL, it will pass this time back as the value of the "If-Modified-Since" parameter. If this parameter is set by a browser, <var>$Web_Last_Modified</var> compares its input time with the time in the "If-Modified-Since" parameter. If the input time is less than or equal to the time in the "If-Modified-Since" parameter, <var>$Web_Last_Modified</var> simply sends a "Not Modified" response to the browser and closes the connection. </p>
Line 74:		Line 74:
	In the above example, the <var class="product">User Language</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.		In the above example, the <var class="product">User Language</var> program exits immediately if a "Not Modified" response is sent to the browser as indicated by a return code of 1 from <var>$Web_Last_Modified</var>. Note however, that the above code will also exit immediately if the value passed to <var>$Web_Last_Modified</var> were invalid, since <var>$Web_Last_Modified</var> returns a -4 if it receives invalid input. This could happen if both time stamps in a customer's record had bad data in it. This type of bug could be fairly difficult to track down, since it would probably result in no data being sent to the browser.

	If there is any doubt at all about whether an invalid value might be passed to $WEB_LAST_MODIFIED, the IF clause above should probably be rewritten as:		If there is any doubt at all about whether an invalid value might be passed to <var>$WEB_LAST_MODIFIED</var>, the IF clause above should probably be rewritten as:
	<p class="code">IF $Web_Last_Modified(%LAST_MODIFIED) THEN		<p class="code">IF $Web_Last_Modified(%LAST_MODIFIED) THEN
	IF <var>$Web_Last_Modified</var> NE 1 THEN		IF <var>$Web_Last_Modified</var> NE 1 THEN

JAL at 19:19, 26 October 2012

2012-10-26T19:19:36Z

← Older revision		Revision as of 19:19, 26 October 2012
Line 5:		Line 5:
	<var>$Web_Last_Modified</var> indicates the date and time that a response entity was last updated. More precisely, it indicates the date and time that the data used to generate the response entity was last updated.		<var>$Web_Last_Modified</var> indicates the date and time that a response entity was last updated. More precisely, it indicates the date and time that the data used to generate the response entity was last updated.

	<var>$Web_Last_Modified</var> requires one argument and returns a numeric status code. It is also callable.		<var>$Web_Last_Modified</var> requires one argument and returns a numeric status code. It is also [[Calling Sirius Mods $functions\|callable]].

	==Syntax==		==Syntax==

JALWiccan: 1 revision

2012-10-26T19:16:35Z

1 revision

← Older revision	Revision as of 19:16, 26 October 2012
(No difference)

JALWiccan: 1 revision

2012-10-26T19:16:34Z

1 revision

← Older revision		Revision as of 19:16, 26 October 2012
Line 5:		Line 5:
	<var>$Web_Last_Modified</var> indicates the date and time that a response entity was last updated. More precisely, it indicates the date and time that the data used to generate the response entity was last updated.		<var>$Web_Last_Modified</var> indicates the date and time that a response entity was last updated. More precisely, it indicates the date and time that the data used to generate the response entity was last updated.

	<var>$Web_Last_Modified</var> requires one argument and returns a numeric status code. It is also callable ~~(see [[Calling_Sirius_Mods_$functions\|"Calling Sirius Mods $functions"]])~~.		<var>$Web_Last_Modified</var> requires one argument and returns a numeric status code. It is also callable.

	==Syntax==		==Syntax==