FluorineFx.NET

Service configuration files

Services configuration file

You can configure Remoting Service, Message Service and Data Management Service in the <services> section of the services configuration file (services-config.xml). The location of this file is the WEB-INF/flex directory of your ASP.NET web application.

Alternativelly the services-config.xml file can include files by reference that contain service definitions.

services-config.xml

This is the top-level configuration file. Contains security constraint definitions, channel definitions, inline service definitions or service definitions by reference.

remoting-config.xml

Defines Remoting Service destinations for working with remote objects.

messaging-config.xml

Defines Message Service destinations for performing publish subscribe messaging.

data-management-config.xml

Defines Data Management Service destinations.

FluorineFx uses the same service configuration system for both Flex and Flash remoting applications.
Create an application without using service configuration files

 

Sample service definitions included by reference:

  <services>
    <!-- Remoting Service -->
    <service-include file-path="remoting-config.xml"/>
    <!-- Message Service -->
    <service-include file-path="messaging-config.xml"/>
    <!-- Data Management Service -->
    <service-include file-path="data-management-config.xml"/>
  </services>
                

Supported XML elements:

XML element Description

services

Declared at the top level element of the configuration as a child of the root element, services-config

services/service-include

Includes files by reference that contain service definitions

services/service

Definition for a service (Remoting Service, Message Service, Data Management Service)

services/service/properties

Service-level properties

services/service/adapters

Definitions for service adapters that are referenced in destinations

services/service/adapters/adapter-definition

Service adapter definition

services/service/default-channels

References to a service's default channels (when a channel is not explicitly referenced in a destination)

services/service/default-channels/channel

References to the id of a channel definition

services/service/destination

Destination definition

services/service/destination/adapter

A reference to a service adapter

services/service/destination/properties

Destination properties

services/service/destination/channels

References to the channels that the service can use for data transport

services/service/destination/channels/channel

References to the id of a channel definition

services/service/destination/security

Complete security constraint definitions or references to security constraint definitions and login command definitions that are used for authentication and authorization

services/service/destination/security/security-constraint

References to the id value of a security constraint definition or contains a security constraint definition

services/service/destination/security/security-constraint/roles

Names of roles used for authorization

services/service/destination/security/login-command

References to the id value of a login command definition that is used for performing custom authentication.
Not supported

security

Security constraint definitions and login command definitions for authentication and authorization

security/security-constraint

Defines a security constraint

security/security-constraint/roles

Names of roles used for authorization

security/login-command

Defines a login command used for custom authentication

channels

Definitions of message channels used to transport data between the server and clients

channels/channel-definition

Defines a message channel to transport data

channels/channel-definition/endpoint

Specifies the endpoint URI and the endpoint class of the channel definition

channels/channel-definition/properties

Properties of a channel definition