org.eclipse.rwt.service
Interface IServiceHandler
- public interface IServiceHandler
A service handler is responsible for taking a request and sending
an appropriate response by bypassing the standard lifecycle. Clients
are free to implement custom service handlers. Implementing a custom
service handler involves three steps:
- Implementing the IServiceHandler interface, e.g.
public class MyServiceHandler implements IServiceHandler {
public void service() throws IOException, ServletException {
HttpServletResponse response = ContextProvider.getResponse();
response.getWriter().write( "Hello World" );
}
}
- Writing an XML file which assigns the service handler to a request
parameter value. In order to be found, the XML file must be located at
the root of the classpath and named
servicehandler.xml
.
<?xml version="1.0" encoding="UTF-8"?>
<servicehandler>
<handler
class="org.demo.MyServiceHandler"
requestparameter="myServiceHandler"/>
</servicehandler>
Each servicehandler.xml
may contain any number of handler
entries.
- Constructing the URL to invoke the service handler. The URL must contain
the agreed on parameter value like this:
https://localhost:9090/rap?custom_service_handler=myServiceHandler
.
The following example code snippet achieves this
StringBuffer url = new StringBuffer();
url.append( URLHelper.getURLString( false ) );
url.append( "?" );
url.append( IServiceHandler.REQUEST_PARAM );
url.append( "=myServiceHandler" );
String encodedURL = RWT.getResponse().encodeURL( url.toString() );
-
Since:
- 1.0
Field Summary
|
static
String
|
REQUEST_PARAM
The request parameter name to hold the service handlers name as its
value (value is custom_service_handler). |
Method Summary
|
void
|
service
()
This method is called by the RAP lifecycle to allow the service
handler to respond to a request. |
REQUEST_PARAM
public static final
String REQUEST_PARAM
-
The request parameter name to hold the service handlers name as its
value (value is custom_service_handler).
-
See Also:
-
Constant Field Values
service
public void service()
throws
IOException,
ServletException
-
This method is called by the RAP lifecycle to allow the service
handler to respond to a request.
-
-
Throws:
-
IOException
-
ServletException
Copyright (c) Innoopract Informationssysteme GmbH and others 2002, 2008. All rights reserved.