Author: tandraschko Date: Mon Jul 14 09:47:16 2014 New Revision: 1610367 URL: http://svn.apache.org/r1610367 Log: #DELTASPIKE-642 Better structure for Core documentation
Modified: deltaspike/site/trunk/content/core.mdtext Modified: deltaspike/site/trunk/content/core.mdtext URL: http://svn.apache.org/viewvc/deltaspike/site/trunk/content/core.mdtext?rev=1610367&r1=1610366&r2=1610367&view=diff ============================================================================== --- deltaspike/site/trunk/content/core.mdtext (original) +++ deltaspike/site/trunk/content/core.mdtext Mon Jul 14 09:47:16 2014 @@ -496,10 +496,10 @@ most cases, you register an exception ha method. Alternatively, you can handle an exception programmatically, just as you would observe an event in CDI. -Exception Handling - Usage +### Exception Handling - Usage -------------------------- -### Eventing into the exception handling framework +#### Eventing into the exception handling framework The entire exception handling process starts with an event. This helps keep your application minimally coupled to DeltaSpike, but also allows for further @@ -535,7 +535,7 @@ class for use later within a try/catch b The event is fired with a new instance of `ExceptionToCatchEvent` constructed with the exception to be handled. -Exception handlers +### Exception handlers ------------------ As an application developer (i.e., an end user of DeltaSpike's exception @@ -568,14 +568,14 @@ Exception handlers are considered equal class, have the same qualifiers, the same ordinal and the same value for `isBeforeHandler()`. -### Exception handler annotations +#### Exception handler annotations Exception handlers are contained within exception handler beans, which are CDI beans annotated with `@ExceptionHandler`. Exception handlers are methods which have a parameter which is an instance of `ExceptionEvent<T extends Throwable>` annotated with the `@Handles` annotation. -#### `@ExceptionHandler` +##### `@ExceptionHandler` The `@ExceptionHandler` annotation is simply a marker annotation that instructs the DeltaSpike exception handling CDI extension to scan the bean for @@ -590,7 +590,7 @@ Let's designate a CDI bean as an excepti That's all there is to it. Now we can begin defining exception handling methods on this bean. -#### `@Handles` and `@BeforeHandles` +##### `@Handles` and `@BeforeHandles` `@Handles` is a method parameter annotation that designates a method as an exception handler. Exception handler methods are registered on beans annotated @@ -691,7 +691,7 @@ exceptions. Should a handler throw an un the stack and all handling done via DeltaSpike will cease. Any exception that was being handled will be lost. -Exception Chain Processing +### Exception Chain Processing -------------------------- When an exception is thrown, chances are it's nested (wrapped) inside other @@ -738,7 +738,7 @@ If there's a handler for `PersistenceExc handlers for `EJBException` from being invoked, which is a good thing since what useful information can really be obtained from `EJBException`? -Handler ordinal +### Handler ordinal --------------- When DeltaSpike finds more than one handler for the same exception type, it @@ -783,7 +783,7 @@ application developers: - `ExceptionEvent` - `ExceptionStackEvent` -### ExceptionEvent +#### ExceptionEvent In addition to providing information about the exception being handled, the `ExceptionEvent` object contains methods to control the exception handling