InvalidBerData class - Revision history

JAL: add link to exception example

2016-03-15T18:39:50Z

add link to exception example

← Older revision		Revision as of 18:39, 15 March 2016
Line 10:		Line 10:
	</p>		</p>

			For an outline of how you might use an exception in a function of your own, see this [[Get (HttpRequest function)#exception-eg\|Get method example]].

	The methods of the <var>InvalidBerData</var> exception class are described below.		The methods of the <var>InvalidBerData</var> exception class are described below.

JAL: /* Syntax terms */

2014-08-25T18:50:13Z

Syntax terms

← Older revision		Revision as of 18:50, 25 August 2014
Line 54:		Line 54:
	<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>		<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>

	<tr><th><var class="nobr">%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>		<tr><th><var class="nobr">%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|Usage notes]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>

	<tr><th><var>Position</var></th>		<tr><th><var>Position</var></th>

JAL: /* The InvalidBerData methods */

2014-08-25T18:49:38Z

The InvalidBerData methods

← Older revision		Revision as of 18:49, 25 August 2014
Line 20:		Line 20:
	The methods in the class are described in the subsections that follow. In addition:		The methods in the class are described in the subsections that follow. In addition:
	<ul>		<ul>
	<li>[[Notation conventions for methods~~\|"Notation conventions for methods"~~]] has information		<li>[[Notation conventions for methods]] has information
	about the conventions followed.		about the conventions followed.
	<li>[[InvalidBerData methods syntax~~\|"InvalidBerData methods syntax"~~]] is a single page that contains the syntax diagrams of the methods in the class.		<li>[[InvalidBerData methods syntax]] is a single page that contains the syntax diagrams of the methods in the class.
	</ul>		</ul>

JAL at 18:48, 25 August 2014

2014-08-25T18:48:48Z

← Older revision		Revision as of 18:48, 25 August 2014
Line 4:		Line 4:
	The <var>InvalidBerData</var> class has properties that indicate the position and description of the non-conforming data. There are currently no standardized error codes.		The <var>InvalidBerData</var> class has properties that indicate the position and description of the non-conforming data. There are currently no standardized error codes.

	An <var>InvalidBerData</var> exception can be thrown by any of the [[~~SSL security changes in~~ V8.0#~~XmlDoc version of SSL entities~~\|DER-to-XmlDoc]] methods.		An <var>InvalidBerData</var> exception can be thrown by any of the [[Release notes for Sirius Mods V8.0#DER2Xml\|DER-to-XmlDoc]] methods.

	To produce an <var>InvalidBerData</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement calling the <var>InvalidBerData</var> <var>[[New_(InvalidBerData_constructor)\|New]]</var> constructor:		To produce an <var>InvalidBerData</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement calling the <var>InvalidBerData</var> <var>[[New_(InvalidBerData_constructor)\|New]]</var> constructor:

JAL: /* New constructor */

2014-02-16T01:10:26Z

New constructor

← Older revision		Revision as of 01:10, 16 February 2014
Line 48:		Line 48:
	===Syntax===		===Syntax===
	{{Template:InvalidBerData:New syntax}}		{{Template:InvalidBerData:New syntax}}

	====Syntax terms====		====Syntax terms====
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%invalidBerData</th>		<tr><th>%invalidBerData</th>
	<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>		<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>

	<tr><th><var class="nobr">%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>		<tr><th><var class="nobr">%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>

	<tr><th><var>Position</var></th>		<tr><th><var>Position</var></th>
	<td>This [[Methods#Named parameters\|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>		<td>This [[Methods#Named parameters\|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>

	<tr><th><var>Description</var></th>		<tr><th><var>Description</var></th>
	<td>This name required parameter: <var>Description</var>, is the string, containing a brief description of the exception, that is assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>		<td>This name required parameter: <var>Description</var>, is the string, containing a brief description of the exception, that is assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>
Line 61:		Line 65:
	===Usage notes===		===Usage notes===
	<ul>		<ul>
	<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='unexpected junk after end of BER data')		<li>As described in [[Object variables#Using New or other Constructors\|Using New or other Constructors]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='unexpected junk after end of BER data')

	%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')		%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')

JALWiccan: Automatically generated page update

2014-02-16T00:56:11Z

Automatically generated page update

New page

__NOTOC__
The <var>InvalidBerData</var> exception class validates whether the data being processed by the called method conforms to the BER (Basic Encoding Rules) protocol. BER data is base64-encoded binary data; BER rules are a superset of DER (Distinguished Encoding Rules) rules.

The <var>InvalidBerData</var> class has properties that indicate the position and description of the non-conforming data. There are currently no standardized error codes.

An <var>InvalidBerData</var> exception can be thrown by any of the [[SSL security changes in V8.0#XmlDoc version of SSL entities|DER-to-XmlDoc]] methods.

To produce an <var>InvalidBerData</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions|Throw]]</var> statement calling the <var>InvalidBerData</var> <var>[[New_(InvalidBerData_constructor)|New]]</var> constructor:
<p class="code"> throw %(InvalidBerData):new(position=13, description='did not get expected tag')
</p>

The methods of the <var>InvalidBerData</var> exception class are described below.

This class is available as of <var class="product">[[Sirius Mods]]</var> Version 8.0.

==The InvalidBerData methods==
{{Template:List of InvalidBerData methods}}

The methods in the class are described in the subsections that follow. In addition:
<ul>
<li>[[Notation conventions for methods|"Notation conventions for methods"]] has information
about the conventions followed.
<li>[[InvalidBerData methods syntax|"InvalidBerData methods syntax"]] is a single page that contains the syntax diagrams of the methods in the class.
</ul>

==Description property==
{{Template:InvalidBerData:Description subtitle}}

This <var>[[Classes and Objects#readWrite|ReadOnly]]</var> property returns a description of the data error.
===Syntax===
{{Template:InvalidBerData:Description syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%number</th>
<td>This numeric value is the line in the data being validated where a non-PEM-conforming character was found.
</td></tr>
<tr><th>invalidBerData</th>
<td>A reference to an instance of an <var>InvalidBerData</var> object.
</td></tr></table>

==New constructor==
{{Template:InvalidBerData:New subtitle}}

This method generates an instance of an <var>[[InvalidBerData_class|InvalidBerData]]</var> exception. The <var>New</var> method format is as follows:

===Syntax===
{{Template:InvalidBerData:New syntax}}
====Syntax terms====
<table class="syntaxTable">
<tr><th>%invalidBerData</th>
<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>
<tr><th><var class="nobr">%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>. See [[#Usage notes|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>
<tr><th><var>Position</var></th>
<td>This [[Methods#Named parameters|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>
<tr><th><var>Description</var></th>
<td>This name required parameter: <var>Description</var>, is the string, containing a brief description of the exception, that is assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>
</table>

===Usage notes===
<ul>
<li>As described in [[Object variables#Using New or other Constructors|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='unexpected junk after end of BER data')

%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')

%invalidBer = %invalidBer:new(position=1, description='unexpected junk after end of BER data')
</p>
</ul>

==Position property==
{{Template:InvalidBerData:Position subtitle}}

This <var>[[Classes and Objects#readWrite|ReadOnly]]</var> property returns the position in the (expected) base64-encoded string where a non-BER-conforming character was found.

===Syntax===
{{Template:InvalidBerData:Position syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%number</th>
<td>This numeric value is the position in the base64 string (in the line identified by the value of <var>[[InvalidBerData class#Line property|Line]]</var>) where a non-BER-conforming character was found.
</td></tr>
<tr><th>invalidBerData</th>
<td>A reference to an instance of an <var>InvalidBerData</var> object.
</td></tr></table>

[[Category:System exception classes]]

JAL2 at 16:22, 27 April 2012

2012-04-27T16:22:25Z

← Older revision		Revision as of 16:22, 27 April 2012
Line 61:		Line 61:
	<h3>Usage notes</h3>		<h3>Usage notes</h3>
	<ul>		<ul>
	<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='~~did not get expected tag~~')		<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='unexpected junk after end of BER data')

	%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')		%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')

JAL2 at 16:18, 27 April 2012

2012-04-27T16:18:19Z

← Older revision		Revision as of 16:18, 27 April 2012
Line 65:		Line 65:
	%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')		%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')

	%invalidBer = %invalidBer:new(position=1, description='~~did not get expected tag~~')		%invalidBer = %invalidBer:new(position=1, description='unexpected junk after end of BER data')
	</p>		</p>
	</ul>		</ul>

JAL2 at 16:27, 24 April 2012

2012-04-24T16:27:33Z

← Older revision		Revision as of 16:27, 24 April 2012
Line 1:		Line 1:
	~~'''''Still under construction . . .'''''~~

	__NOTOC__		__NOTOC__
	The <var>InvalidBerData</var> exception class validates whether the data being processed by the called method conforms to the BER (Basic Encoding Rules) protocol. BER data is base64-encoded binary data; BER rules are a superset of DER (Distinguished Encoding Rules) rules.		The <var>InvalidBerData</var> exception class validates whether the data being processed by the called method conforms to the BER (Basic Encoding Rules) protocol. BER data is base64-encoded binary data; BER rules are a superset of DER (Distinguished Encoding Rules) rules.

	The <var>InvalidBerData</var> class has properties that indicate the position and description of the non-conforming data.		The <var>InvalidBerData</var> class has properties that indicate the position and description of the non-conforming data. There are currently no standardized error codes.

	An <var>InvalidBerData</var> exception can be thrown by any of the [[SSL security changes in V8.0#XmlDoc version of SSL entities\|DER-to-XmlDoc]] methods.		An <var>InvalidBerData</var> exception can be thrown by any of the [[SSL security changes in V8.0#XmlDoc version of SSL entities\|DER-to-XmlDoc]] methods.

	~~There are currently no standardized error codes.~~

	To produce an <var>InvalidBerData</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement calling the <var>InvalidBerData</var> <var>[[New_(InvalidBerData_constructor)\|New]]</var> constructor:		To produce an <var>InvalidBerData</var> exception for yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement calling the <var>InvalidBerData</var> <var>[[New_(InvalidBerData_constructor)\|New]]</var> constructor:
	<p class="code"> throw %(InvalidBerData):new(position=13, description='~~BadBad~~')		<p class="code"> throw %(InvalidBerData):new(position=13, description='did not get expected tag')
	</p>		</p>

Line 60:		Line 56:
	<td>This [[Methods#Named parameters\|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>		<td>This [[Methods#Named parameters\|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>
	<tr><th><var>Description</var></th>		<tr><th><var>Description</var></th>
	<td>This name required parameter: <var>Description</var>, ~~specifies~~ the ~~XXXXX to be~~ assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>		<td>This name required parameter: <var>Description</var>, is the string, containing a brief description of the exception, that is assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>
	</table>		</table>

	<h3>Usage notes</h3>		<h3>Usage notes</h3>
	<ul>		<ul>
	<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new		<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalidBer = new(position=1, description='did not get expected tag')

	%invalidBer = %(InvalidBerData):new		%invalidBer = %(InvalidBerData):new(position=1, description='did not get expected tag')

	%invalidBer = %invalidBer:new		%invalidBer = %invalidBer:new(position=1, description='did not get expected tag')
	</p>		</p>
	</ul>		</ul>

JAL2 at 01:29, 24 April 2012

2012-04-24T01:29:07Z

← Older revision		Revision as of 01:29, 24 April 2012
Line 57:		Line 57:
	<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>		<td>A reference to an instance of a <var>InvalidBerData</var> object.</td></tr>
	<tr><th><var>%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>		<tr><th><var>%(InvalidBerData)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>InvalidBerData</var> <var>Constructor</var>.</td></tr>
	~~<tr><th><var>Line</var></th>~~
	<td>This [[Methods#Named parameters\|name required]] parameter: <var>Line</var>, specifies the numeric value (<var class="term">number</var>) for the line number to be assigned to the <var>InvalidBerData</var> exception object's <var>Line</var> property when a data error is encountered. </td></tr>
	<tr><th><var>Position</var></th>		<tr><th><var>Position</var></th>
	<td>This name required parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>		<td>This [[Methods#Named parameters\|name required]] parameter: <var>Position</var>, specifies the numeric value (<var class="term">number</var>) for the position to be assigned to the <var>InvalidBerData</var> exception object's <var>Position</var> property when a data error is encountered. </td></tr>
			<tr><th><var>Description</var></th>
			<td>This name required parameter: <var>Description</var>, specifies the XXXXX to be assigned to the <var>InvalidBerData</var> exception object's <var>Description</var> property when a data error is encountered. </td></tr>
	</table>		</table>