openamf/docs config-overview.txt,NONE,1.1

Update of /cvsroot/openamf/openamf/docs
In directory sc8-pr-cvs1:/tmp/cvs-serv3239/docs

Added Files:
	config-overview.txt 
Log Message:
initial commit

--- NEW FILE: config-overview.txt ---
invoker
=================================
If you are using the "DefaultGateway" the invoker is selected 
by looping thru all the invokers in the order they are listed in the 
config file.  Then creating an instance of the class and calling 
the supports() method.  If supports returns true, the 
invoker is selected and invoked.  The response is then 
sent to the client.

If you are using the "AdvancedGateway", you get to select 
the Invoker your self using the "service/invoker-ref" element.

name
------
Used to name the invoker, this is the name you use in 
the "service/invoker-ref" element.

class
------
The class that provides an implementation of the invoker.  
This class must extend org.openamf.invoker.ServiceInvoker.

service
======================================
Only needed if you are using the AdvancedGateway.

This is how you can map the call coming from the client to 
some server side code. Using the "AdvancedGateway" the 
client can use simple names such as "Directory" and then you 
can map that call to a Java class named 
"org.openamf.test.Directory".  

Later on in development if you want to use a different class you 
only have to change the openamf-config file.  The client doesn't 
need to know about the change.  You could even switch from 
using a POJO to using a EJB, Web Service, MBean, or something 
else if you create a new invoker.  

name
-----
The name that the client will use when calling the service

service-location
---------------
The class name, jndi name, url, or JMX ObjectName that will be 
used to locate the service implementation.

invoker-ref
----------
The name of the Invoker to use.

method
-------
At least one method element is required.  If you want the client to be 
able to call any method on the service just set the name element to "*"

The method element has 3 sub-elements name, parameter, 
and state-bean-ref.

name
++++
The name of the method that the client uses and that is called on the 
service.  This can be a "*" to match all method name of the exact method 
name such as "addPerson".

parameter
+++++++
Used to specify the parameter of the method for matching purposes.  
Most of the time you will set the method/parameter/type element to "*" to 
indicate an parameters.  You could use the parameter element to restrict 
access to a method based on the parameters.

state-bean-ref
+++++++++++
The name of the state-bean that this method uses.  

state-bean
==========================
To use state-bean you must use the "AdvancedGateway".

State Beans are used to pass state between Service calls.  A state bean 
is just a simple Java Bean that is stored in the web container's Session 
or Application for you.  All you have to do to use state-beans is create 
a simple java bean, make it the last parameter of your method, and 
then configure the openamf-config.xml file.

pageable-recordset/initial-data-row-count
=================================
Used to set the number of rows to return by default.  With MM's remoting 
I think this is hard coded to 25.

custom-class-mapping
==================
With this new feature you can map a custom class to 
a java class in then openamf-config.xml file.  This way when 
you use Object.registerClass use can use a simple name
such as "Person" and then have it translated to a specific java 
class such as "org.openamf.test.Person".
 
This also works in reverse direction so you can when a java class
class is serialized it can be registered to a flash custom class and all 
the methods will be available.
 
java-class
------------
The name of the Java class to map to the Flash Custom Class. 

custom-class
--------------
The name of the Flash custom class




-------------------------------------------------------
This SF.Net email sponsored by: Free pre-built ASP.NET sites including
Data Reports, E-commerce, Portals, and Forums are available now.
Download today and enter to win an XBOX or Visual Studio .NET.
http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01