# ServiceHandler

###### Identifier:

org.eclipse.rap.ui.serviceHandler

###### Since:

RAP 1.3

###### Description:

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 and register it as an extension.
To invoke the service handler a developer needs to construct a URL. The URL must contain the agreed on parameter value like this: `http://localhost:9090/rap?custom_service_handler=myServiceHandler`.

###### Configuration Markup:

<!ELEMENT extension (serviceHandler+)+>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED

>

<!ELEMENT serviceHandler EMPTY>

<!ATTLIST serviceHandler

id CDATA #REQUIRED

class CDATA #REQUIRED

>

- id - Represents the service handler's request parameter value.
- class - An implementation of `IServiceHandler`

###### Examples:

The following is an example of a ServiceHandler extension definition:

      <extension point="org.eclipse.rap.ui.serviceHandler">
          <serviceHandler
                class="org.eclipse.rap.ui.impl.ServiceHandler1"
                id="myHandler1">
          </serviceHandler>
          <serviceHandler
                class="org.eclipse.rap.ui.ServiceHandler2"
                id="myHandler2">
          </serviceHandler>
       </extension>

Copyright (c) 2008 EclipseSource and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html