This is an utility class to access data sources. This class can be used to get long or short values of domain keys or to retrieved a complete domain. Usually this class is not needed, as the domain handling is done by widget models (XMA Combo). See its javadoc for details: Domain

As shown above the property files can be defined language dependent. Then the data source retrieves the values from the file which matches the JVM language setting of the XMA client (as user.language=en). By default the JVM takes the language setting from the operation system (if it is not defined otherwise). Although the language setting of the XMA client is used (which is transferred to the XMA server), the actual resolving of the right property file is done at the XMA server, where the property files are existing. The java.util.ResourceBundle mechanism resolves property files this way (see the official Java API documentation for details):

at.spardat.myappl.server.domains.MyBundle.properties
at.spardat.myappl.server.domains.MyBundle_en.properties

First, ITableProvider requires you, of course, to provide the table data. You must implement the method provideTable , that must (among other things to be explained later) return either a TabularData or a TabularDomData object. To fill a TabularData -object, the following steps are required:

An example for an own ITableProvider implementation which reads country information from a data source, in this case the implementation is extended from RessourceBundleProviderServer:

 public class LOWTableProvider extends RessourceBundleProviderServer {

    /**
     * The names of the reserved columns
     */
    private static final String[] DOM_COLS =
        { "COD_KEY", "SHORT_VALUE", "LONG_VALUE", "VALID_FROM", "VALID_TO" };


    public ProviderResultServer provideTable(
        XMASession session,
        TableSpec spec,
        long lastModified) {

        String domName = getDomName(spec);

        ProviderResultServer result = null;

        if (domName.equals("country")) {
            result = provideMyTable(,spec, lastModified);
        }

        if (result == null) {
            throw new SysException("No domaine \"" + domName + "\" found.");
        }

        return result;
    }

    private ProviderResultServer provideMyTable(
        TableSpec spec,
        long lastModified) {

        try {
            //This method reads the actual DS (e.g. database)
            ArrayList countries = getCountryList();

            TabularData table = new TabularDomData();

            for (int i = 0; i < DOM_COLS.length; i++) {
                table.addColumn(DOM_COLS[i]);
            }

            for (int i = 0; i < countries.size(); i++) {

                Land land = (Land) countries.get(i);

                TabularDataRow row = new TabularDataRow(table);
                row.add(new Atom(land.iso()));
                row.add(new Atom(land.kurz()));
                row.add(new Atom(land.name()));
                row.add(Atom.EMPTY_DATE);
                row.add(Atom.EMPTY_DATE);

                try {
                    table.addRow(row);
                }
                catch (IllegalArgumentException e) {

                }
            }

            ProviderResultServer result = new ProviderResultServer();
            result.table_ = table;
            return result;

        }
        catch (Exception e) {
            throw new SysException(
                e,  "Domain cannot be read.");
        }
    }

    private String getDomName(TableSpec spec) {

        String domName = spec.getProperty("name");
        if (domName == null || domName.length() == 0) {
            throw new SysException("Domain name not specified.");
        }

        return domName;
    }
}

The ITableProvider implementor is requested to provide three parameters that control how long tables may stay in client and server caches and therefore how outdated a particular table might be in terms of the client application requesting a table: