Programmatic Configuration

You can configure your User Code Namespaces and data structures programmatically. You can specify JAR, JARS IN ZIP, and CLASS resources in programmatic configuration.

You must create a Member.java file containing the required code and save it to your class configuration folder. The file will be similar to the following:

package com.hazelcast.namespace.staticconfig;
import com.hazelcast.config.Config;
import com.hazelcast.config.MapConfig;
import com.hazelcast.config.UserCodeNamespaceConfig;
import com.hazelcast.core.Hazelcast;
import com.hazelcast.core.HazelcastInstance;
import com.hazelcast.map.IMap;
import java.net.MalformedURLException;
import java.nio.file.Paths;
public class Member {
    public static void main(String[] args) {
        // Setup a Hazelcast member with namespace resources
        Config config = new Config(); (1)
        config.getNamespacesConfig().setEnabled(true); (2)
        UserCodeNamespaceConfig namespaceConfig = new UserCodeNamespaceConfig("namespace_name"); (3)
        namespaceConfig.addJarsInZip(Paths.get("/etc/path/to/all-my-jars.zip").toUri().toURL(), "my-resources-zip"); (4)
        config.getNamespacesConfig().addNamespaceConfig(namespaceConfig); (5)
        MapConfig mapConfig = new MapConfig("imap_name"); (6)
        mapConfig.setUserCodeNamespace("namespace_name"); (7)
        config.addMapConfig(mapConfig); (8)
        HazelcastInstance hz = Hazelcast.newHazelcastInstance(config); (9)

        // The HazelcastInstance is started, with our resources available to executions on our defined IMap...

        // Execute user code from clients on the Hazelcast member now that it has the required context
        hz.getMap("imap_name").executeOnEntries(new CustomEntryProcessor()); (10)
    }
}

1	Creates a new `Config` as the base for configuring our Hazelcast member
2	Enables User Code Namespaces in the `Config`
3	Creates a `UserCodeNamespaceConfig` with a name of `namespace_name`
4	Adds resources to the namespace, in this case JARS IN ZIP from a local URL
5	Adds the completed `UserCodeNamespaceConfig` to the parent `UserCodeNamespacesConfig` in `Config`
6	Creates a new `MapConfig` for the map named `imap_name`
7	Sets the namespace for the `imap_name` to `namespace_name`
8	Adds the newly created `MapConfig` to the parent `Config`
9	Starts a new Hazelcast member using our defined `Config`
10	Accesses the `imap_name` and runs the `CustomEntryProcessor` from a client, leveraging the User Code Namespaces to provide the member with the classpath context it needs for execution