|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.axis2.jaxws.core.controller.InvocationController
public abstract class InvocationController
The InvocationController is an abstract implementation modeling the invocation of a target web service. All of the information that the InvocationController needs should exist within the InvocatonContext that is passed in to the various invoke methods.
The request information is passed in within the InvocationContext. The InvocationController assumes that there is a MessageContext within that InvocationContext that is populated with all of the information that it needs to invoke. If not, an error will be returned. Once the response comes back, the information for that response will be held inside of the MessageContext representing the response, that exists in the InvocationContext. The InvocationController supports four different invocation patterns: 1) synchronous - This is represented by theinvoke(InvocationContext)
method. This is a
blocking, request/response call to the web service.
2) one-way - This is represented by the invokeOneWay(InvocationContext)
method. This is
a one-way invocation that only returns errors related to sending the message. If an error occurs
while processing, the client will not be notified.
3) asynchronous (callback) - invokeAsync(InvocationContext, AsyncHandler)
4) asynchronous (polling) - invokeAsync(InvocationContext)
Constructor Summary | |
---|---|
InvocationController()
|
Method Summary | |
---|---|
protected abstract MessageContext |
doInvoke(MessageContext request)
|
abstract Response |
doInvokeAsync(MessageContext mc)
|
abstract java.util.concurrent.Future<?> |
doInvokeAsync(MessageContext mc,
AsyncHandler asyncHandler)
|
protected abstract void |
doInvokeOneWay(MessageContext mc)
|
InvocationContext |
invoke(InvocationContext ic)
Performs a synchronous (blocking) invocation of a target service. |
Response |
invokeAsync(InvocationContext ic)
Performs an asynchronous (non-blocking) invocation of the client based on a callback model. |
java.util.concurrent.Future<?> |
invokeAsync(InvocationContext ic,
AsyncHandler asyncHandler)
Performs an asynchronous (non-blocking) invocation of the client based on a polling model. |
void |
invokeOneWay(InvocationContext ic)
Performs a one-way invocation of the client. |
protected abstract void |
prepareRequest(MessageContext mc)
Abstract method that must be implemented by whoever is providing the specific client binding. |
protected abstract void |
prepareResponse(MessageContext mc)
Abstract method that must be implemented by whoever is providing the specific client binding. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public InvocationController()
Method Detail |
---|
public InvocationContext invoke(InvocationContext ic)
ic
-
protected abstract MessageContext doInvoke(MessageContext request)
public void invokeOneWay(InvocationContext ic)
ic
- protected abstract void doInvokeOneWay(MessageContext mc)
public Response invokeAsync(InvocationContext ic)
ic
- callback
-
public abstract Response doInvokeAsync(MessageContext mc)
public java.util.concurrent.Future<?> invokeAsync(InvocationContext ic, AsyncHandler asyncHandler)
ic
-
public abstract java.util.concurrent.Future<?> doInvokeAsync(MessageContext mc, AsyncHandler asyncHandler)
protected abstract void prepareRequest(MessageContext mc)
mc
- protected abstract void prepareResponse(MessageContext mc)
mc
-
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |