Modifier | Constructor and Description |
---|---|
protected |
ServiceDelegator(String name) |
Modifier and Type | Method and Description |
---|---|
void |
after(EventPredicate matcher,
Handler handler)
|
void |
before(EventPredicate matcher,
Handler handler)
|
void |
emit(EventContext context)
The generic consumption API to emit arbitrary events, represented by
EventContext objects. |
Service |
getDelegatedService() |
String |
getName()
Returns the name of the
Service . |
void |
on(EventPredicate matcher,
Handler handler)
|
protected ServiceDelegator(String name)
public void before(EventPredicate matcher, Handler handler)
Service
Handler
on this Service
for the BEFORE phase of the processing of an EventContext
.
Using the EventPredicate
the relevant events and entities, for which the Handler
should become active can be selected.
Handler
are called one after the other and can abort the complete processing of the event at any time by throwing an exception.
If during the BEFORE phase the EventContext.setCompleted()
method is called, the event processing directly jumps to the AFTER phase.
If no Handler
completes the EventContext
during the BEFORE phase, or does not abort the event processing by throwing an exception, the ON phase is started.before
in interface Service
matcher
- the EventPredicate
, defining for which events and entities the Handler
becomes active.handler
- the Handler
implementing the business-logic, which should become active during the BEFORE phase.public void on(EventPredicate matcher, Handler handler)
Service
Handler
on this Service
for the ON phase of the processing of an EventContext
.
Using the EventPredicate
the relevant events and entities, for which the Handler
should become active can be selected.
Handler
should compute the output parameters based in the input parameters of the event.
Handler
are called one after the other. If a Handler
performs any action during the ON phase, it should call EventContext.setCompleted()
to indicate that the event was successfully processed.
As soon as the EventContext
is completed, the ON phase is finished and the event processing jumps to the AFTER phase.
In case a Handler
throws an exception the event processing is aborted.
If no Handler
completes the EventContext
during the ON phase, it is treated as an error and an exception is thrown.on
in interface Service
matcher
- the EventPredicate
, defining for which events and entities the Handler
becomes active.handler
- the Handler
implementing the business-logic, which should become active during the ON phase.public void after(EventPredicate matcher, Handler handler)
Service
Handler
on this Service
for the AFTER phase of the processing of an EventContext
.
Using the EventPredicate
the relevant events and entities, for which the Handler
should become active can be selected.
Handler
are called one after the other. A Handler
in this phase can still abort the event processing by throwing an exception. No further Handler
are called in this case.
Alternatively it can also call ChangeSetContext.markForCancel()
, which cancels the active ChangeSetContext
and causes a rollback of transactions. However it does not abort the event processing itself.after
in interface Service
matcher
- the EventPredicate
, defining for which events and entities the Handler
becomes active.handler
- the Handler
implementing the business-logic, which should become active during the AFTER phase.public void emit(EventContext context)
Service
EventContext
objects.
More specialized consumption APIs (for example CdsService
) are implemented as a wrapper around this method.
EventContext
will start the processing of the event and calls the registered Handler
instances.
If Service.emit(EventContext)
is called outside of an active ChangeSetContext
, an internal ChangeSetContext
is opened and properly closed.
Handler
can therefore rely on an active ChangeSetContext
.
EventContext
passed to this method, should be propagated with the required input parameters of the event.
After the method finished, the respective output parameters can be read from the passed in EventContext
.emit
in interface Service
context
- the EventContext
to be emittedpublic String getName()
Service
Service
.
The name might be the fully qualified name of a service, which is also present in the CdsModel
.
If the service is a technical service, the name is an arbitrary name, which is not reflected in the CdsModel
.public Service getDelegatedService()
Copyright © 2020. All rights reserved.