com.hazelcast.config

Class DistributedClassloadingConfig

java.lang.Object

com.hazelcast.config.DistributedClassloadingConfig

@Beta
public class DistributedClassloadingConfig
extends Object

Configuration of distributed classloading. When enabled it allows members to load classes from other members. This simplifies deployment as you do not have to deploy your domain classes into classpath of all cluster members.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DistributedClassloadingConfig.ClassCacheMode Controls caching of caches loaded from remote members
static class	DistributedClassloadingConfig.ProviderMode Controls how to react on receiving a classloading request from a remote member

Constructor Summary

Constructors

Constructor and Description
DistributedClassloadingConfig()

Method Summary

Modifier and Type	Method and Description
String	getBlacklistedPrefixes() Return currently configured blacklist prefixes.
DistributedClassloadingConfig.ClassCacheMode	getClassCacheMode() Return the current ClassCacheMode
String	getProviderFilter() Get current filter or {null} when no filter is defined.
DistributedClassloadingConfig.ProviderMode	getProviderMode() Return the current ProviderMode
String	getWhitelistedPrefixes() Return currently configured whitelist prefixes
boolean	isEnabled() Returns true when distributed classloading is enabled
DistributedClassloadingConfig	setBlacklistedPrefixes(String blacklistedPrefixes) Comma separated list of prefixes of classes which will never be loaded remotely.
DistributedClassloadingConfig	setClassCacheMode(DistributedClassloadingConfig.ClassCacheMode classCacheMode) Configure caching of classes loaded from remote members.
DistributedClassloadingConfig	setEnabled(boolean enabled) Enable or disable distributed classloading.
DistributedClassloadingConfig	setProviderFilter(String providerFilter) Filter to constraint members to be used for classloading request when a class is not available locally.
DistributedClassloadingConfig	setProviderMode(DistributedClassloadingConfig.ProviderMode providerMode) Configure behaviour when providing classes to remote members.
DistributedClassloadingConfig	setWhitelistedPrefixes(String whitelistedPrefixes) Comma separated list of prefixes of classes which will be loaded remotely.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DistributedClassloadingConfig

public DistributedClassloadingConfig()

Method Detail

setEnabled

public DistributedClassloadingConfig setEnabled(boolean enabled)

Enable or disable distributed classloading. Default: {false}

Parameters:

enabled -

Returns:

isEnabled

public boolean isEnabled()

Returns true when distributed classloading is enabled

Returns:

{true} when distributed classloading is enabled

setProviderFilter

public DistributedClassloadingConfig setProviderFilter(String providerFilter)

Filter to constraint members to be used for classloading request when a class is not available locally. Filter format: HAS_ATTRIBUTE:foo this will send classloading requests only to members which has a member attribute foo set. Value is ignored, it can be any type. A present of the attribute is sufficient. This facility allows to have a control on classloading. You can e.g. start Hazelcast lite members dedicated for class-serving. Example usage: This member will load classes only from members with the class-provider attribute set. It won't ask any other member to provide a locally unavailable class: Config hazelcastConfig = new Config(); DistributedClassloadingConfig distributedClassloadingConfig = hazelcastConfig.getDistributedClassloadingConfig(); distributedClassloadingConfig.setProviderFilter(HAS_ATTRIBUTE:class-provider); HazecastInstance instance = Hazelcast.newHazelcastInstance(hazelcastConfig); This member is marked with the class-provider attribute - the member configured above may him it to provide a class which is not locally available: Config hazelcastConfig = new Config(); MemberAttributeConfig memberAttributes = hazelcastConfig.getMemberAttributeConfig(); memberAttributes.setAttribute("class-provider", "true"); HazecastInstance instance = Hazelcast.newHazelcastInstance(hazelcastConfig); Setting the filter to null will allow to load classes from all members. Default: {null}

Parameters:

providerFilter -

Returns:

this instance of DistributedClassloadingConfig for easy method-chaining.

See Also:

com.hazelcast.core.Member#setStringAttribute(String, String)}

getProviderFilter

public String getProviderFilter()

Get current filter or {null} when no filter is defined.

Returns:

current filter or {null} when no filter is defined.

See Also:

setProviderFilter(String)

setBlacklistedPrefixes

public DistributedClassloadingConfig setBlacklistedPrefixes(String blacklistedPrefixes)

Comma separated list of prefixes of classes which will never be loaded remotely. A prefix can be a package name or a classname. For example setting a blacklist prefix to com.foo will disable remote loading of all classes from the com.foo package, but also classes from all sub-packages won't be loaded. Eg. com.foo.bar.MyClass will be black-listed too. When you set the blacklist to com.foo.Class then the Class will obviously be black-listed, but a class com.foo.ClassSuffix will be blacklisted too. Setting the prefixes to {null} will disable the blacklist Default: {null}

Parameters:

blacklistedPrefixes -

Returns:

this instance of DistributedClassloadingConfig for easy method-chaining.

getBlacklistedPrefixes

public String getBlacklistedPrefixes()

Return currently configured blacklist prefixes.

Returns:

currently configured blacklist prefixes

See Also:

setBlacklistedPrefixes(String)

setWhitelistedPrefixes

public DistributedClassloadingConfig setWhitelistedPrefixes(String whitelistedPrefixes)

Comma separated list of prefixes of classes which will be loaded remotely. Use this to enable distributed loading of selected classes only and disable remote loading for all other classes. This gives you a nice control over classloading. The prefixes are interpreted by using the same rules as desribed at {setBlacklistedPrefixes(String)} Setting the prefix to {null} will disable the white-list and all non-blacklisted classes will be allowed to load from remote members.

Parameters:

whitelistedPrefixes -

Returns:

this instance of DistributedClassloadingConfig for easy method-chaining.

getWhitelistedPrefixes

public String getWhitelistedPrefixes()

Return currently configured whitelist prefixes

Returns:

currently configured whitelist prefixes

setProviderMode

public DistributedClassloadingConfig setProviderMode(DistributedClassloadingConfig.ProviderMode providerMode)

Configure behaviour when providing classes to remote members. Default: DistributedClassloadingConfig.ProviderMode.LOCAL_AND_CACHED_CLASSES

Parameters:

providerMode -

Returns:

this instance of DistributedClassloadingConfig for easy method-chaining.

See Also:

ProviderMode}

getProviderMode

public DistributedClassloadingConfig.ProviderMode getProviderMode()

Return the current ProviderMode

Returns:

current ProviderMode

setClassCacheMode

public DistributedClassloadingConfig setClassCacheMode(DistributedClassloadingConfig.ClassCacheMode classCacheMode)

Configure caching of classes loaded from remote members. Default: DistributedClassloadingConfig.ClassCacheMode.ETERNAL

Parameters:

classCacheMode -

Returns:

this instance of DistributedClassloadingConfig for easy method-chaining.

See Also:

ClassCacheMode}

getClassCacheMode

public DistributedClassloadingConfig.ClassCacheMode getClassCacheMode()

Return the current ClassCacheMode

Returns:

current ProviderMode