Package javax.xml.ws.spi
Class Invoker
java.lang.Object
javax.xml.ws.spi.Invoker
Invoker hides the detail of calling into application endpoint
implementation. Container hands over an implementation of Invoker
to JAX-WS runtime, and jax-ws 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 javax.annotation.PostConstruct
methods,
if present, on the endpoint implementation.- Since:
- JAX-WS 2.2
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionabstract void
inject
(WebServiceContext webServiceContext) JAX-WS runtimes calls this method to ask container to inject WebServiceContext on the endpoint instance.abstract Object
JAX-WS 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 JAX-WS 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 JAX-WS 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:
-