~~NOTRANS~~
~~Title: Rename Server-Side Objects and Action Names~~

If you call an action or request a server-side object, you should know the name of the action or the object. Usually this isn't a big problem because it's your application and you know everything about it. But it's different if you use pre-defined application frames like ProjX.

The application frame has some prerequisites, e.g., the menu will be created after authentication. The application frame does the following call:

<file java>
AbstractConnection con = getConnection();

Object[] oResult = con.call(new String[] {"workScreenAccess", 
                                          "workScreenAccess", 
                                          "workScreenAccess"},
                            new String[] {"getAvailableWorkScreens", 
                                          "getAvailableRoles", 
                                          "getAvailableMetaData"});
</file>

This means that you have the following in your Session LCO:

<file java>
public IWorkScreenAccess getWorkScreenAccess() throws Exception
{
    IWorkScreenAccess wsac = (IWorkScreenAccess)get("workScreenAccess");

    if (wsac == null)
    {
        wsac = new DBWorkScreenAccess();
        ((DBWorkScreenAccess)wsac).setDBDataSource(getDBAccess());

        put("workScreenAccess", wsac);
    }

    return wsac;
}
</file>

The application frame won't work if the method name isn't getWorkScreenAccess. If you have a specific naming schema and won't use the same method name, you could do the following:

<file java>
@Replacement(name="workScreenAccess")
public IWorkScreenAccess getWSAccess() throws Exception
{
   ...
}
</file>

The Replacement annotation maps the custom method to the expected name. This annotation can be used for object and action names:

<file java>
@Replacement(name="sendCustomerEmail")
public void notifyCustomer() throws Exception
{
   ...
}
</file>

The Replacement will work for LCO names as well:

<code java>
@Replacement(name = "Public")
public class ExternalSession extends GenericBean 
{
}
</code>
The LCO can be used with the original name or the Replacement. Both names will work.