10.2.1

[[QXPSMServiceManager requestService]
processRequestForRequestCmd:qRequestContext];
If made from QuarkXPress Server, this request would look like this:
http://[server>]:[port]/saveas/qxpdoc/MyDoc.qxp?newname="NewDoc.qxp"
Extending QuarkXPress Server Manager
Custom XTensions written for XPressServer can be used in the QuarkXPress Server
Manager Web service interface in two ways:
• Using the Extensibility tool in the QXPSM SDK. With this tool, you can easily update
QXPSM Web service objects to include objects corresponding to custom request
handlers and their parameters.
• Using the RequestParameters class. This is a generic request class that can be used in
lieu of any class, existing or otherwise.
The prerequisites for using the Extensibility tool are as follows:
• JDK 1.6
• Apache ANT 1.6.5 or later
• Perl 5.8.4 or later with the XML::DOM module
•
Third-party libraries (available at [QXPSM application
folder]\Server\dependencies)
•
QXPSM libraries (avaiable at [QXPSM application folder]\Server\lib
• Microsoft .NET Framework 3.5 or later (required only for generating .NET stubs)
The Extensibility tool is located in the XDK/Extensibility folder. For instructions
on how to use it, see the following topics.
Writing special request handlers
If you need to perform custom actions on specific flags, you need to define special
flags and write handlers for them. These flags can then be passed as GET parameters
to the servlet, as additional QParam parameters in QCommand (executed using
QManagerSvc.executeCommand), or as additional NameValueParam parameters in
a derived class of QRequest using RequestService.processRequest. The servlet
will automatically create parameters out of these flags and set these in the command
before sending it for execution.
To handle these special flags, you can write your request handler derived from the
class QRequestHandler. You can then insert this new handler class anywhere in the
chain of responsibility pattern, starting with QDocProviderImpl and ending with
QHostRequestHandler.
Try not to change end points. In your handler implementation, handle your special
flags, then either return a response after handling or pass the control to the successor
for further handling.
172 | A GUIDE TO QUARKXPRESS SERVER 10.2.1
USING QUARKXPRESS SERVER