Configure a Web service

Create a configuration file with the details the Genero Application Server needs to deliver the Web service to client applications.

The configuration file for a Web services is very similar to that used for applications.

For the purposes of this quick start, you can create a custom configuration file for the Calculator web service located in your $FGLASDIR/demo/WebServices/calculator/ directory.

  1. Create a new directory (for example, you can name it "calculator_config") on your disk where you will store the Calculator web service source files.
  2. Copy all the files from $FGLASDIR/demo/WebServices/calculator/server to your new local directory.
  3. Create a minimal configuration file for your Calculator Web service. Provide a path to the location of your compiled application files in the PATH element, and in the MODULE element specify the module required to launch your Web service.
    Use a text editor or if you are using Studio, go to File >> New >> Web/AS >> Application Configuration (.xcf).
    Note: The Parent attribute reference to ws.default provides default configuration for all applications of the Web service type (see GAS configuration file (as.xcf)).
    <?xml version="1.0" encoding="UTF-8" ?>
    <APPLICATION Parent="ws.default" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/3.10/cfextws.xsd">
     <EXECUTION>
       <PATH><path_to_your_local_directory></PATH>
       <MODULE>CalculatorServer.42r</MODULE>
     </EXECUTION>
    </APPLICATION>
  4. Save your Web service configuration file, e.g. "mycalculator.xcf", in the directory specified in the $(res.path.services) resource.
    The default services directory is set by the res.path.services resource in the GAS configuration file:
    <RESOURCE Id="res.path.services" Source="INTERNAL">$(res.appdata.path)/services</RESOURCE>