Rogue Wave web site:  Home Page  |  Main Documentation Page

rwsf::ServiceShutdownException Class Reference
[Exceptions]

Shuts down a service and sends an error message. More...

#include <rwsf/webservice/except.h>

Inheritance diagram for rwsf::ServiceShutdownException:

List of all members.

Public Member Functions
	ServiceShutdownException ()
	ServiceShutdownException (const char *msg)
virtual	~ServiceShutdownException () throw ()

---

Detailed Description

Class rwsf::ServiceShutdownException provides a means to shut down a service from within the service implementation.

In the case of HTTP and HTTPS transports, any request that results in this server exception, the server sends a 500 "Internal Server Error" response back.

For the RWSF Agent, the service is taken out of service and subsequent requests yield the "Not Found" 400 error, which is standard Agent behavior.

For a standalone HTTP or HTTPS server, the listener shuts down and subsequent requests fail. The thread that contains the listener object can then call the method isStopped() to see if has been shut down.

Note:

This is the only exception class in webservices. All other exception classes are in the RWSF Core Library.

---

Constructor & Destructor Documentation

rwsf::ServiceShutdownException::ServiceShutdownException

(

)

Default constructor. Creates an exception with the message "Service Shutdown".

rwsf::ServiceShutdownException::ServiceShutdownException

(

const char *

msg

)

Creates an exception with the message msg.

virtual rwsf::ServiceShutdownException::~ServiceShutdownException

(

)

throw () [virtual]

Default destructor.