Artefact:Model/com/sphenon/basics/exception/ExceptionError - Revision history

AndreasLeue at 10:00, 26 March 2010

2010-03-26T10:00:14Z

← Older revision		Revision as of 10:00, 26 March 2010
Line 47:		Line 47:
	circumstance is misguided.		circumstance is misguided.

	Classes dervied from [[Artefact:Model/com/sphenon/basics/~~exceptions~~/ExceptionError\|ExceptionError]]		Classes dervied from [[Artefact:Model/com/sphenon/basics/exception/ExceptionError\|ExceptionError]]
	provide a categorisation which shall help locating the effective cause		provide a categorisation which shall help locating the effective cause
	of the problem as far as possible. Additional information, supporting		of the problem as far as possible. Additional information, supporting
	this goal, should be provided within the message and context.		this goal, should be provided within the message and context.

	In contrast to [[Artefact:Model/com/sphenon/basics/~~exceptions~~/ExceptionError\|ExceptionError]]s,		In contrast to [[Artefact:Model/com/sphenon/basics/exception/ExceptionError\|ExceptionError]]s,
	[[Artefact:Model/com/sphenon/basics/~~exceptions~~/ReturnCode\|ReturnCode]]s		[[Artefact:Model/com/sphenon/basics/exception/ReturnCode\|ReturnCode]]s
	reflect normal process results which should be handled by the caller.		reflect normal process results which should be handled by the caller.

	In case you are concerned with transaction failure handling, please be sure		In case you are concerned with transaction failure handling, please be sure
	to also read and understand the documentation of [[Artefact:Model/com/sphenon/basics/~~exceptions~~/TransactionFailure\|TransactionFailure]]s		to also read and understand the documentation of [[Artefact:Model/com/sphenon/basics/exception/TransactionFailure\|TransactionFailure]]s
	and the various implications.		and the various implications.

AndreasLeue at 09:25, 26 March 2010

2010-03-26T09:25:31Z

← Older revision		Revision as of 09:25, 26 March 2010
Line 12:		Line 12:

	<wiml>		<wiml>
	* ExceptionError ~~Exception~~		* ExceptionError
	> java.lang.Error		> java.lang.Error
	</wiml>		</wiml>

AndreasLeue at 09:08, 26 March 2010

2010-03-26T09:08:43Z

← Older revision		Revision as of 09:08, 26 March 2010
Line 53:		Line 53:

	In contrast to [[Artefact:Model/com/sphenon/basics/exceptions/ExceptionError\|ExceptionError]]s,		In contrast to [[Artefact:Model/com/sphenon/basics/exceptions/ExceptionError\|ExceptionError]]s,
	[[Artefact:Model/com/sphenon/basics/exceptions/ReturnCode\|~~ReturnCodeg~~]]s		[[Artefact:Model/com/sphenon/basics/exceptions/ReturnCode\|ReturnCode]]s
	reflect normal process results which should be handled by the caller.		reflect normal process results which should be handled by the caller.

AndreasLeue at 09:04, 26 March 2010

2010-03-26T09:04:03Z

← Older revision		Revision as of 09:04, 26 March 2010
Line 4:		Line 4:
	\| Meta_Category = Type:org/oomodels/wiki/Model		\| Meta_Category = Type:org/oomodels/wiki/Model
	\| Meta_Download = true		\| Meta_Download = true
			\| Meta_Diagram = Artefact:Diagram/com/sphenon/basics/exception/Exceptions
	\| Meta_AddTypeToCategory = true		\| Meta_AddTypeToCategory = true
	\| Meta_AddCategoryToCategory = true		\| Meta_AddCategoryToCategory = true

AndreasLeue at 09:02, 26 March 2010

2010-03-26T09:02:58Z

← Older revision		Revision as of 09:02, 26 March 2010
Line 33:		Line 33:
	These exceptions do not belong to the contract, since declaring them		These exceptions do not belong to the contract, since declaring them
	in the interface of the class would be the same as saying "This		in the interface of the class would be the same as saying "This
	class can be faulty due to bugs or misconfiguration", which is		class can be faulty due to bugs or misconfiguration", which is
	of at least questionable usefullness.		of at least questionable usefullness.

AndreasLeue at 09:02, 26 March 2010

2010-03-26T09:02:32Z

← Older revision		Revision as of 09:02, 26 March 2010
Line 14:		Line 14:
	> java.lang.Error		> java.lang.Error
	</wiml>		</wiml>

			== Description ==

			ExceptionErrors reflect "real" (i.e. in fact
			''exceptional'') exceptions, i.e. erraneous,
			unforeseeable and typically not handable situations. The name
			emphasises this excepional, erraneous character.

			The decision to derive from <code>Error</code> instead of
			<code>RuntimeException</code> was made with intent. The
			contract of <code>Exception</code> states explicitly
			"that a reasonable application might want to catch"
			them. This is simply not true for the kind of exceptions defined
			here, since they reflect actual errors. No reasonable application
			should catch them, except for robust server main loops, but these may
			want to catch every <code>Throwable</code> anyway.

			These exceptions do not belong to the contract, since declaring them
			in the interface of the class would be the same as saying "This
			class can be faulty due to bugs or misconfiguration", which is
			of at least questionable usefullness.

			In contrast to the semi-consequent solution of the introduction of
			<code>RuntimeException</code>s, we make a sharp and easily
			understandable distinction here between actual errors and normal
			processing conditions. An index out of bounds can have several
			different causes: a faulty vm, a programming error, a usage error
			by another programmer (contract violation), an end user input
			error. The cases should be distinguished and each one handled
			appropriately. Just allowing to throw the respective exception in any
			circumstance is misguided.

			Classes dervied from [[Artefact:Model/com/sphenon/basics/exceptions/ExceptionError\|ExceptionError]]
			provide a categorisation which shall help locating the effective cause
			of the problem as far as possible. Additional information, supporting
			this goal, should be provided within the message and context.

			In contrast to [[Artefact:Model/com/sphenon/basics/exceptions/ExceptionError\|ExceptionError]]s,
			[[Artefact:Model/com/sphenon/basics/exceptions/ReturnCode\|ReturnCodeg]]s
			reflect normal process results which should be handled by the caller.

			In case you are concerned with transaction failure handling, please be sure
			to also read and understand the documentation of [[Artefact:Model/com/sphenon/basics/exceptions/TransactionFailure\|TransactionFailure]]s
			and the various implications.

AndreasLeue at 08:50, 26 March 2010

2010-03-26T08:50:34Z

← Older revision		Revision as of 08:50, 26 March 2010
Line 11:		Line 11:

	<wiml>		<wiml>
	* ExceptionError		* ExceptionError Exception
	> java.lang.Error		> java.lang.Error
	</wiml>		</wiml>

AndreasLeue: New page: {{Metabox | Meta_Type = Type:org/oomodels/WIML/1.0 | Meta_Domain = Domain:it/test | Meta_Category = Type:org/oomodels/wiki/Model | Meta_Downloa...

2010-03-26T08:49:56Z

New page: {{Metabox | Meta_Type = Type:org/oomodels/WIML/1.0 | Meta_Domain = Domain:it/test | Meta_Category = Type:org/oomodels/wiki/Model | Meta_Downloa...

New page

{{Metabox
| Meta_Type = Type:org/oomodels/WIML/1.0
| Meta_Domain = Domain:it/test
| Meta_Category = Type:org/oomodels/wiki/Model
| Meta_Download = true
| Meta_AddTypeToCategory = true
| Meta_AddCategoryToCategory = true
}}

== Code ==

<wiml>
* ExceptionError
> java.lang.Error
</wiml>