Invoker

java.lang.Object
- jakarta.xml.ws.spi.Invoker

```
public abstract class Invoker
extends java.lang.Object
```
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.

Since:

1.7, JAX-WS 2.2

See Also:

Provider.createEndpoint(String, Class, Invoker, WebServiceFeature...)

Constructor Summary

Constructors
Constructor and Description

Invoker()

Constructors
Constructor and Description
`Invoker()`

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`abstract void`	`inject(WebServiceContext webServiceContext)` Jakarta XML Web Services runtimes calls this method to ask container to inject WebServiceContext on the endpoint instance.
`abstract java.lang.Object`	`invoke(java.lang.reflect.Method m, java.lang.Object... args)` Jakarta XML Web Services runtime calls this method to do the actual web service invocation on endpoint instance.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Invoker
```
public Invoker()
```
- Method Detail
  - inject
```
public abstract void inject(WebServiceContext webServiceContext)
                     throws java.lang.IllegalAccessException,
                            java.lang.IllegalArgumentException,
                            java.lang.reflect.InvocationTargetException
```
    Jakarta XML Web Services runtimes calls this method to ask container to inject WebServiceContext on the endpoint instance. The WebServiceContext 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:
    
    java.lang.IllegalAccessException - if the injection done by reflection API throws this exception
    
    java.lang.IllegalArgumentException - if the injection done by reflection API throws this exception
    
    java.lang.reflect.InvocationTargetException - if the injection done by reflection API throws this exception
  - invoke
```
public abstract java.lang.Object invoke(java.lang.reflect.Method m,
                                        java.lang.Object... args)
                                 throws java.lang.IllegalAccessException,
                                        java.lang.IllegalArgumentException,
                                        java.lang.reflect.InvocationTargetException
```
    Jakarta XML Web Services runtime calls this method to do the actual web service invocation on endpoint instance. The injected WebServiceContext.getMessageContext() gives the correct information for this invocation.
    
    Parameters:
    
    m - Method to be invoked on the service
    
    args - Method arguments
    
    Returns:
    
    return value of the method
    
    Throws:
    
    java.lang.IllegalAccessException - if the invocation done by reflection API throws this exception
    
    java.lang.IllegalArgumentException - if the invocation done by reflection API throws this exception
    
    java.lang.reflect.InvocationTargetException - if the invocation done by reflection API throws this exception
    
    See Also:
    
    Method.invoke(java.lang.Object, java.lang.Object...)

Class Invoker

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Invoker

Method Detail

inject

invoke