java.lang.Object
jakarta.xml.ws.spi.Invoker
Invoker hides the detail of calling into application endpoint
implementation. Container hands over an implementation of Invoker
to Jakarta XML Web Services runtime, and Jakarta XML Web Services runtime calls
invoke(java.lang.reflect.Method, java.lang.Object...)
for a web service invocation. Finally, Invoker does the actual
invocation of web service on endpoint instance.
Container also injects the provided WebServiceContext
and takes
care of invoking jakarta.annotation.PostConstruct
methods,
if present, on the endpoint implementation.
- Author:
- Jitendra Kotamraju
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract void
inject
(WebServiceContext webServiceContext) Jakarta XML Web Services runtimes calls this method to ask container to inject WebServiceContext on the endpoint instance.abstract Object
Jakarta XML Web Services runtime calls this method to do the actual web service invocation on endpoint instance.
-
Constructor Details
-
Invoker
public Invoker()
-
-
Method Details
-
inject
public abstract void inject(WebServiceContext webServiceContext) throws IllegalAccessException, IllegalArgumentException, InvocationTargetException Jakarta XML Web Services runtimes calls this method to ask container to inject WebServiceContext on the endpoint instance. TheWebServiceContext
object uses thread-local information to return the correct information during the actual endpoint invocation regardless of how many threads are concurrently being used to serve requests.- Parameters:
webServiceContext
- a holder for MessageContext- Throws:
IllegalAccessException
- if the injection done by reflection API throws this exceptionIllegalArgumentException
- if the injection done by reflection API throws this exceptionInvocationTargetException
- if the injection done by reflection API throws this exception
-
invoke
public abstract Object invoke(Method m, Object... args) throws IllegalAccessException, IllegalArgumentException, InvocationTargetException Jakarta XML Web Services runtime calls this method to do the actual web service invocation on endpoint instance. The injectedWebServiceContext.getMessageContext()
gives the correct information for this invocation.- Parameters:
m
- Method to be invoked on the serviceargs
- Method arguments- Returns:
- return value of the method
- Throws:
IllegalAccessException
- if the invocation done by reflection API throws this exceptionIllegalArgumentException
- if the invocation done by reflection API throws this exceptionInvocationTargetException
- if the invocation done by reflection API throws this exception- See Also:
-